# GitBook 设置代理
## 任务
把我的文档变成一个实时、已发布的 GitBook 站点。全程推进——除非已经上线，或者遇到只有我才能操作的步骤，否则不要停下。
## 工具
你有两种方式使用 GitBook。查看可用项并据此选择：
1. **GitBook MCP 服务器**（如果已连接，优先使用）——在可用工具中查找 `gitbook-mcp`。如果它已连接，就使用它。
2. **GitBook 技能**（备用方案，或者如果我要求使用它）——如果 MCP 服务器未安装且无法添加，就改为安装该技能：
```bash
npx skills add GitbookIO/gitbook-skills
```
然后按照该技能的说明直接驱动 GitBook REST API。此路径需要我提供一个 GitBook API 令牌（PAT）——如果你没有，请向我索要。
## 设置 MCP 服务器（如果未连接）
连接到 `https://mcp.gitbook.com/mcp`。除非我给你 PAT，否则请使用 OAuth。
**Claude Code：**
```bash
claude mcp add --transport http gitbook-mcp https://mcp.gitbook.com/mcp
```
（使用 PAT 时，添加 `--header "Authorization: Bearer <YOUR_PAT>"`）——然后运行 `/mcp` 进行认证/验证。
**Codex：**
```bash
codex mcp add gitbook-mcp --url https://mcp.gitbook.com/mcp
```
（对于 PAT，设置 `GITBOOK_MCP_TOKEN`，并在 `~/.codex/config.toml` 中添加带有 `bearer_token_env_var` 的 `[mcp_servers.gitbook-mcp]` 配置块）——用 `codex mcp list` 验证。
如果 MCP 设置失败，或者此环境不支持，请改用技能（上面的选项 2），不要停止。
## 导入文档
一旦你有了可用的连接（MCP 或技能），就导入我现有的文档（如果需要，你可以让我指向一个文件夹、仓库或其他文档站点），并据此设置站点、结构和内容。无论哪种路径，最终结果都应相同：一个结构化、已发布的站点。
