添加 MCP 服务器

Android Studio 的代理中的 Gemini 可以使用 模型上下文协议 (MCP)与外部工具进行交互。此功能为代理模式提供了一种标准化方式，以便使用工具并通过外部环境扩展知识和功能。

您可以在 Android Studio 中连接到 MCP 主机。例如 ，您可以与 GitHub MCP 服务器集成，以便直接从 Android Studio 创建 拉取请求；也可以与 Figma 远程 MCP 服务器集成，以便提供设计信息，而无需下载 桌面应用。如需了解更多想法，请参阅 MCP 示例服务器。

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

  1. 依次点击 File （在 macOS 中，点击 Android Studio ）> Settings > Tools > AI > MCP Servers ，前往 MCP 服务器设置。
  2. 选择 Enable MCP Servers 。
  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 服务器的文档。

身份验证

点击确定 后，您会看到一条通知，内容为“Successfully connected to MCP server…”或描述错误。大多数远程 MCP 服务器都需要进行身份验证，因此，当授权失败时，会返回“Error connecting to transport: Authorization Exception”。

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

使用 MCP 工具

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

然后，您可以在聊天中引用这些工具，例如“list my repositories on 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 登录