Skip to content

feat(kno-14977): document service token auth for the MCP server - #1653

Merged
cjbell merged 1 commit into
mainfrom
cjbell-kno-14977-mcp-support-service-token-based-authentication-for-the-mcp
Aug 31, 2026
Merged

feat(kno-14977): document service token auth for the MCP server#1653
cjbell merged 1 commit into
mainfrom
cjbell-kno-14977-mcp-support-service-token-based-authentication-for-the-mcp

Conversation

@cjbell

@cjbell cjbell commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Description

Documents service token authentication for the remote MCP server, matching the support added in knocklabs/knock-mcp#14.

Interactive clients still use OAuth. CI and other headless clients can pass a Management API service token (knock_st_…) as a bearer credential. The docs cover:

  • A dedicated Authenticate with a service token section on the MCP server page, including client config, token passthrough, and that service-token sessions skip consent and enable all capabilities
  • FAQ updates so we no longer tell people to contact us for this
  • Cross-links from the service tokens page and the Knock agent FAQ

Tasks

Screenshots

Authenticate with a service token section

Service tokens FAQ for MCP

mcp_service_token_docs_walkthrough.mp4

Open in Web Open in Cursor 

Document bearer service token authentication for the remote MCP server
so CI and other headless clients can connect without OAuth.

Co-authored-by: Chris Bell <chris@cjbell.co>
@linear-code

linear-code Bot commented Aug 31, 2026

Copy link
Copy Markdown

KNO-14977

@vercel

vercel Bot commented Aug 31, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Aug 31, 2026 6:49pm

Request Review

@cjbell
cjbell marked this pull request as ready for review August 31, 2026 19:01

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Risk MEDIUM: Documents service token authentication for the remote MCP server across three existing MDX pages.

Reasons

  • Changes span two documentation sections (content/ai/ and content/developer-tools/).
  • Adds a substantial new section on the MCP server page (~35 lines of new content).
  • Updates cross-links and FAQs on related pages for consistency.
  • No code, layout, sidebar, or build configuration changes.
  • Author cjbell is a known team member.

Notes

  • Verify the service token auth flow and mcp.json example match the implementation in knocklabs/knock-mcp#14.
  • Confirm cross-links resolve correctly (/ai/mcp-server#authenticate-with-a-service-token, /developer-tools/service-tokens).
  • Review security guidance (treat token as secret, OAuth vs service token tradeoffs) for accuracy.
  • Check that updated FAQ answers no longer contradict the new service token support.

Automated risk classification — approval withheld (MEDIUM risk; approval requires LOW).

Open in Web View Automation 

Sent by Cursor Automation: Docs PR classifier

cjbell commented Aug 31, 2026

Copy link
Copy Markdown
Contributor Author

Merge activity

  • Aug 31, 10:51 PM UTC: A user started a stack merge that includes this pull request via Graphite.
  • Aug 31, 10:52 PM UTC: @cjbell merged this pull request with Graphite.

@cjbell
cjbell merged commit 338041c into main Aug 31, 2026
5 checks passed
@cjbell
cjbell deleted the cjbell-kno-14977-mcp-support-service-token-based-authentication-for-the-mcp branch August 31, 2026 22:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants