MCP 生态集成 (MCP Integration)

Antigravity 支持 模型上下文协议 (Model Context Protocol, MCP)。该标准允许编辑器安全地连接到您的本地工具、数据库和外部服务，从而为 AI 提供除了当前打开文件之外的实时上下文。

什么是 MCP？

MCP 充当了 Antigravity 与您更广泛的开发环境之间的桥梁。您不需要手动向编辑器粘贴上下文（如数据库模式或日志），MCP 允许 Antigravity 在需要时直接获取这些信息。

核心特性 (Core Features)

1. 上下文资源 (Context Resources)

AI 可以从连接的 MCP 服务端读取数据，以为其建议提供信息支持。

• 示例：在编写 SQL 查询时，Antigravity 可以检查您线上运行的 Neon 或 Supabase 模式，以推荐正确的表名和列名。
• 示例：在调试时，编辑器可以拉取 Netlify 或 Heroku 的最新构建日志。

2. 自定义工具 (Custom Tools)

MCP 使 Antigravity 能够执行由您连接的服务器所定义的、特定的安全操作。

• 示例：“为这个 TODO 创建一个 Linear 议题。”
• 示例：“在 Notion 或 GitHub 中搜索身份验证模式。”

如何连接 (How to Connect)

您可以通过内置的 MCP 商店直接管理连接。

1. 访问商店：点击编辑器侧边栏顶部 “...” 下拉菜单，打开 MCP Store 面板。
2. 浏览并安装：从列表中选择任何受支持的服务器，然后点击 “Install”。
3. 身份验证：按照屏幕上的提示安全地关联您的账户（在适用情况下）。

安装完成后，该服务器的资源和工具将自动在编辑器中可用。

连接自定义 MCP 服务器 (Connecting Custom MCP Servers)

要连接到自定义 MCP 服务器：

1. 点击编辑器 Agent 面板顶部 “...” 下拉菜单，打开 MCP Store。
2. 点击 “Manage MCP Servers”（管理 MCP 服务器）。
3. 点击 “View raw config”（查看原始配置）。
4. 使用您的自定义 MCP 服务器配置修改 mcp_config.json。

该配置文件位于 ~/.gemini/antigravity/mcp_config.json。

配置文件结构 (Configuration Structure)

配置文件包含一个单独的 mcpServers 对象，您可以在其中定义想要连接的每个服务器：

{
  "mcpServers": {
    "serverName": {
      "command": "path/to/executable",
      "args": [
        "--arg1",
        "value1"
      ],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

配置项属性 (Configuration Properties)

每个服务器条目支持以下属性：

• 传输层 (Transport)（必选其一）：
  • command (string)：用于 stdio 传输的执行文件路径。
  • serverUrl (string)：Streamable HTTP 传输的远程服务器 URL。
• 可选属性：
  • args (string[])：用于 stdio 传输的命令行参数。
  • env (object)：stdio 服务器进程的环境变量。
  • cwd (string)：stdio 服务器的工作目录。
  • headers (object)：用于远程服务器的自定义 HTTP 请求头。
  • authProviderType (string)：身份验证提供程序。支持应用默认凭据（ADC）的 "google_credentials"。
  • oauth (object)：OAuth 客户端凭据（clientId, clientSecret）。
  • disabled (boolean)：暂时禁用某个服务器，而无需移除其配置。
  • disabledTools (string[])：不提供给模型的工具名称列表。

身份验证 (Authentication)

Google 凭据 (Google Credentials)

将 authProviderType 设置为 "google_credentials"，以使用 Google 应用默认凭据 (Google Application Default Credentials, ADC)：

{
  "mcpServers": {
    "my-gcp-service": {
      "serverUrl": "https://example.googleapis.com/mcp/",
      "authProviderType": "google_credentials"
    }
  }
}

这需要配置应用默认凭据。要进行设置，请运行：

gcloud auth application-default login

OAuth 认证

对于支持动态客户端注册 (Dynamic Client Registration, DCR) 的服务器，Antigravity 可以自动处理 OAuth，无需额外配置：

{
  "mcpServers": {
    "oauth-server": {
      "serverUrl": "https://api.example.com/mcp/"
    }
  }
}

如果服务器不支持动态客户端注册，您可以手动提供客户端凭据：

{
  "mcpServers": {
    "oauth-server": {
      "serverUrl": "https://api.example.com/mcp/",
      "oauth": {
        "clientId": "your-client-id",
        "clientSecret": "your-client-secret"
      }
    }
  }
}

如果您手动提供了客户端凭据，请确保将以下地址注册为 OAuth 提供商的重定向 URI：

https://antigravity.google/oauth-callback

当连接启用 OAuth 的服务器时：

1. 使用 Cmd + , (Mac) 或 Ctrl + , (Windows/Linux) 打开 Agent 设置。
2. 导航至 Customizations（自定义项）选项卡，点击服务器旁边的 “Authenticate” 按钮。

3. 在浏览器中完成身份验证，并复制授权码 (authorization code)。

4. 将授权码粘贴回设置面板中，然后点击 Submit。

5. 一旦完成身份验证，服务器将自动重新连接。

访问 Token 存储在 ~/.gemini/antigravity/mcp_oauth_tokens.json 中，过期的 Token 会自动刷新，失效 of the Token 会被移除。

自定义请求头 (Custom Headers)

对于需要自定义 HTTP 请求头（例如 API 密钥或 Bearer Token）的服务器，请将其添加到 headers 对象中：

{
  "mcpServers": {
    "my-remote-server": {
      "serverUrl": "https://api.example.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

受支持的服务器 (Supported Servers)

MCP 商店目前集成了对以下服务的支持：

• Airweave
• Arize
• AlloyDB for PostgreSQL
• Atlassian
• BigQuery
• Chrome DevTools
• ClickHouse
• Cloud SQL for PostgreSQL
• Cloud SQL for MySQL
• Cloud SQL for SQL Server
• Dart
• Dataplex
• Figma Dev Mode MCP
• Firebase
• GitHub
• Harness
• Heroku
• Linear
• Locofy
• Looker
• MCP Toolbox for Databases
• MongoDB
• Neon
• Netlify
• Notion
• PayPal
• Perplexity Ask
• Pinecone
• Postman
• Prisma
• Redis
• Sequential Thinking
• SonarQube
• Spanner
• Stripe
• Supabase