# 已发布文档的 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 工具

{% 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 是否在页面操作菜单中显示 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 客户端（无需手动设置客户端 ID）
3. 将你重定向到你站点的上游身份验证提供商进行登录
4. 将授权码兑换为访问令牌，并将其本地存储以供后续所有请求使用

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

**要求**

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

* Auth0、Azure AD、Okta、AWS Cognito，或通过原生集成的 OIDC
* 配置了回退 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.