Skip to content

Add client credentials docs for MCP servers#5216

Open
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/mcp-client-credentials-1775686832
Open

Add client credentials docs for MCP servers#5216
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/mcp-client-credentials-1775686832

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify bot commented Apr 8, 2026

Summary

  • Documents the new client credentials authentication method for MCP servers, which enables machine-to-machine access without an interactive OAuth login flow
  • Adds a step-by-step guide covering credential creation in the dashboard, token exchange via the API, and using tokens with authenticated MCP endpoints
  • Includes credential management guidance (disabling and deleting credentials)

What shipped

Server-side support for OAuth 2.0 client credentials grant on MCP servers. Admins can now create client credentials from the dashboard and use them to obtain access tokens for authenticated MCP endpoints programmatically, without requiring a user login flow.


Note

Low Risk
Low risk documentation-only change that doesn’t alter runtime behavior, but could cause confusion if the token endpoint/expiry details are inaccurate.

Overview
Adds a new Client credentials section to ai/model-context-protocol.mdx describing machine-to-machine authentication for /authed/mcp.

Provides step-by-step instructions to create credentials in the dashboard, exchange them via POST /authed/mcp/oauth/token (with a curl example), and use the resulting Bearer token, plus guidance on disabling/deleting credentials and token expiry.

Reviewed by Cursor Bugbot for commit 2579079. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify-development
Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
userauth 🟡 Building Apr 8, 2026, 10:21 PM

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify bot commented Apr 8, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Apr 8, 2026, 10:24 PM

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.

0 participants