diff --git a/ai/model-context-protocol.mdx b/ai/model-context-protocol.mdx index 589877571..5b823ef61 100644 --- a/ai/model-context-protocol.mdx +++ b/ai/model-context-protocol.mdx @@ -33,6 +33,17 @@ The MCP search tool supports optional filtering parameters that AI applications AI applications determine when to apply these filters based on the context of the user's query. For example, if a user asks about a specific API version, the AI application may automatically apply the appropriate filter to provide more relevant results. +### MCP with authenticated users + +When your documentation uses [partial authentication](/deploy/authentication-setup#make-pages-public) with [user groups](/deploy/authentication-setup#control-access-with-groups), authenticated users can search content restricted to their groups through your MCP server. Unauthenticated users only see public content in search results. + +When an authenticated user searches through MCP: +- The MCP server filters results based on the user's groups. +- Results include pages available to all authenticated users and pages restricted to the user's specific groups. +- Users cannot see content from groups they don't belong to. + +To authenticate MCP requests, users must include a bearer token in their MCP client configuration. The token is validated against your authentication system and the user's groups are extracted from their session. + ### MCP compared to web search AI tools can search the web, but MCP provides distinct advantages for documentation. @@ -44,7 +55,7 @@ AI tools can search the web, but MCP provides distinct advantages for documentat ## Access your MCP server - MCP servers are available for public documentation and documentation using [partial authentication](/deploy/authentication-setup#make-pages-public). Your MCP server only searches public pages. Documentation that requires authentication for all pages cannot generate an MCP server. + MCP servers are available for public documentation and documentation using [partial authentication](/deploy/authentication-setup#make-pages-public). For unauthenticated users, your MCP server only searches public pages. Documentation that requires authentication for all pages cannot generate an MCP server. Mintlify automatically generates an MCP server for your documentation and hosts it at your documentation URL with the `/mcp` path. For example, Mintlify's MCP server is available at `https://mintlify.com/docs/mcp`. diff --git a/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx index b12e657cb..5054e2d8d 100644 --- a/deploy/authentication-setup.mdx +++ b/deploy/authentication-setup.mdx @@ -451,7 +451,7 @@ Some features behave differently or are unavailable when you enable authenticati | Feature | Public | Fully authenticated (all pages protected) | Partially authenticated (some public pages) | | :------ | :---------- | :---------------------------------- | :-------------------------------- | | [llms.txt and llms-full.txt](/ai/llmstxt) | Full support | Available behind authentication, so AI tools may not be able to access the files | Available behind authentication, so AI tools may not be able to access the files | -| [MCP server](/ai/model-context-protocol) | Full support | Not available | Available for public pages only | +| [MCP server](/ai/model-context-protocol) | Full support | Not available | Available for public pages (unauthenticated) or respects user groups (authenticated) | | [Markdown export](/ai/markdown-export) | Full support | Full support, respects user groups | Full support, respects user groups | | [PDF export](/optimize/pdf-exports) | Full support | Not supported | Not supported | | [Search](/ai/assistant) | Full support | Full support, respects user groups | Full support, respects user groups |