> For the complete documentation index, see [llms.txt](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/ai-and-search/mcp-servers-for-published-docs.md). # MCP servers for published docs Every published GitBook site automatically includes a Model Context Protocol (MCP) server. AI tools can use it to read your published docs directly. This works with tools like Claude Desktop, Cursor, and VS Code extensions. Your MCP server lives at your published site URL plus `/~gitbook/mcp`. For example, GitBook’s docs live at `https://gitbook.com/docs`. Its MCP server is `https://gitbook.com/docs/~gitbook/mcp`. Use this endpoint for public sites, share-link sites where all published content is exposed, and fully authenticated sites. For fully authenticated sites, MCP clients authenticate through the MCP discovery and OAuth flow before they can access tools. For more detail, see the [MCP authorization flow](https://modelcontextprotocol.io/docs/tutorials/security/authorization#the-authorization-flow-step-by-step). If your site is partially authenticated and still exposes public or share-link content, use `/~gitbook/mcp/auth` instead. For example, `https://gitbook.com/docs/~gitbook/mcp/auth`. {% hint style="info" %} If you open this URL in a browser, you’ll see an error. Use it in a tool that can make HTTP requests, such as an AI assistant or IDE. {% endhint %} ### Connect an AI tool {% stepper %} {% step %} #### Find your MCP server URL Take your published GitBook site URL and add the endpoint that matches your site: * Use `/~gitbook/mcp` for public sites, share-link sites where all published content is exposed, or fully authenticated sites that use MCP discovery and OAuth. * Use `/~gitbook/mcp/auth` if your site is partially authenticated and still exposes public or share-link content. {% endstep %} {% step %} #### Configure your AI tool Add the MCP server URL to your AI assistant’s settings. Each tool has a slightly different setup process, so you should check out the docs for your tool of choice to see how to configure an MCP server for it. {% endstep %} {% step %} #### Start using your docs Once connected, your AI assistant can search through your documentation, retrieve specific pages, and answer questions using your content. The assistant will have real-time access to your published documentation. {% endstep %} {% endstepper %} {% hint style="info" %} **Page actions** must be enabled for the MCP server to work. If you turn off **Site customization** → **Page actions**, GitBook disables `~gitbook/mcp` and the endpoint returns `404`. **Connect with MCP server** only controls whether the MCP link appears in the page actions menu. {% endhint %} {% stepper %} {% step %} **Find your MCP server URL** Take your published GitBook site URL. Then add `/~gitbook/mcp`. {% endstep %} {% step %} **Configure your AI tool** Open your tool’s MCP settings. Then enter the server URL. Each tool handles setup differently. Check your tool’s docs for exact steps. {% endstep %} {% step %} **Start using your docs** Once connected, the tool can search your docs, open pages, and answer questions with your content. {% endstep %} {% endstepper %} ### Requirements The MCP server respects your site’s visibility settings. Use `/~gitbook/mcp` for public sites, share-link sites where all published content is exposed, or fully authenticated sites that use MCP discovery and OAuth. Use `/~gitbook/mcp/auth` if your site is partially authenticated and still exposes public or share-link content. In the **Page actions** section of your [Customization](/url/gitbook.com/docs/docs-site/customization.md) settings, you can enable the **Connect with MCP server** option. This enables visitors to your docs site to quickly copy a link to your site's MCP server right from [the Page actions menu](/url/gitbook.com/docs/docs-site/customization/extra-configuration.md#page-actions). To use an MCP server: * Your site must be published. The MCP server exposes published content only. * **Page actions** must be enabled in **Site customization** → **Page actions**. * Your tool must support MCP over HTTP. * If your site uses authenticated access, the MCP server uses the same access rules. * If your site uses share links, use the share-link site URL, then add `/~gitbook/mcp`. * GitBook supports HTTP transport only. `stdio` and `SSE` aren’t supported. ### Add the MCP link to your site In [Site customization](/url/gitbook.com/docs/docs-site/customization.md), open [Page actions](/url/gitbook.com/docs/docs-site/customization/extra-configuration.md#page-actions). Make sure **Page actions** is turned on. Then turn on **Connect with MCP server**. If **Page actions** is off, GitBook disables `~gitbook/mcp` and the endpoint returns `404`. **Connect with MCP server** only controls whether GitBook shows the MCP server link in the page actions menu. Visitors can then copy the server URL from the page actions menu. ### Privacy and access Make sure you’re using the correct URL format. Use `/~gitbook/mcp` for public sites, share-link sites where all published content is exposed, or fully authenticated sites that use MCP discovery and OAuth. Use `/~gitbook/mcp/auth` for partially authenticated sites with public or share-link content. The MCP server gives read-only access to your published docs. Hidden pages remain available through MCP. Hiding a page only removes it from the published table of contents. It never exposes account data, analytics, or internal GitBook data. It serves the latest published version only. Drafts and unpublished changes stay private. ### Troubleshooting If a tool can’t connect: * Confirm your published site is reachable. * Confirm the URL ends with `/~gitbook/mcp`. * If the site uses authentication, use a client that supports the [MCP authorization spec](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization). * If the tool needs `stdio` or `SSE`, it won’t work with GitBook. ### Use MCP with authenticated sites If your GitBook site uses [authenticated access](/url/gitbook.com/docs/site-access/authenticated-access.md), the MCP server at `/~gitbook/mcp` uses the same authentication. MCP clients that support the [MCP authorization spec](https://modelcontextprotocol.io/docs/tutorials/security/authorization) — including Claude and Claude Code — can connect to the server automatically using OAuth and Dynamic Client Registration (DCR). If your site uses share links instead, MCP still works. Use the full share-link site URL, then add `/~gitbook/mcp`. GitBook doesn't support share-link-only sites or sites using visitor auth tokens passed as static headers for MCP authentication. If your site uses [authenticated access](/url/gitbook.com/docs/site-access/authenticated-access.md), the MCP server uses the same access rules. Public sites stay public. Protected sites require the same sign-in. Supported MCP clients — including Claude — follow the [MCP authorization spec](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization) to connect. {% stepper %} {% step %} #### Discover the OAuth server During the MCP handshake, the client discovers your site's OAuth server. {% endstep %} {% step %} #### Register a client with DCR The client registers an OAuth client with Dynamic Client Registration. You don’t need to create a client ID manually. {% endstep %} {% step %} #### Sign in with your site auth provider The client redirects you to your site's auth provider. You sign in with the same provider your docs site already uses. {% endstep %} {% step %} #### Exchange the code for a token After sign-in, the client exchanges the authorization code for an access token. {% endstep %} {% step %} #### Reuse the token The client sends that token with later MCP requests until it expires. {% endstep %} {% endstepper %} This flow works with these authenticated access backends: * [Auth0](/url/gitbook.com/docs/site-access/authenticated-access/setting-up-auth0.md) * [Azure AD](/url/gitbook.com/docs/site-access/authenticated-access/setting-up-azure-ad.md) * [Okta](/url/gitbook.com/docs/site-access/authenticated-access/setting-up-okta.md) * [AWS Cognito](/url/gitbook.com/docs/site-access/authenticated-access/setting-up-aws-cognito.md) * [OIDC](/url/gitbook.com/docs/site-access/authenticated-access/setting-up-oidc.md) * [Custom backend](/url/gitbook.com/docs/site-access/authenticated-access/setting-up-a-custom-backend.md) with a configured Fallback URL {% hint style="warning" %} MCP authentication doesn’t support sites that rely only on static visitor auth tokens in request headers. Use one of the authenticated access backends above instead. {% endhint %} To set this up, start with [Authenticated access](/url/gitbook.com/docs/site-access/authenticated-access.md) and [Enabling authenticated access](/url/gitbook.com/docs/site-access/authenticated-access/enabling-authenticated-access.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/ai-and-search/mcp-servers-for-published-docs.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.