# 已发布文档的 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 请求的工具，例如 LLM 或 IDE。
{% endhint %}

### 连接 AI 助手

{% stepper %}
{% step %}

#### 找到你的 MCP 服务器 URL

将你已发布的 GitBook 站点 URL 添加上 `/~gitbook/mcp` 到末尾。
{% endstep %}

{% step %}

#### 配置你的 AI 工具

将 MCP 服务器 URL 添加到你的 AI 助手设置中。每个工具的设置过程略有不同，因此你应查看你所选工具的文档，了解如何为其配置 MCP 服务器。
{% endstep %}

{% step %}

#### 开始使用你的文档

连接后，你的 AI 助手可以搜索你的文档，检索特定页面，并使用你的内容回答问题。该助手将能够实时访问你已发布的文档。
{% endstep %}
{% endstepper %}

### 要求

你的 GitBook 站点必须已发布，MCP 服务器才能工作。该服务器只提供对已发布内容的访问，不会提供草稿或未发布的更改。

你的 AI 工具需要支持模型上下文协议，并且能够向你的站点发出 HTTP 请求。大多数支持 MCP 的现代 AI 助手都可以与 GitBook 的服务器配合使用。

MCP 服务器会遵守你站点的可见性设置。如果你的网站是公开的，MCP 服务器也将可公开访问。如果你的网站需要身份验证，MCP 服务器也同样如此。

MCP 服务器仅使用 HTTP 传输。不支持需要 stdio 或 SSE 传输的工具。

### 启用或禁用便捷的 MCP 链接

在 **页面操作** 部分中的 [自定义](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/publishing-documentation/customization) 设置里，你可以启用 **使用 MCP 服务器连接** 选项。这使你文档站点的访客可以快速复制你站点 MCP 服务器的链接，直接从 [页面操作菜单](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/customization/extra-configuration#page-actions).

### 隐私和访问

MCP 服务器只为你已发布的文档提供只读访问。它不会暴露任何用户数据、分析数据或 GitBook 内部信息。

只有你内容的最新已发布版本可通过 MCP 服务器访问。草稿内容和未发布的更改会保持私密，直到你发布它们。

### 常见问题

如果你的 AI 助手无法连接到你的 MCP 服务器，请先检查你的 GitBook 站点是否已发布且可访问。你在浏览器中访问该 URL 时应能得到响应。

请确保你使用的是正确的 URL 格式，并在末尾添加 `/~gitbook/mcp` 。该 URL 应与你访问已发布站点时看到的内容完全一致。

某些 AI 工具需要特定的传输方式，或具有特定的 MCP 配置要求。请查看你的 AI 工具文档，了解 MCP 的设置说明。