用途
MCP Integration 是面向 Google Antigravity 插件的技能，用来通过 Model Context Protocol（MCP）把外部服务和 API 以结构化工具的形式接入插件。接入后，外部服务能力会作为工具暴露在 Google Antigravity 中，供命令或智能体调用。
主要能力
- 连接外部服务，例如数据库、API、文件系统。
- 从单个服务提供 10 个以上相关工具。
- 处理 OAuth 及复杂认证流程。
- 将 MCP 服务器随插件打包，实现自动配置。
配置方式
技能提供两种配置方法：
- 专用 .mcp.json（推荐）：在插件根目录创建 .mcp.json，将 MCP 配置与插件其他配置分离，便于维护，适合多个服务器。
- 在 plugin.json 内联：添加 mcpServers 字段，使用单一配置文件，适合简单的单服务器插件。
服务器类型
- stdio（本地进程）：以子进程方式执行本地 MCP 服务器，适合本地工具和自定义服务器。Google Antigravity 负责启动和管理进程，通过 stdin/stdout 通信，退出时终止进程。
- SSE（Server-Sent Events）：连接托管 MCP 服务器，支持 OAuth，适合云服务和官方托管 MCP 服务器，无需本地安装。
- HTTP（REST API）：连接 RESTful MCP 服务器，使用令牌认证，适合基于 REST API 的 MCP 服务器、自定义 API 后端和无状态交互。
- WebSocket（实时）：建立双向实时通信，适合实时数据流、持久连接、服务端推送和低延迟场景。
环境变量与工具命名
所有 MCP 配置支持环境变量替换，例如 ${ANTIGRAVITY_PLUGIN_ROOT} 表示插件目录，建议用于可移植路径；也可引用用户环境变量。技能建议在插件 README 中记录所有必需的环境变量。
MCP 工具会自动添加前缀，格式为：mcp__plugin_<plugin-name>_<server-name>__<tool-name>。在命令的 frontmatter 中可预授权特定 MCP 工具，出于安全考虑，技能建议预授权具体工具而非通配符。
生命周期与认证
插件启用时 MCP 服务器启动，首次使用工具前建立连接，配置变更后需要重启。可使用 /mcp 命令查看包括插件提供在内的所有服务器。认证方式包括：SSE 和 HTTP 下的 OAuth 自动处理、通过请求头的令牌认证、stdio 下通过环境变量传递配置。
集成模式
- 简单工具封装：命令结合用户交互调用 MCP 工具，可在调用前加入校验或预处理。
- 自主智能体：智能体自主使用 MCP 工具完成多步工作流。
- 多服务器插件：在一个插件中集成多个 MCP 服务器，覆盖跨服务工作流。
安全与错误处理
技能建议使用 HTTPS/WSS 安全连接；令牌应通过环境变量提供，不硬编码、不提交到代码库、不在文档中分享；仅预授权必要的 MCP 工具。错误处理涵盖连接失败、工具调用失败和配置错误，需提供回退行为、清晰错误信息并检查限流与配额。
测试与调试
本地测试流程包括：在 .mcp.json 中配置服务器、本地安装插件、运行 /mcp 确认服务器出现、在命令中测试工具调用、使用 claude --debug 查看连接问题。技能还提供验证清单和常见问题排查，例如服务器未连接、工具不可用、认证失败等。
适用场景与限制
适用于为 Google Antigravity 插件接入外部服务、打包 MCP 服务器、配置认证和管理 MCP 工具权限的开发者。资料主要面向插件开发与配置，未说明具体收费、价格或效果数据；实际可用性取决于所连接服务及其认证配置。