关于 GitBook MCP by usefulapi
GitBook MCP by usefulapi 是面向 GitBook 用户的托管 MCP 服务,用于读取空间、页面和集合、搜索文档,并管理组织空间。它包含只读查询工具以及创建和更新变更请求的写入工具。
主要功能
- 01列出并读取组织与空间
- 02查看页面和集合内容
- 03搜索空间或组织文档
- 04列出评论和变更请求
- 05创建或更新变更请求
适用场景
- 01查找组织文档中的信息
- 02读取特定空间的页面内容
- 03检查待处理的变更请求和评论
- 04提交或更新文档变更请求
MCP 相关
该托管 MCP 服务通过远程端点向 MCP 客户端提供 GitBook 查询和变更请求工具。首次连接时使用 GitBook API token 登录。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://gitbook.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-gitbook https://gitbook.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-gitbook":{"type":"http","url":"https://gitbook.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-gitbook":{"type":"http","url":"https://gitbook.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-gitbook":{"type":"http","url":"https://gitbook.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-gitbook":{"serverUrl":"https://gitbook.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
14此工具无需参数。
详细介绍
usefulapi 的 GitBook MCP
通过 Claude、Cursor 或任何 MCP 客户端使用你的 GitBook 账户——读取空间、集合、页面和内容,搜索文档,并管理组织空间。托管式服务, 无需本地安装:使用你自己的凭据连接。
在线端点: https://gitbook.usefulapi.io/mcp · 主页: https://usefulapi.io
连接
- Claude(claude.ai、桌面版):打开 自定义 → 连接器,点击 + 添加 → 添加自定义连接器,然后粘贴
https://gitbook.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http gitbook https://gitbook.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"gitbook": {
"url": "https://gitbook.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 GitBook 凭据。
分步设置说明、凭据查找位置和常见问题解答:https://usefulapi.io/gitbook/
首次连接时,你需要提供 GitBook API 令牌(设置 → 开发者 → API 令牌)。令牌经过验证后会按用户单独存储,并仅限你本人使用——配置文件中不会包含密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
gitbook_get_current_user | read | 获取当前用户 |
gitbook_list_organizations | read | 列出组织 |
gitbook_list_spaces | read | 列出空间 |
gitbook_get_space | read | 获取空间 |
gitbook_list_pages | read | 列出页面 |
gitbook_get_page | read | 获取页面 |
gitbook_search_space | read | 搜索空间 |
gitbook_search_organization | read | 搜索组织 |
gitbook_list_collections | read | 列出集合 |
gitbook_get_collection | read | 获取集合 |
gitbook_list_change_requests | read | 列出变更请求 |
gitbook_list_comments | read | 列出评论 |
gitbook_create_change_request | write | 创建变更请求 |
gitbook_update_change_request | write | 更新变更请求 |
gitbook_usage_status | meta | 使用情况(免费额度计数) |
gitbook_request_feature | meta | 申请所需功能 |
gitbook_upgrade | meta | 升级到 Pro(不限量*) |
gitbook_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应在执行前征求确认);meta 工具用于报告使用情况、管理订阅或提交功能申请。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| Free | $0 | 每月 50 次工具调用 |
| Pro | $9/月 或 $90/年(免费 2 个月) | 不限量* |
*此服务上的 Pro 套餐每月限用 10,000 次工具调用,以确保合理使用。更多调用请联系 [email protected]。
Pro 仅适用于此服务。使用 gitbook_upgrade 订阅(该工具会返回 Stripe Checkout 链接)。可随时使用 gitbook_cancel_subscription 取消:Pro 权限会持续到付费周期结束,当前周期不予退款;在此之前运行 gitbook_upgrade 则会撤销取消操作。你也可以联系 [email protected]。
许可证
MIT——详见 LICENSE。仅提供文档;服务由托管方运行。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。