# 已发布文档的 MCP 服务器

每个已发布的 GitBook 站点会自动包含一个模型上下文协议（MCP）服务器。&#x20;

这允许 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 请求的工具，例如大型语言模型或 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/fa-bu-wen-dang/customization) 设置中，你可以启用 **通过 MCP 服务器连接** 选项。此选项使访问你文档站点的访客能够直接从 [页面操作菜单](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/customization/extra-configuration#page-actions).

### 快速复制你站点的 MCP 服务器链接。

隐私与访问

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

### 仅最新已发布版本的内容可通过 MCP 服务器访问。草稿内容和未发布的更改在你发布之前仍保持私有。

常见问题

如果你的 AI 助手无法连接到你的 MCP 服务器，首先检查你的 GitBook 站点是否已发布且可访问。访问该 URL 时，浏览器应有响应。 `/~gitbook/mcp` 确保你使用的 URL 格式正确，并在末尾包含

某些 AI 工具需要特定的传输方法或具有特定的 MCP 配置要求。请查看你 AI 工具的文档以获取 MCP 设置说明。
