結論先說
- 先分清你敲的是
agy還是gemini,兩者的配置文件分家了:新版 Antigravity CLI(agy)把 MCP 獨立拆到了~/.gemini/config/mcp_config.json;仍在跑舊版 Gemini CLI(gemini)的用戶則繼續配在~/.gemini/settings.json的mcpServers字段下。 - 遠程伺服器地址的字段名變了:在舊 Gemini CLI 裏遠程 HTTP 地址常寫
httpUrl;遷移到 Antigravity CLI 後,官方標準字段是url(兼容serverUrl),且只原生支持 Streamable HTTP(/mcp),不支持舊版純/sse直連。 - 兩代終端都提供交互式
/mcp斜槓命令:進會話後輸入/mcp可查看各服務握手狀態與工具列表;舊版還支持在終端直接敲gemini mcp add命令快速寫入配置。 - 首次運行
agy可一鍵遷移舊配置:如果本機已有.gemini/settings.json,第一次啟動agy時按嚮導勾選即可自動轉換生成新的mcp_config.json。 - 谷歌帳號準備與多工具訂閱入口:使用 Gemini、Google AI Studio 與 Antigravity 需具備符合地區與年齡要求的個人谷歌帳號,缺號可查看本站 谷歌帳號購買說明(含帶 2FA 的 谷歌電郵成品號),跨平台付費訂閱總覽見 AI 會員充值中心。

圖:本站根據 Antigravity 官方遷移文檔 與 MCP 文檔 整理的示意圖
本文根據 Google Antigravity 官方文檔《Model Context Protocol (MCP)》《Migrating from Gemini CLI》《CLI Reference》與 Gemini CLI 官方文檔整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Google 官方網站。
適用於誰
- 從原 Gemini CLI(
gemini命令)升級到 Antigravity CLI(agy命令)後,發現以前寫在settings.json裏的 MCP 工具讀不出來的開發者; - 仍在用 API Key 或企業許可跑 Gemini CLI,搜「gemini cli 配置 mcp」想知道
gemini mcp add命令和項目級配置放哪的人; - 配好本地
npx或遠程/sse地址後在終端報連接失敗、找不到可執行程序的人。
一、配置文件到底在哪個目錄(兩代 CLI 路徑對照)
自 2026 年 6 月個人 Google 帳號從 Gemini CLI 轉向 Antigravity CLI 後(背景詳見 Gemini CLI 與 Antigravity CLI 關係及安裝教學),很多網上的舊教學還在教人往 settings.json 裏塞 mcpServers,結果在 agy 裏完全不生效。對照官方遷移說明,兩套路徑的準確位置如下:
| 配置維度 | 新版 Antigravity CLI(agy) | 原 Gemini CLI(gemini,API Key / 企業版可用) |
|---|---|---|
| 本機全局配置 | ~/.gemini/config/mcp_config.json | ~/.gemini/settings.json(內含 mcpServers) |
| 當前項目級配置 | .agents/mcp_config.json(或裝入項目插件) | .gemini/settings.json(位於倉庫根目錄) |
| CLI 自身設定文件 | ~/.gemini/antigravity-cli/settings.json | 與全局 settings.json 合用同一文件 |
| 遠程端點字段名 | "url"(兼容 "serverUrl",走 Streamable HTTP) | "httpUrl" 或 "url" |
在 Windows PowerShell 裏,~ 對應的就是你的用戶主目錄 C:\Users\<用戶名>\。如果你把個人密鑰(如 GITHUB_TOKEN 或數據庫連接串)寫進了 env 字段,請只放在本機全局目錄裏,不要放進項目級配置提交到 Git 倉庫。
二、標準 JSON 寫法與命令行添加步驟
1. 在 Antigravity CLI(agy)裏寫 mcp_config.json
打開或新建 ~/.gemini/config/mcp_config.json,本地命令行工具走 Stdio(填 command、args、env),遠程託管服務走 Streamable HTTP(填 url):
json
{
"mcpServers": {
"filesystem-local": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"]
},
"github-remote": {
"url": "https://api.githubcopilot.com/mcp/",
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
}
},
"legacy-sse-bridge": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://old-server.example.com/sse"]
}
}
}
儲存後在終端啟動 agy,在輸入框敲 /mcp 回車,就能調出狀態面板核對每個伺服器是否已連上並列出發現的工具函數。關於兩種傳輸協議的底層差異,可延伸閱讀 MCP 的 stdio、SSE 和 Streamable HTTP 區別說明。
2. 在原 Gemini CLI(gemini)裏用 gemini mcp add 命令添加
如果你是通過付費 Gemini API Key 或企業許可繼續使用 gemini 命令行,除了手改 .gemini/settings.json,還可以直接用自帶的子命令往用戶級(--scope user)或項目級(--scope project)追加服務:
bash
# 添加本地 Stdio 類型的 MCP 伺服器到當前用戶全局配置
gemini mcp add --scope user sqlite-local npx -y @modelcontextprotocol/server-sqlite ./app.db
# 添加遠程 HTTP 類型的 MCP 伺服器並附帶認證頭
gemini mcp add --transport http --scope project --header "Authorization: Bearer YOUR_TOKEN" team-docs https://mcp.example.com/mcp
# 查看已配置的伺服器列表;進入交互會話後可用 /mcp reload 熱重載
gemini mcp list
三、常見連接報錯與逐項排查

圖:本站根據 Antigravity MCP 文檔 與 Gemini CLI 參考文檔 整理的排錯示意圖
- Windows 終端報
spawn npx ENOENT或子進程瞬間退出:Windows 上的npx實際是.cmd批處理腳本,部分進程拉起方式直接調npx會找不到可執行文件。把"command": "npx"改成"command": "cmd",再把"args"開頭加上["/c", "npx", "-y", ...](或者填where.exe npx查出的絕對路徑)即可解決。 - 遠程
/sse地址填進agy後一直握手失敗:Antigravity 官方文檔明確說明不再直接支持 2024-11-05 舊版HTTP+SSE傳輸。如果對方服務端還沒提供/mcp端點,請照上文代碼塊第 3 段用npx -y mcp-remote <SSE地址>做本地 Stdio 橋接。 - 工具太多拖慢每次提問或互相重名:只把高頻剛需服務放全局配置,低頻工具用
enabledTools/disabledTools(舊版為includeTools/excludeTools)裁剪暴露出來的函數列表。如果你在多款命令行工具之間共用 MCP,也可對照 Claude Code MCP 配置教學 與 Codex MCP 配置教學。需要準備谷歌開發帳號或了解各家編程工具訂閱時,可查看本站 谷歌帳號購買說明 與 充值服務總覽。
常見問題
問:第一次裝好 agy 錯過了自動遷移提示,怎麼手動把舊擴展和配置導過來?
答:按官方遷移文檔,可以在終端執行 agy plugin import gemini 把舊版 Gemini CLI 擴展導入轉換成 Antigravity 插件,或手動把舊 settings.json 裏的 mcpServers 對象複製到 ~/.gemini/config/mcp_config.json 並把 httpUrl 改為 url。
問:為什麼連上了 MCP 伺服器,智能體調用工具時每次都要停下來等我點確認?
答:預設權限策略下,外部未受信的 MCP 寫入或變更操作都會觸發人工審批,避免第三方工具誤刪數據。你可以在 /permissions(或配置文件權限列表)裏僅對只讀安全的查詢工具(如 mcp(docs/*))配置自動允許。
問:改完 mcp_config.json 後需要重啟整個電腦終端嗎?
答:不需要重啟系統終端。在 agy 裏用 /mcp 面板刷新重連(或在 gemini 裏執行 /mcp reload),或者按 Ctrl+D 退出當前會話重進一次即可加載最新配置。
問:沒有可用的個人谷歌帳號,或者同時想開其他主流 AI 會員怎麼辦?
答:本站提供即買即發的 谷歌電郵成品號(登入方法見 谷歌帳號購買頁),同時支持支付寶、微信支付與 AlipayHK 自助充值 ChatGPT Plus、Claude Code 等主流服務,實時價格與質保細則以各商品頁說明為準。
相關教學
- Gemini CLI 怎麼用:安裝、登入與 2026-06-18 改用 Antigravity CLI 說明
- MCP 的 stdio、SSE 和 Streamable HTTP 有什麼區別
- Claude Code MCP 配置教學:claude mcp add 與配置文件位置
- Codex 怎麼配置 MCP:codex mcp add 與 config.toml 寫法
參考資料
- Antigravity 官方文檔:Model Context Protocol (MCP) — https://antigravity.google/docs/mcp
- Antigravity 官方文檔:Migrating from Gemini CLI — https://antigravity.google/docs/gcli-migration
- Antigravity 官方文檔:CLI Reference — https://antigravity.google/docs/cli/reference
- Gemini CLI 官方文檔:CLI Reference — https://geminicli.com/docs/cli/cli-reference
0 條評論
還沒有評論,來搶沙發~