# 已发布文档的 MCP 服务器

每个已发布的 GitBook 站点都包含一个模型上下文协议（MCP）服务器。

AI 工具可以使用它直接读取你已发布的文档。这适用于 Claude Desktop、Cursor 和 VS Code 扩展等工具。

你的 MCP 服务器位于你已发布站点的 URL 后面，再加上 `/~gitbook/mcp`.

例如，GitBook 的文档位于 `https://gitbook.com/docs`。它的 MCP 服务器是 `https://gitbook.com/docs/~gitbook/mcp`.

{% hint style="info" %}
如果你在浏览器中打开这个 URL，你会看到错误。请在能够发出 HTTP 请求的工具中使用它，例如 AI 助手或 IDE。
{% endhint %}

### 连接 AI 工具

{% hint style="info" %}
**页面操作** 必须启用，MCP 服务器才能工作。如果你关闭 **站点自定义** → **页面操作**，GitBook 会禁用 `~gitbook/mcp` ，并且该端点返回 `404`. **连接 MCP 服务器** 仅控制 MCP 链接是否出现在页面操作菜单中。
{% endhint %}

{% stepper %}
{% step %}
**查找你的 MCP 服务器 URL**

取你已发布的 GitBook 站点 URL。然后添加 `/~gitbook/mcp`.
{% endstep %}

{% step %}
**配置你的 AI 工具**

打开工具的 MCP 设置。然后输入服务器 URL。

每个工具的设置方式不同。请查看你工具的文档以获取准确步骤。
{% endstep %}

{% step %}
**开始使用你的文档**

连接后，该工具可以搜索你的文档、打开页面，并基于你的内容回答问题。
{% endstep %}
{% endstepper %}

### 要求

要使用 MCP 服务器：

* 你的站点必须已发布。MCP 服务器只暴露已发布的内容。
* **页面操作** 必须在 **站点自定义** → **页面操作**.
* 你的工具必须支持通过 HTTP 的 MCP。
* 如果你的站点使用了身份验证访问，MCP 服务器会使用相同的访问规则。
* 如果你的站点使用共享链接，请使用共享链接站点 URL，然后添加 `/~gitbook/mcp`.
* GitBook 仅支持 HTTP 传输。 `stdio` 和 `SSE` 不受支持。

### 将 MCP 链接添加到你的站点

在 [站点自定义](/docs/documentation/zh/docs-site/customization.md)中，打开 [页面操作](/docs/documentation/zh/docs-site/customization/extra-configuration.md#page-actions)。确保 **页面操作** 已开启。然后开启 **连接 MCP 服务器**.

如果 **页面操作** 处于关闭状态，GitBook 会禁用 `~gitbook/mcp` ，并且该端点返回 `404`.

**连接 MCP 服务器** 仅控制 GitBook 是否在页面操作菜单中显示 MCP 服务器链接。

随后访问者可以从页面操作菜单中复制服务器 URL。

### 隐私和访问

MCP 服务器为你已发布的文档提供只读访问。

隐藏页面仍可通过 MCP 访问。隐藏页面只会将其从已发布的目录中移除。

它绝不会暴露账户数据、分析数据或 GitBook 内部数据。

它只提供最新已发布版本。草稿和未发布的更改会保持私密。

### 故障排除

如果某个工具无法连接：

* 确认你已发布的站点可访问。
* 确认 URL 以 `/~gitbook/mcp`.
* 如果站点使用身份验证，请使用支持 MCP 授权的客户端。
* 如果该工具需要 `stdio` 或 `SSE`，它将无法与 GitBook 配合使用。

### 在已认证站点上使用 MCP

如果你的 GitBook 站点使用 [已认证访问](/docs/documentation/zh/zhan-dian-fang-wen/authenticated-access.md)，位于 `/~gitbook/mcp` 的 MCP 服务器会使用相同的身份验证。支持 [MCP 授权规范](https://modelcontextprotocol.io/docs/tutorials/security/authorization) 的 MCP 客户端——包括 Claude 和 Claude Code——可以使用 OAuth 和动态客户端注册（DCR）自动连接到服务器。

如果你的站点改用共享链接，MCP 仍然有效。请使用完整的共享链接站点 URL，然后添加 `/~gitbook/mcp`.

**工作原理**

当受支持的 MCP 客户端连接到你已认证站点的 MCP 服务器时，它会：

1. 通过 MCP 握手发现 OAuth 服务器
2. 动态注册一个 OAuth 客户端（无需手动设置 client ID）
3. 将你重定向到站点的上游身份验证提供方进行登录
4. 将授权码兑换为访问令牌，并将其本地存储以供后续所有请求使用

GitBook 会在你首次连接时提示你进行身份验证。之后，客户端会重复使用该令牌，直到它过期。

**要求**

要使此流程正常工作，你的站点必须使用 GitBook 支持的以下身份验证后端之一：

* Auth0、Azure AD、Okta、AWS Cognito，或通过原生集成的 OIDC
* 配置了 Fallback URL 的自定义后端

GitBook 不支持使用作为静态请求头传递的访客身份验证令牌进行 MCP 身份验证的站点。


---

# Agent Instructions: 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.com/docs/documentation/zh/ai-yu-sou-suo/mcp-servers-for-published-docs.md?ask=<question>
```

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.