為 Kanera MCP 設定 Gemini CLI
Gemini CLI 透過以下連結連線到 Kanera 模型上下文協議。它支援遠端 HTTP 伺服器、自動 OAuth 發現、動態客戶端註冊和令牌重新整理。
使用 OAuth 連線(推薦)
新增 Kanera 作為遠端 HTTP 伺服器：
gemini mcp add --scope user --transport http kanera https://mcp.kanera.app/mcp
啟動 Gemini CLI,然後從互動式提示符進行身份驗證:
/mcp auth kanera
雙子座 CLI 開幕 Kanera 登入,檢視請求的訪問許可權,然後選擇"登入"按鈕。 允許訪問。執行 gemini mcp list 從你的 shell 驗證伺服器是否連線,或者使用 /mcp 雙子座CLI內部檢查它。
您也可以直接在Gemini CLI中配置Kanera settings.json:
{
"mcpServers": {
"kanera": {
"httpUrl": "https://mcp.kanera.app/mcp"
}
}
}
互動式 OAuth 需要本地瀏覽器和 localhost 回撥。 在無頭或遠端環境中,如果無法完成該回撥,請使用 裝置授權 如果您的客戶端支援裝置授權,或迴歸到 API 金鑰。參見 連線 AI 代理 用於作用域和斷開代理。
安裝 Kanera 技能
MCP 連線可讓 Gemini CLI 訪問 Kanera 的工具。 可選 Kanera 代理技能 教會它如何將名稱解析為穩定 ID、在報告或更改工作前讀取實時狀態、區分已完成的工作和建立活動、使用等效金鑰,以及安全處理許可權或速率限制失敗。
使用開啟的 Agent Skills 安裝程式全域性安裝技能:
npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera --yes --global
要進行手動安裝,請下載完整的 kanera 將它放在下面的位置之一:
~/.agents/skills/kanera/或~/.gemini/skills/kanera/跨專案的個人技能。.agents/skills/kanera/或.gemini/skills/kanera/將技能與該專案共享。
運行 /skills list Gemini CLI 內部驗證技能是否可用,並且 /skills reload Gemini CLI 在啟用技能時會要求確認。
例外:使用 API 金鑰連線
:::警告 儘可能使用 OAuth API 金鑰是您自己儲存和輪換的長期秘密，並且使用個人金鑰完成的工作會記錄為您，而無需 透過 <代理人> 只有在 OAuth 真正無法工作時才使用一個標籤:
- 您的 Gemini CLI 環境無法完成 localhost OAuth 回撥。
- 您需要一個本地 stdio 伺服器,不能使用 Kanera CLI.
kanera auth login使用 OAuth 登入,並且kanera mcp使用該登入服務 stdio,無需金鑰。 - 計算機沒有用於登入的瀏覽器。 嘗試 裝置授權 首先,如果你的客戶端支援它。
當您使用金鑰時,請建立它 只讀 除非代理必須更改工作,並將其儲存在環境變數中而不是提交的檔案中。 : : :
新增授權標頭 settings.json 從您的環境中讀取金鑰:
{
"mcpServers": {
"kanera": {
"httpUrl": "https://mcp.kanera.app/mcp",
"headers": {
"Authorization": "Bearer $KANERA_API_KEY"
}
}
}
}
建立一個私鑰 配置檔案設定 -> API 金鑰 或者一個工作區鍵 工作區設定 -> API。避免將鑰匙直接插入 settings.json.