AgentDocs MCP 是 AgentDocs（agentdocs.eu）协作文档平台的 MCP 服务器，旨在让 AI 智能体成为文档协作的一等公民。它为运行本地服务器的 MCP 客户端（如 Claude Code、Claude Desktop、Cursor、Windsurf、Zed 等）提供原生工具，用于读取、搜索、创建、更新和分享 AgentDocs 页面。
主要能力：
- 提供 19 个工具，支持读取、搜索、创建、更新、评论和分享文档。
- 支持全文搜索和语义搜索。
- 页面、空间和工作区可通过 UUID 或人类可读的 slug 路径寻址（如 "my-workspace/my-space/my-page"）。
- 每次页面更新都会在服务器上创建版本，旧版本可从 AgentDocs UI 恢复。
- 支持账户令牌（完全访问）和空间令牌（仅限一个空间的编辑权限，服务器自动检测并限定范围）。
使用方式：
- 远程（托管）端点：无需安装任何包，任何支持远程 MCP 的客户端可直接使用 https://agentdocs.eu/mcp。Claude.ai（网页）、Claude Desktop 和 Claude 移动端可通过“设置 → 连接器 → 添加自定义连接器”添加该 URL，无需令牌，AgentDocs 实现 OAuth 2.1，浏览器会自动打开同意页面，批准后即可连接。授权仅覆盖你的文档，可随时在 agentdocs.eu → 设置 → 已连接应用 中撤销。
- 本地 stdio 服务器：需要 AgentDocs API 令牌。账户令牌从 agentdocs.eu → 个人资料 → 重新生成 API 令牌 获取；空间令牌从空间设置 → 令牌 获取。配置示例（Claude Code、Claude Desktop、Cursor、Windsurf、Gemini CLI、VS Code Copilot、opencode 等）可参考仓库文档。
- 对于不支持 MCP 的客户端（如 Base pi），可使用 Skill 或纯 REST API。
适用场景：
- AI 智能体需要读写和搜索协作文档时。
- 团队使用 AgentDocs 平台进行文档协作，希望 AI 直接参与。
- 需要将文档操作集成到 MCP 客户端工作流中。
限制与注意事项：
- 托管端点对 path 参数会拒绝，因为可能造成任意文件读取；应使用 source_url 或 data。
- 托管实例在空闲后首次请求可能需约 15 秒响应（数据库冷启动），服务器有 35 秒超时和一次重试。
- 免费层 API 限制会以清晰消息和升级链接呈现。
- 测试空间会被写入（创建和删除页面），建议使用临时空间。
- 部分 MCP 网关（如 Docker MCP 网关）仅运行目录中的服务器，agentdocs-mcp 尚未列入，可使用托管远程端点。
- Windows 上部分客户端无法直接启动 npx，需用 cmd /c 包装。
- 安全漏洞请私下报告至 contact@agentdocs.eu。
