簡短回答
- 1Gemini CLI:執行
gemini mcp add --scope user --transport stdio skillry npx -- --yes skillry-cli@latest mcp。不加--scope user就只套用到目前專案。 - 2Antigravity:把
skillry項目合併進~/.gemini/config/mcp_config.json,然後在 Antigravity CLI 輸入/mcp。 - 3兩個工具都一樣,在工作階段裡輸入
/mcp會列出伺服器和它的工具。
開始之前
以上步驟於 2026 年 10 月 28 日按官方文件核對,尚未在這個客戶端的實際安裝上實測。要是你電腦上有哪一步不一樣,用頁尾的 回報問題 告訴我們。
- Gemini CLI(
gemini --version)或 Antigravity CLI(agy)已安裝並登入。如果gemini告訴你它已被取代,就用 Antigravity 分頁。 - Node.js 22 或更新版(
node --version)。
| 工具 | 設定檔 | 檢查 |
|---|---|---|
| Gemini CLI | ~/.gemini/settings.json(使用者)或 .gemini/settings.json(專案) | gemini mcp list 或 /mcp |
| Antigravity CLI、App 與 IDE | ~/.gemini/config/mcp_config.json(全域)或 .agents/mcp_config.json(工作區) | CLI 裡 /mcp;App 裡 Installed MCP Servers |
把 Skillry 加進 Gemini CLI 或 Antigravity
- 1
在任何終端機執行。
--把 Gemini 自己的選項和傳給npx的參數分開。macOS gemini mcp add --scope user --transport stdio skillry npx -- --yes skillry-cli@latest mcp你應該會看到: 沒有錯誤,而且
gemini mcp list現在包含skillry。 - 2
Windows 上改執行這一條,讓 Windows 能啟動
npx:Windows(PowerShell 或命令提示字元) gemini mcp add --scope user --transport stdio skillry cmd -- /c npx --yes skillry-cli@latest mcp - 3
開一個新的 Gemini CLI 工作階段。
你應該會看到:
/mcp清單裡有skillry和它的工具。
- 1
打開
~/.gemini/settings.json(只給一個專案用就打開該專案裡的.gemini/settings.json)。 - 2
把這段合併進
mcpServers物件,保留已有的伺服器。macOS { "mcpServers": { "skillry": { "command": "npx", "args": [ "--yes", "skillry-cli@latest", "mcp" ] } } } - 3
Windows 上改用這個項目。
Windows { "mcpServers": { "skillry": { "command": "cmd", "args": [ "/c", "npx", "--yes", "skillry-cli@latest", "mcp" ] } } } - 4
儲存並開一個新工作階段。
你應該會看到:
/mcp清單裡有skillry。
- 1
打開或建立
~/.gemini/config/mcp_config.json。只給一個工作區用就改用該工作區裡的.agents/mcp_config.json。 - 2
把這段合併進
mcpServers物件。格式和 Gemini CLI 一樣。macOS { "mcpServers": { "skillry": { "command": "npx", "args": [ "--yes", "skillry-cli@latest", "mcp" ] } } } - 3
Windows 上改用這個項目。
Windows { "mcpServers": { "skillry": { "command": "cmd", "args": [ "/c", "npx", "--yes", "skillry-cli@latest", "mcp" ] } } } - 4
在 Antigravity CLI 輸入
/mcp打開 MCP 管理器並重新整理。在 Antigravity App 裡打開 Settings,再點 Customizations,找到 Installed MCP Servers 並點 Refresh。你應該會看到:
skillry和它的工具被列出來。
檢查連線是否正常
- 1
Gemini CLI:列出已設定的伺服器。
終端機 gemini mcp list你應該會看到:
skillry連同它的指令和已連線狀態。 - 2
兩個工具都一樣:在工作階段裡輸入
/mcp。你應該會看到:
skillry和它的工具,第一個是search_skills。
試試第一次搜尋
搜尋不需要帳號,所以這是驗證連線最快的辦法。
- 1
在 Gemini CLI 或 Antigravity 裡開一個新對話,把這段話貼進去。
給 Agent 的提示詞 Use the Skillry MCP connected to https://skillry.dev to find three product presentation Skills. Show their preview links, required inputs, dependencies and external costs. Do not install or run anything.你應該會看到: 三個候選 Skill,每個都帶預覽連結、需要的輸入、相依項目和外部費用。什麼都沒有被安裝。
- 2
Agent 要是回答它沒有 Skillry 工具,或者請求一直卡著,去看不能用怎麼辦。
Agent 看不到 Skillry 時
| 你看到的現象 | 可能原因 | 解法 |
|---|---|---|
換到別的資料夾 gemini mcp list 就是空的 | 伺服器是用預設的專案範圍加的 | 用 --scope user 重加一次,或把項目搬到 ~/.gemini/settings.json。 |
gemini 說 CLI 已被取代 | 你的方案已轉到 Antigravity CLI | 用 Antigravity 分頁。項目是同一段 JSON,只是放在不同檔案。 |
| Antigravity 沒讀到檔案 | 檔案有 JSON 錯誤,或沒有重新整理 | 驗證 JSON,然後在 CLI 輸入 /mcp 或在 App 點 Refresh。 |
| 伺服器在清單裡,但顯示失敗,或者一直沒啟動 | 沒裝 npx,Node.js 版本低於 22,或者第一次啟動下載套件時逾時 | 在終端機執行 node --version 和 npx --version。然後手動執行一次 npx --yes skillry-cli@latest mcp,等它啟動後按 Ctrl+C,再試一次客戶端:套件已經快取好了。 |
| Windows 上伺服器一啟動就退出 | 項目直接啟動 npx,但 Windows 需要一個 shell 才能執行它 | 用這個頁面的 Windows 項目:指令是 cmd,參數以 /c、npx 開頭。 |
| 瀏覽器頁面說請求無效或已過期 | 裝置代碼核准得太晚,或者是上一次嘗試留下的 | 請 Agent 重新連線,並在幾分鐘內核准新的代碼。 |
| 安裝停在 Premium 或購買提示 | 這個 Skill 是 Premium,而你的帳號既沒有方案也沒買過它 | 點 Agent 給的連結購買 Skill 或訂閱,然後再問一次。在你動手前不會扣任何費用。 |
移除或中斷連線
- 1
Gemini CLI:從使用者設定移除伺服器。
終端機 gemini mcp remove -s user skillry - 2
Antigravity:從
mcp_config.json刪掉skillry項目並重新整理。想保留但不載入,就在項目上設"disabled": true。
移除項目不會讓你登出 Skillry。要連已存的核准一起撤銷,先請 Agent 中斷你的 Skillry 帳號連線,或者移除項目後等核准 7 天後自動過期。
參考
| 項目 | macOS | Windows |
|---|---|---|
| Gemini CLI 使用者設定 | ~/.gemini/settings.json | %USERPROFILE%\.gemini\settings.json |
| Antigravity 全域設定 | ~/.gemini/config/mcp_config.json | %USERPROFILE%\.gemini\config\mcp_config.json |
| 啟動指令 | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
| 檢查 | gemini mcp list 或 /mcp | 相同 |
{
"mcpServers": {
"skillry": {
"command": "npx",
"args": [
"--yes",
"skillry-cli@latest",
"mcp"
]
}
}
}Gemini CLI 的 --scope、--timeout 和 --trust 選項在 Gemini CLI MCP 文件;Antigravity 的檔案格式和 App 的 MCP 設定在 Antigravity MCP 文件。
常見問題
Gemini CLI 要停了嗎?
Google 在 2026 年 6 月 18 日把免費方案和 Google One 使用者轉到 Antigravity CLI;付費方案繼續用 Gemini CLI。Skillry 項目在兩個工具裡是同一段 JSON。
為什麼要加 --scope user?
Gemini CLI 的預設範圍是目前專案。使用者範圍把項目放進 ~/.gemini/settings.json,在每個資料夾都能用。
Antigravity App 和 CLI 共用這個項目嗎?
是。App、CLI 和 IDE 都讀 ~/.gemini/config/mcp_config.json。
參考來源
這篇指南對你有幫助嗎?
