Antigravity CLI(原 Gemini CLI)怎麼配置 MCP 伺服器:settings.json 位置、添加命令與報錯排查

在終端用 Antigravity CLI(agy)或原 Gemini CLI 時,MCP 伺服器到底配在 settings.json 還是 mcp_config.json?本文按官方文檔講清兩代 CLI 的配置文件路徑差異、命令行添加方法與連接排錯。

NNathaniel bigo··原創首發·AI 輔助撰寫
12 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 其他 帳號

結論先說

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

Antigravity CLI 與原 Gemini CLI 的 MCP 配置對照

圖:本站根據 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

三、常見連接報錯與逐項排查

CLI 配置 MCP 常見報錯排查決策

圖:本站根據 Antigravity MCP 文檔 與 Gemini CLI 參考文檔 整理的排錯示意圖

  1. Windows 終端報 spawn npx ENOENT 或子進程瞬間退出:Windows 上的 npx 實際是 .cmd 批處理腳本,部分進程拉起方式直接調 npx 會找不到可執行文件。把 "command": "npx" 改成 "command": "cmd",再把 "args" 開頭加上 ["/c", "npx", "-y", ...](或者填 where.exe npx 查出的絕對路徑)即可解決。
  2. 遠程 /sse 地址填進 agy 後一直握手失敗:Antigravity 官方文檔明確說明不再直接支持 2024-11-05 舊版 HTTP+SSE 傳輸。如果對方服務端還沒提供 /mcp 端點,請照上文代碼塊第 3 段用 npx -y mcp-remote <SSE地址> 做本地 Stdio 橋接。
  3. 工具太多拖慢每次提問或互相重名:只把高頻剛需服務放全局配置,低頻工具用 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 等主流服務,實時價格與質保細則以各商品頁說明為準。

相關教學

參考資料

  • 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

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同模型

  1. 01

    用 Google Takeout 單獨備份導出 NotebookLM 筆記本與 Gemini 記錄:只勾選指定服務不下載整個雲端硬碟的步驟

    想把 NotebookLM 裏的幾十個研究筆記本、來源副本與音頻概覽,連同 Gemini 聊天記錄一起備份到本地,又怕 Google Takeout 把整個雲端硬碟和相冊全打包?本文講清先取消全選、精準勾選兩項服務、解壓目錄查看與跨號遷移的做法。

    Gemini0
  2. 02

    Google Workspace 企業/教育版管理員怎麼在後台給成員開啟 Gemini 應用、NotebookLM 與設定年齡訪問權限

    團隊成員或學校師生登入 Google Workspace 帳號時提示無權使用 Gemini 或打不開 NotebookLM?本文按 Google 管理控制檯官方文檔整理服務開關路徑、組織部門(OU)與群組放行、18 歲年齡訪問權限設定及對話保留合規配置。

    Gemini0
  3. 03

    安卓手機預設助手換成 Gemini 後設鬧鐘、發短訊或控制智能家居失靈怎麼辦:Workspace 與實用程序擴展開啟步驟

    安卓手機把預設語音助手從 Google Assistant 換成 Gemini 後,喊它定鬧鐘、開手電筒、發短訊或開關智能燈全都沒反應?本文按官方幫助中心整理實用程序(Utilities)、Google Home 與 Workspace 關聯應用開啟步驟及鎖屏放行設定。

    Gemini0
  4. 04

    Gemini 寫長代碼或長文檔到一半突然停住、格式截斷怎麼無縫續寫:錨點接續指令與 Canvas 分塊修改技巧

    讓 Gemini 寫幾百行代碼或萬字長文時經常寫到一半突然停住、Markdown 代碼塊沒閉合,直接回「繼續」又重頭抄一遍?本文整理字面錨點續寫指令、代碼塊防亂碼補齊法與 Canvas 局部圈選修改工作流。

    Gemini0
  5. 05

    NotebookLM 中文音頻播客(Audio Overview)高階玩法:用自定義引導詞控制對談深度、受眾水平與重點章節(附模板)

    NotebookLM 生成的中文音頻播客總是泛泛而談、漏掉核心章節或夾雜生僻英文縮寫?本文按官方幫助中心整理來源勾選過濾、四種播客格式搭配與三維自定義引導詞寫法,附 4 套可直接複製的中文控場模板。

    Gemini0
  6. 06

    NotebookLM 添加 YouTube 影片、網頁或掃描版 PDF 提示「無法導入來源」怎麼辦:無字幕、反爬與純圖 PDF 逐項解決

    往 NotebookLM(Gemini Notebook)塞 YouTube 連結、外文網頁或掃描教材時總是亮紅歎號提示無法導入來源?本文按官方幫助中心逐項排查無字幕影片、反爬動態頁與加密純圖 PDF 的替代導入步驟。

    Gemini0

同產品的其他教學

  1. 01

    用 ChatGPT 速讀英文產品手冊、開源文檔與 GitHub Issue 並沉澱團隊中文內訓手冊

    團隊引入海外 SaaS 工具或開源框架時,全英文文檔晦澀冗長、真正的坑全藏在幾十頁 GitHub Issue 討論裏。本文分享速讀拆解英文手冊、歸類 Issue 排障庫以及重構團隊中文內訓 SOP 的完整實戰流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 寫油猴腳本(Tampermonkey)與瀏覽器書籤小工具解決網頁繁瑣重複操作實戰

    每天在後台系統裏重複勾選幾十個複選框、手工複製網頁表格或清理遮擋閱讀的側邊欄,既枯燥又浪費時間。本文分享不會寫 JS 也能用 F12 配合 ChatGPT 寫出油猴腳本與書籤小工具的完整實戰流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 寫高質素 SQL 窗口函數(RANK / LAG / SUM OVER)做留存與漏斗分析實戰

    做用戶留存率、復購間隔與有序轉化漏斗時,多層自連接既難讀又拖垮數據庫,窗口函數則是高效解法。本文整理數據庫方言喂數規範、CTE 分層提示詞以及用內置沙盒先驗證再上線的完整實戰流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 連接 Canva、Figma、Linear、Jira、Dropbox 等第三方應用搜不到數據或授權失效怎麼辦

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 後,明明顯示已連接卻搜不到文件工單,或老提示授權失效怎麼辦?本文拆解帳號錯綁、OAuth 範圍漏選、權限繼承與管理員攔截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    Anthropic Contextual Retrieval(上下文增強檢索)是什麼、怎麼實現:給文檔塊自動補背景摘要結合緩存降失誤率

    長文檔切成小塊後丟了公司名、年份和主語指代導致 RAG 頻頻搜錯?本文按 Anthropic 官方技術文章詳解 Contextual Retrieval 原理、官方公開評測失誤率下降 49% 至 67% 的組合架構,以及用 Claude 提示詞緩存低成本批量生成切片背景的完整 Python 代碼。

    Claude其他 AI 工具0
  6. 06

    RAG 知識庫回答不準怎麼調優:切片大小(Chunking)、BM25 + 向量混合檢索與 Rerank 重排序三步排查法

    搭好的 RAG 企業知識庫一問具體型號、報錯碼或跨行表格就答非所問?本文按 OpenAI 與 Anthropic 官方檢索文檔,給出先隔離檢索與生成故障、再按結構化切片(Chunking)、BM25 加向量混合召回(RRF)與 Rerank 重排序逐層調優的三步法。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~