結論先說
- 本機全局 MCP 配置文件固定在
~/.gemini/config/mcp_config.json:Windows 對應C:\Users\<你的用戶名>\.gemini\config\mcp_config.json;如果想隨項目或團隊插件分發,則放在plugins/<插件名>/mcp_config.json。 - 官方原生支持 Stdio(本地進程)與 Streamable HTTP(遠程服務)兩種傳輸:遠程地址用
url字段(兼容舊鍵名serverUrl),通常指向服務端的/mcp路徑。 - 不支持舊版純
HTTP+SSE(/sse)直連:這是最容易踩的坑。如果遠端服務只實現了 2024-11-05 舊版 SSE 協議,官方給出的標準解法是在本地用mcp-remote跑成 Stdio 橋接模式。 - 配完先去面板驗活:點擊介面右上角「更多選項(Additional Options
...)> MCP 伺服器(MCP Servers)」,能一眼看到每個服務的連接綠燈與已發現的工具清單。 - 谷歌帳號準備與主力編程訂閱入口:使用 Antigravity 全系列客戶端需登入符合開放地區與年齡條件的個人谷歌帳號,缺號可查看本站 谷歌帳號購買說明(含帶 2FA 自動發卡的 谷歌電郵成品號);多工具主力開發訂閱總覽見 AI 會員充值中心。

圖:本站根據 Antigravity MCP 官方文檔 整理的示意圖
本文根據 Google Antigravity 官方 MCP 文檔(antigravity.google/docs/mcp)整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是軟件介面截圖。本站(bigolab.com)不是 Google 官方網站。
適用於誰
- 想給 Antigravity 接入本地數據庫查詢、瀏覽器測試、Figma 設計稿或公司內部接口工具的開發者;
- 照搬其他編輯器裏的遠程
/sse地址寫進配置卻一直報連接失敗的人; - 配完 JSON 文件後在工具欄看不到新工具,想知道去哪看報錯狀態的人。
一、mcp_config.json 放哪、標準語法怎麼寫
Antigravity 把所有外部 MCP 服務統一收口在 mcpServers 對象下。你可以同時混合配置本地命令行啟動的進程與遠端託管的微服務:
json
{
"mcpServers": {
"sqlite-local": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sqlite", "./data/app.db"],
"env": {
"DB_READONLY": "true"
}
},
"team-docs-remote": {
"url": "https://mcp.example.com/mcp"
},
"legacy-sse-bridge": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://old-mcp.example.com/sse"]
}
}
}
三種典型寫法的字段要求對照如下:
- 本地 Stdio 服務:必填
command(可執行程序名,如node、python3或二進制路徑),可選填參數數組args與注入子進程的環境變量對象env。底層語言伺服器(Language Server)會自動拉起子進程並通過標準輸入輸出通信。 - 遠程 Streamable HTTP 服務:必填
url,指向符合 MCP 2025-03-26 規範的端點(常見後綴為/mcp)。 - 舊版 SSE 兼容橋接:當第三方平台只給了一個
/sse結尾的舊地址時,不要填在url裏,而是像上面第 3 個示例那樣通過npx -y mcp-remote <舊地址>轉成標準流接入。
如果你平時還在用 Codex 或 Claude Code,想複用同一批 MCP 服務定義,可以對照本站已有的 Codex 配置 MCP 伺服器教學 與 Claude Code 接入 GitHub MCP 實戰。需要準備合規谷歌開發帳號或開通雙工具會員時,可查看 谷歌帳號購買頁 與 Claude Code 訂閱充值頁。
二、連接成功後怎麼調用與管理作用域
配置儲存併成功握手後,Antigravity 會自動走完「查詢可用工具(Tool Discovery)→ 注入系統提示詞 → 按需路由執行」三步:
- 在面板核查工具詳情:依次打開 更多選項(Additional Options
...)> MCP Servers,檢查目標服務是否已正常拉取到工具函數列表;在 Antigravity 2.0 桌面端的左側「技能與定製(Skills & Customizations)」面板也能統一管理。 - 對話中用
@直接點名:在聊天畫布輸入@呼出引用選單,切到 MCP servers/tools 分類,可以把特定服務或工具直接掛載進當前指令,避免模型在一大堆工具裏選錯。 - 全局級與插件級隔離:寫在
~/.gemini/config/mcp_config.json裏的服務對所有會話常駐生效(掛載過多工具會佔用一定上下文空間);只有特定倉庫才用的專屬數據庫或內網工具,建議封裝進插件目錄plugins/<名稱>/mcp_config.json,系統還會在必要時自動添加命名空間前綴防止同名衝突。關於工作流技能的按需拆分可參考 Antigravity Skills 編寫與加載指南。
三、常見報錯與連不上排查清單

圖:本站根據 Antigravity 官方文檔 整理的排錯決策示意圖
- 桌面圖標啟動後報
spawn npx ENOENT或找不到python:在 macOS 或 Windows 直接雙擊桌面圖標啟動 IDE 時,圖形介面進程有時讀不到你在終端.zshrc/nvm裏配置的節點路徑。解決辦法是在終端跑which npx(Windows 跑where.exe npx)查出完整絕對路徑,直接填進command字段。 - JSON 多了一個末尾逗號導致整份配置靜默失效:標準 JSON 不允許對象最後一個屬性後面帶逗號,粘貼完建議在編輯器裏看一眼有沒有語法紅線。
- 沙箱或網絡策略攔住了本地服務發請求:如果你的 MCP 工具需要訪問外網接口,記得去「設定(Settings)」確認網絡訪問策略(Internet Access Policy)未被設為全局拒絕。客戶端初次上手設定見 Google Antigravity 下載安裝教學。
常見問題
問:掛載十幾個 MCP 伺服器會影響代碼響應速度和配額嗎?
答:會有影響。每個已激活 MCP 服務暴露出來的工具名稱和參數結構都會被注入系統提示詞。不常用的重型工具建議拆到插件裏按項目開關,日常保持精簡。
問:mcp_config.json 裏的密鑰(如 GITHUB_TOKEN)能提交到代碼庫嗎?
答:絕對不要把明文密鑰提交進 Git。包含個人 Token 的服務請一律放在本機用戶目錄 ~/.gemini/config/mcp_config.json 下,不要放進共享倉庫。
問:為什麼改了遠程端點地址還是連舊地址?
答:前往 Additional Options (...) > MCP Servers 面板手動點一次刷新或重連,讓語言伺服器重新執行工具發現握手即可。
問:國內沒有可用的個人谷歌帳號,或者重度寫代碼想搭配其他編程訂閱怎麼辦?
答:可在本站即時選購帶獨立 2FA 的 谷歌電郵成品號(首登順序與 3 天首登質保細則見 谷歌帳號購買頁),支持支付寶、微信支付與 AlipayHK;若日常還需要高配額終端智能體互補,也可自助兌換 Claude Code 訂閱 或 ChatGPT Plus。
0 條評論
還沒有評論,來搶沙發~