最后更新于
这有帮助吗？
最后更新于
这有帮助吗？
这有帮助吗？
# GitBook 设置代理
## 目标
让我的文档在已发布的 GitBook 站点上上线。完成的标准 = 你把在线 URL 给我，并确认它能加载。凡是需要我操作的步骤，请明确告诉我——其他事情都你来做。
**首先，检查你的工具：**如果 gitbook MCP 工具已经连接，请跳过下面的连接步骤。这个提示可能之前已经粘贴过（例如，在重启之后）——如果是这样，请从上次中断的地方继续，而不是重新开始。
## 准备（立即开始）
向我要文档——本地文件夹或仓库。构建前先验证来源：准确回显你正在读取的内容，并列出其顶层内容，这样我可以确认它是正确的。如果你无法访问我指定的某个内容（私有仓库会返回 404，和不存在的一样），就停下来问我——绝不要用别的来源替代。在 GitBook 中创建任何内容之前，先把站点方案给我看。
## 连接
连接到 GitBook 的 MCP 服务器：`https://mcp.gitbook.com/mcp`（可流式 HTTP，OAuth）。
- **Claude Code**：`claude plugin marketplace add GitbookIO/gitbook-skills` 然后 `claude plugin install gitbook@gitbook-skills` —— 我会运行 `/reload-plugins` 和 `/mcp` 来登录。
- **Codex**：`codex mcp add gitbook --url https://mcp.gitbook.com/mcp`
- **Cursor**：将 URL 添加到 `.cursor/mcp.json` 的 `mcpServers` 下，然后我会在 Settings → MCP 中启用它。
- **没有终端的聊天应用**：告诉我在应用设置中把该 URL 添加为自定义连接器。
- **其他任何情况**：获取 https://gitbook.com/docs/getting-started/ai-documentation/gitbook-mcp.md 以查看设置说明，或使用来自 https://app.gitbook.com/account/developer 的 PAT 回退到 REST API。
大多数工具不会在会话中途加载新的 MCP 服务器。如果设置后 gitbook 工具仍未出现，请让我重启应用并再次粘贴此提示——你会检测到连接并继续。如果你可以运行命令，还可以安装 GitBook 的技能：`npx -y skills add GitbookIO/gitbook-skills -y`
如果由于我没有账户而登录失败，请引导我去 https://app.gitbook.com/join 创建一个，然后让我重试。
## 创建前检查
连接后，检查这些文档是否已经有 GitBook 站点——查看仓库的 Git Sync 状态并列出我组织的站点。如果站点已经存在，不要重复创建：改为更新它（如果 Git Sync 已接通，就在本地编辑并推送，或发起变更请求）。只有在不存在任何站点时才创建新站点。
## 构建并发布
使用 GitBook MCP 工具创建站点，导入我的内容，并发布。第一次发布先跳过 Git Sync——等站点上线后再向我提供这个选项。获取在线 URL 以确认它能加载，然后把它给我。
