Antigravity 配置 boxtool 与 context7 MCP 服务：settings.json 骨架与连通性验证

1. 为什么要在 Antigravity 里同时接 boxtool 和 context7Antigravity 是 Google 推出的 Agent 优先开发环境它把编辑器、终端和 AI Agent 放在同一个工作台里。真正让它好用的关键是 MCPModel Context Protocol服务Agent 通过 MCP 拿到外部工具和实时文档才能从会聊天变成能干活。我这次要解决的具体问题是在 Antigravity 里同时挂两个 MCP 服务——boxtool 和 context7。boxtool 是我自己部署在云服务器上的工具服务负责执行一些自定义的盒子操作context7 是公开的文档检索服务能让 Agent 拉到最新的库文档避免写出过时代码。两个服务一个走自建 HTTP 端点一个走官方托管端点配置方式不完全一样混在一起容易踩坑。适合谁看已经在用 Antigravity、想让 Agent 调用外部工具和实时文档的开发者手里有自建 MCP 服务、需要统一管理多个 MCP 通道的人以及配置完发现服务不生效、想快速定位问题的人。下面我会给出可直接复制的settings.json骨架、TaoToken 统一 Key 通道的接入位置以及逐项连通性验证动作。2. 前置准备TaoToken 统一 Key 与两个 MCP 服务在动配置文件之前先把三样东西准备好否则后面验证会分不清是配置错还是 Key 错。第一是 TaoToken 的统一 API 通道。Antigravity 里的 Agent 要调用模型模型请求需要一个稳定的入口。TaoToken 提供统一的 Key 和 API 地址把模型调用集中到一个通道管理省得每个服务各配一套。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。你需要在控制台创建一个 API Key后面填进配置里。第二是 boxtool 服务。它部署在我的云服务器上对外暴露的 MCP 端点是http://120.26.179.50:5000/mcp。这里要注意boxtool 是你自己部署的所以它的可用性取决于服务器是否在跑、端口是否放行、路径是否是/mcp。配置前先用浏览器或 curl 确认这个地址能返回内容。第三是 context7 的 API Key。context7 的托管端点是https://mcp.context7.com/mcp但它需要鉴权Key 要去 context7 的 dashboard 里拿。拿到后填进请求头字段名是CONTEXT7_API_KEY。注意boxtool 走的是明文 HTTPcontext7 走的是 HTTPS。两者在同一个mcpServers对象里并存没问题但排查时要分开验证别把网络问题和鉴权问题混在一起。TaoToken 的 Key 创建入口在控制台的 API Keys 页面地址是 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。创建后复制保存页面刷新后不再完整显示。3. 可复制的 settings.json 配置骨架Antigravity 的 MCP 配置入口在设置里的 MCP 相关面板本质是编辑一份 JSON。下面这份骨架可以直接改字段使用两个服务都放在mcpServers下{ mcpServers: { boxtool: { serverUrl: http://120.26.179.50:5000/mcp }, context7: { serverUrl: https://mcp.context7.com/mcp, headers: { CONTEXT7_API_KEY: your-context7-api-key } } } }几个字段的含义要讲清楚不然改错一个就整段失效mcpServers是顶层容器每个子键就是一个 MCP 服务的名字名字随便起但建议见名知意比如boxtool和context7。serverUrl是服务的 MCP 端点地址。boxtool 填你自建服务的公网地址加/mcp路径context7 填官方托管地址。注意 boxtool 这里没有headers因为它不需要鉴权context7 必须有headers否则请求会被拒。headers里放鉴权信息。context7 的字段名是CONTEXT7_API_KEY值就是你从 dashboard 拿到的 Key。这个字段名是服务端约定的不能改成Authorization或别的名字。如果你希望模型请求也走 TaoToken 统一通道可以在 Antigravity 的模型配置区域把 API 基址设为https://taotoken.net/apiKey 填 TaoToken 控制台创建的那个。这样 MCP 服务和模型调用各管各的互不干扰。提示JSON 不支持注释复制骨架后别手贱加//否则解析直接失败。改完先用编辑器的 JSON 校验看一眼括号是否配对。4. 逐项连通性验证先 boxtool 再 context7配置保存不等于服务可用。Antigravity 通常会在 MCP 面板显示每个服务的连接状态但状态灯绿了也可能只是握手成功、实际调用失败。所以要做两层验证先看面板状态再发真实请求。先验证 boxtool。在终端里直接打它的端点确认服务活着curl -i -X POST http://120.26.179.50:5000/mcp \ -H Content-Type: application/json \ -d {jsonrpc:2.0,id:1,method:tools/list,params:{}}如果返回里带result和工具列表说明 boxtool 的 MCP 协议层是通的。如果返回Connection refused是服务器没跑或端口没开如果返回 404多半是路径不对检查是不是漏了/mcp。再验证 context7。它需要带 Key所以命令里要加请求头curl -i -X POST https://mcp.context7.com/mcp \ -H Content-Type: application/json \ -H CONTEXT7_API_KEY: your-context7-api-key \ -d {jsonrpc:2.0,id:1,method:tools/list,params:{}}返回 200 且带工具列表说明 Key 有效、端点可达。如果返回 401 或 403就是 Key 错了或没带上如果超时检查本机网络能否访问该域名。两个 curl 都通过后回到 Antigravity 的 MCP 面板刷新确认两个服务都显示已连接。然后在对话里让 Agent 调用一次 boxtool 的工具、再让它用 context7 查一个库的文档看返回是否符合预期。这一步是端到端验证比看状态灯靠谱。5. 本篇常见报错排查配置 MCP 时最容易卡在几个固定位置我把踩过的坑列出来对照。JSON 解析失败面板提示配置无效多半是括号不配对、多了逗号、或者加了注释。把整段贴进 JSON 校验工具过一遍别靠肉眼。boxtool 连接超时先确认服务器安全组放行了 5000 端口再确认服务进程在跑。自建服务最常见的不是配置错是服务根本没起来。context7 返回 401检查CONTEXT7_API_KEY字段名是否拼对值是否有多余空格。Key 复制时容易带上换行粘进去后手动删一下。服务显示已连接但调用无响应可能是 MCP 协议版本不匹配或者服务端工具注册有问题。用上面的 curl 直接打tools/list看服务端到底注册了哪些工具比在 Agent 里猜快得多。两个服务互相影响一般不会但如果 boxtool 的 HTTP 请求阻塞了主线程可能拖慢整体响应。把 boxtool 的超时设短一点避免它卡住时连累 context7 的调用。改了配置不生效Antigravity 有些版本需要重启或重新加载窗口才会重读 MCP 配置。改完先重载再验证。6. 把 MCP 通道和模型通道分开管理这套配置跑通后我的习惯是把两类通道分开MCP 服务负责工具和文档TaoToken 负责模型调用。这样任何一边出问题排查范围都清晰。如果你还在调模型接入可以先到模型对话页面确认 Key 和基址是否正常https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。如果你打算长期用 Antigravity 做编码和 Agent 任务建议直接上 Coding Plan把模型调用额度固定下来省得每次临时配https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面把基址、鉴权头和常见参数都列了配 MCP 时对照着看能少走弯路。最后留一个实用习惯每次改完settings.json先跑一遍第 4 节的两条 curl再回 Antigravity 刷新面板。顺序反了的话你会在面板和终端之间来回切浪费时间。