Skip to content

Add client_credentials grant type docs for MCP auth#5220

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

Add client_credentials grant type docs for MCP auth#5220
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/mcp-client-credentials-1775691598

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify bot commented Apr 8, 2026

Summary

  • Documents the new OAuth 2.0 client_credentials grant type for authenticated MCP servers, enabling machine-to-machine authentication for server-side applications, CI/CD pipelines, and automated tools
  • Adds code examples showing both request body and Authorization Basic header credential formats
  • Notes token expiration (14 days), scope (mcp:search), and server-side revocation behavior

Shipped in mintlify/mint#6908: MCP auth now supports client_credentials grant alongside the existing Authorization Code flow, with server-side revocation checks for issued tokens.


Note

Low Risk
Low risk because this PR only updates documentation and does not change runtime behavior or security logic.

Overview
Documents OAuth 2.0 machine-to-machine authentication for authenticated MCP servers via the client_credentials grant.

Adds curl examples for requesting tokens from /authed/mcp/oauth/token using either form-encoded body credentials or an Authorization: Basic header, and clarifies issued token scope (mcp:search), 14-day expiration, and revocation behavior.

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

@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, 11:43 PM

@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, 11:41 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