添加 MCP 服务器

Android Studio 中 Gemini 的代理可以使用 Model Context Protocol (MCP) 与外部工具互动。此功能为代理模式提供了一种标准化方式，以便使用工具并通过外部环境扩展知识和能力。

您可以在 Android Studio 中将许多工具连接到 MCP Host。例如，您可以与 GitHub MCP 服务器集成，以便直接从 Android Studio 创建拉取请求；也可以与 Figma 远程 MCP 服务器集成，以便在不下载桌面应用的情况下提供设计信息。如需了解更多创意，请参阅 MCP 示例服务器。

如需添加 MCP 服务器，请按以下步骤操作：

  1. 依次点击 File（在 macOS 上为 Android Studio）> Settings > Tools > Gemini > MCP Servers，前往 MCP 服务器设置。
  2. 选择启用 MCP 服务器。
  3. 在提供的字段中添加 MCP 配置。配置会保存在 Android Studio 的配置目录中的 mcp.json 文件中。
  4. 点击确定。

以下示例展示了一个包含多个服务器配置的 mcp.json 文件：

{
  "mcpServers": {
    "figma": {
      "httpUrl": "https://mcp.figma.com/mcp"
    },
    "github": {
      "httpUrl": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer <YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    },
    "gitlab": {
      "httpUrl": "https://gitlab.com/api/v4/mcp"
    },
    "canva": {
      "httpUrl": "https://mcp.canva.com/mcp"
    },
    "notion": {
      "httpUrl": "https://mcp.notion.com/mcp"
    },
    "linear": {
      "httpUrl": "https://mcp.linear.app/mcp"
    }
  }
}

如需了解要在此文件中列出的确切配置值，请参阅您要集成的 MCP 服务器的文档。

身份验证

点击确定后，您会看到一条通知，其中显示“已成功连接到 MCP 服务器…”或描述错误。大多数远程 MCP 服务器都需要进行身份验证，因此当授权失败时，会返回“Error connecting to transport: Authorization Exception”。

点击开始登录，以启动相应服务器的身份验证流程。系统会要求您在浏览器中登录该服务器的登录页面。登录后，系统会再次尝试连接，如果连接成功，您会看到“已成功连接到 MCP 服务器...”通知。

使用 MCP 工具

如需查看 Gemini 在 Android Studio 中可用的工具，请在对话中输入 /mcp。

然后，您可以在对话中引用这些工具，例如“列出我在 GitHub 上的代码库”。

配置

本部分介绍了所有 MCP 服务器配置选项。

HTTP MCP 服务器

下表列出了通过可流式传输的 HTTP 传输连接到 MCP 服务器的配置选项。

名称 类型 说明
httpUrl 字符串 必需。可流式传输的 HTTP 端点的完整网址（例如 https://example.com/mcp 或 http://localhost:1234/mcp）。
headers Map<String, String> 要包含在连接请求中的自定义 HTTP 标头的映射。 默认值为 {}（一个空映射）。
timeout 长 连接超时时间（以毫秒为单位）。-1 表示不超时。默认值为 -1。
enabled 布尔值 相应服务器配置是否处于有效状态。默认值为 true。

限制

Android Studio 的 MCP 集成不支持以下功能：

  • 通过 stdio 传输连接到 MCP 服务器
  • MCP 资源
  • 提示模板
  • 使用某些 MCP 服务器（例如 GitHub）进行 OAuth 登录