新增 MCP 伺服器

Android Studio 中的 Gemini 代理可使用 Model Context Protocol (MCP) 與外部工具互動。這項功能提供標準化方式,讓 Agent 模式使用工具,並透過外部環境擴充知識和功能。

您可以在 Android Studio 中將許多工具連結至 MCP 主機。舉例來說,您可以與 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. 按一下「OK」

以下範例顯示包含多個伺服器設定的 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」。

按一下「Start Login」,即可啟動該伺服器的驗證程序。系統會要求你在瀏覽器中登入該伺服器的登入頁面。登入後,系統會再次嘗試連線,如果成功,您會看到「Successfully connected to MCP server...」(已成功連線至 MCP 伺服器...) 通知。

使用 MCP 工具

如要查看 Gemini 版 Android Studio 可用的工具,請在即時通訊中輸入 /mcp

接著,您可以在對話中參照工具,例如「列出我在 GitHub 上的存放區」。

設定

本節說明所有 MCP 伺服器設定選項。

HTTP MCP 伺服器

下表列出透過可串流 HTTP 傳輸連線至 MCP 伺服器的設定選項。

名稱 類型 說明
httpUrl 字串 此為必要項目。可串流 HTTP 端點的完整網址 (例如 https://example.com/mcphttp://localhost:1234/mcp)。
headers Map<String, String> 要在連線要求中加入的自訂 HTTP 標頭對應。 預設值為 {} (空白地圖)。
timeout 連線逾時時間,以毫秒為單位。-1 表示沒有逾時。預設值為 -1。
enabled 布林值 這項伺服器設定是否有效。預設值為 true

限制

Android Studio 的 MCP 整合功能不支援下列功能:

  • 透過 stdio 傳輸連線至 MCP 伺服器
  • MCP 資源
  • 提示範本
  • 使用 GitHub 等部分 MCP 伺服器進行 OAuth 登入