用于文档的 MCP 服务器：它是什么，以及为何具有优势

模型上下文协议（MCP）是 Anthropic 于 2024 年末发布的连接器标准。截至 2026 年年中，Claude Code、Cursor、ChatGPT 以及越来越多的智能体都已支持该协议。对于文档而言，MCP 将你的文档从仅限网站使用的资源转变为 AI 智能体可以读取并执行操作的程序化界面。

本文将介绍 MCP 是什么、文档 MCP 服务器提供哪些工具，以及 Docsbook 如何提供此类服务器。

简要总结#

MCP = AI 代理调用外部工具的标准方式
文档 MCP 服务器提供 get_analytics、update_branding、set_chat_hooks 等工具
代理发现功能、请求 OAuth，然后在工作过程中调用工具
Docsbook 在 docsbook.io/api/mcp/server 提供托管的 MCP 服务器
如今这已成为主要的 AI 分发渠道——Mintlify 测得，在 2026 年 3 月，AI 编码代理占其托管文档网站请求的 45.3%，其中 Claude Code 占 25.2%，Cursor 占 18.0%（来源）

MCP 实际是什么#

MCP 是一种构建在 HTTP（或 stdio）之上的 JSON-RPC 协议。代理连接到 MCP 服务器，询问“你有哪些工具？”，接收类型化架构，然后调用工具。身份验证采用带 PKCE 的 OAuth 2.0。

最简单的理解方式是：REST API + OAuth + 一个发现端点 + 工具，而不是资源。

文档为何受益于 MCP#

三种工作流：

1. 将文档读取为结构化数据#

没有 MCP 时，代理会获取 HTML 页面、解析页面，并希望其结构保持完整。借助在本地运行的 markdown-lsp（npx markdown-lsp <subcommand> ./docs），代理可以解析磁盘上的文档图，并接收干净的 Markdown 或 JSON，而无需经过网络往返。

这意味着代理可以：

在阅读前了解完整的目录
阅读单个章节，而不是完整页面
将交叉链接视为图边，而不是正则表达式匹配结果
获取版本稳定的元数据

2. 从代理编辑文档配置#

Claude Code 中的用户可以说：“将我的文档强调色设置为品牌紫色，并在页脚添加一个 Discord 链接。”代理会在 MCP 服务器上调用 update_branding 和 update_navigation。无需切换仪表板、复制粘贴或编辑 Markdown。

3. 在智能体内部查询文档分析#

“上周哪些页面的搜索失败次数最多？”——智能体调用 get_failed_searches，查看列表，并当场提出起草缺失内容。

优秀的文档 MCP 服务器提供哪些工具#

Docsbook 的 MCP 服务器提供以下类别的工具。完整列表会在连接时由服务器本身返回——下表展示的是结构，而不是完整清单：

类别	示例
工作区	`list_workspaces`, `get_workspace`, `create_workspace`
内容和文档	`search_docs`, `get_doc_outline`, `write_docs`
品牌	`update_branding`, `update_ui_settings`, `update_navigation`
AI 设置	`update_ai_settings`, `set_chat_system_prompt`, `set_chat_hooks`
SEO 和域名	`update_seo`, `update_domain`
翻译	`update_languages`, `set_translation_mode`, `approve_translation`
分析	`get_analytics`, `get_ai_questions`, `get_failed_searches`, `get_negative_feedback`, `get_top_visitors`, `get_visitor_activity`
Webhook	`register_webhook_*`, `list_webhook_deliveries`, `test_webhook`
技能	`find_skill`（查询 docs-skills 目录）

从 Claude Code 连接#

mcp add --transport http https://docsbook.io/api/mcp/server

OAuth 流程会在浏览器中打开，完成授权后，工具就会出现在 Claude Code 中。无需管理 API 密钥，也无需编辑配置文件。

Cursor 使用相同的 MCP 服务器，用户体验也类似。ChatGPT 和 Gemini 将在 2026 年期间陆续添加 HTTP MCP 支持。

LSP 风格工具是被低估的一半（本地插件，而非托管 MCP）#

大多数文档 MCP 的宣传重点都放在读写上——以 Docsbook 为例，search_docs 用于查找可引用的章节，get_doc_outline 用于在搜索或写入之前查看每个页面的标题、标题数量和大小，而 write_docs 用于提交更改（受 OAuth 同意机制控制：客户在授权连接时选择只读或读写范围）。对代理而言，更大的价值在于 LSP 风格的搜索和导航界面——但对于一个实际运行的代码仓库来说，这个界面最好以本地 Claude Code 插件的形式提供，而不是作为托管 MCP 工具。磁盘本地解析速度更快、成本更低，而且不要求文档已经发布。

Docsbook 通过 markdown-lsp 提供这一功能——在本地运行它，代理即可获得：

doc_outline — 页面的大纲层级（不包含正文）
doc_search_symbols — 对所有标题执行模糊子序列搜索（“oaf” → “OAuth 流程”）
doc_search_text — 带有代码片段以及精确行号/列号的全文搜索
doc_search_links_to — 传入引用（LSP references）
doc_resolve_link — 相对链接或 wiki 链接 → 带锚点的绝对 GitHub URL
doc_definition — page#anchor → 精确的源代码位置

LSP（语言服务器协议）为 VS Code 中的转到定义、查找引用和符号搜索提供支持。该插件将同一模型应用于本地文档树，使代理能够以类似 IDE 的精度进行导航。托管 MCP 服务器则专注于工作区操作（品牌、分析、Webhook、翻译），因为云端才真正拥有这些数据。

为什么这是真正的分发渠道#

来自 2025–2026 年的三个信号：

Mintlify 遥测数据。 Mintlify 对其托管的文档网站进行了为期 30 天的流量测量——约 7.9 亿次请求——并报告称，AI 编程代理占全部请求的 45.3%，其中 Claude Code 占 25.2%，Cursor 占 18.0%（文档中的代理流量现状，发布于 2026 年 4 月 3 日）。其后续测量显示，2026 年 7 月代理流量占比达到总流量的 66%（2026 年年中报告，发布于 2026 年 7 月 29 日）。这反映的是一家供应商的系统，而非整个 Web，但这是目前已发布的关于代理访问文档流量的最大规模测量。
Anthropic 的内部实践。 Anthropic 自己的文档以及 Claude Code 文档都以 MCP 为优先。
客户端已经构建完成。 Claude Code、Cursor 和 ChatGPT 都已提供 MCP 支持，因此连接器无需在读者一侧推动采用——只需在你这一侧完成接入。

如果你面向开发者构建产品，并且你的受众使用 Claude Code 或 Cursor，那么 MCP 已不再是可选基础设施。

自行构建的成本#

一个合理的文档 MCP 服务器需要：

HTTP 传输 + JSON-RPC 帧处理
OAuth 2.0 授权码 + PKCE 流程
带类型架构的工具定义
用于读取工具的文档图解析——通常作为本地 CLI 工具提供，例如 markdown-lsp，而不是托管端点，因为本地磁盘解析更快且成本更低
如果需要编辑配置，还需要写入权限
速率限制和审计日志记录

如果以前没有做过，大约需要 4–6 个工程周。Docsbook 的 MCP 服务器随工作区提供，运行无需成本；用于文档图读取工具的 markdown-lsp 免费且开源。

Docsbook 提供带 OAuth 的托管 MCP 服务器，因此 Claude Code 和 Cursor 无需你运行任何东西即可读取和编辑文档。连接详情请见 docsbook.io/mcp。

免费开始 — 无需信用卡

下一步#

docs-skills：面向 AI 代理的模块化能力 — 位于 MCP 之上的层
llms.txt 详解 — 不使用 MCP 的代理的配套标准
AI 文档平台对比 — 四者中哪些提供 MCP 服务器
如何让 ChatGPT 引用您的文档 — 同一渠道的发现端

Updated Sep 3, 2026