為 Kanera MCP 設定 Antigravity
Google Antigravity 透過 Model Context Protocol。它支援具備 OAuth 探索和動態用戶端註冊的遠端 Streamable HTTP 伺服器,因此不需要預先註冊的用戶端或 API 金鑰。同一份設定適用於 Antigravity 應用程式、IDE 和 Antigravity CLI。
使用 OAuth 連線(推薦)
將 Kanera 新增到你的全域 Antigravity MCP 設定 ~/.gemini/config/mcp_config.json,或新增到專案內的 .agents/mcp_config.json (當該連線只應在該處可用時):
{
"mcpServers": {
"kanera": {
"serverUrl": "https://mcp.kanera.app/mcp"
}
}
}
如果檔案中已列出其他伺服器,請將 kanera 項目加入現有的 mcpServers 物件中。在 IDE 中,你可以從代理側邊面板開啟此檔案:選擇 … -> MCP Servers -> Manage MCP Servers -> View raw config.
然後進行驗證:
- 在 Antigravity 應用程式中,開啟 Customizations -> Installed。在 MCP Servers,選擇 驗證身分 旁邊的 Kanera。
- 在瀏覽器中登入 Kanera,檢視所要求的存取權限,然後選擇 允許存取.
- 複製 Antigravity 顯示的授權碼,將其貼到 Enter authorization code,並選擇 Submit.
Antigravity 會在權杖過期時自動更新並重新連線到 Kanera。在 Antigravity CLI 中,輸入 /mcp 開啟 MCP 管理員,確認 Kanera 已連線,並查看其連線記錄。
Antigravity 在執行沒有權限規則的 MCP 工具之前會先詢問。若要讓它不必每次詢問就能使用 Kanera 的工具,請將 mcp(kanera/*) 加入你的 Antigravity 權限中。無論用戶端允許什麼,Kanera 仍會在每次請求時檢查你在每個看板上的角色,以及你組織的 AI 代理政策 。
請參閱 連線 AI 代理 了解權限範圍與如何中斷代理的連線。
安裝 Kanera 技能
MCP 連線讓 Antigravity 可以使用 Kanera 的工具。選用的 Kanera 代理技能 會教它將名稱解析為穩定的 ID、在報告或變更工作前先讀取即時狀態、區分已完成工作與建立活動、使用冪等金鑰,並安全地處理權限或速率限制失敗。
使用開放的 Agent Skills 安裝程式全域安裝技能:
npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera -a antigravity --yes --global
要進行手動安裝,請下載完整的 kanera 技能目錄,並放在下列其中一個位置:
~/.gemini/config/skills/kanera/跨專案的個人技能。.agents/skills/kanera/放在儲存庫中,以便與該專案共用技能。
Antigravity 會向其代理顯示此技能,並在請求相關時載入完整說明。你也可以在提示中指名此技能,或輸入 /kanera (在應用程式或 CLI 中)。在 CLI 中,執行 /skills reload (如果你在工作階段中新增了此技能)。
例外:使用 API 金鑰連線
API 金鑰是需要你自行保管和輪替的長期機密,使用個人金鑰完成的工作會記錄為你本人,且不帶 透過 <代理人> 標籤。只有在 OAuth 確實無法使用時才使用金鑰:
- 你的 Antigravity 版本無法完成遠端 OAuth 流程。
- 你需要一個本機 stdio 伺服器,而且無法使用 Kanera CLI.
kanera auth login會以 OAuth 登入,而kanera mcp會使用該登入提供 stdio 服務,無需金鑰。 - 這台機器沒有可用於登入的瀏覽器。請優先嘗試 裝置授權 (如果你的用戶端支援)。
當你確實要使用金鑰時,請將其建立為 只讀 ,除非代理必須變更工作。
Antigravity 會依原樣傳送標頭值,因此金鑰會儲存在設定檔本身中。請使用全域 ~/.gemini/config/mcp_config.json 而非專案檔案,並且絕對不要提交它:
{
"mcpServers": {
"kanera": {
"serverUrl": "https://mcp.kanera.app/mcp",
"headers": {
"Authorization": "Bearer YOUR_KANERA_API_KEY"
}
}
}
}
個人金鑰請在 個人資料設定 -> API 金鑰 建立,或到下列位置建立工作區金鑰: 工作區設定 -> API.