為 Kanera MCP 設定 OpenCode
連線到網路 Kanera 透過 模型上下文協議。它支援遠端 MCP 伺服器的自動 OAuth 發現和動態客戶端註冊，因此不需要預先註冊客戶端或 API 金鑰。
使用 OAuth 連線(推薦)
將 Kanera 新增到您的 OpenCode 配置中：
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"kanera": {
"type": "remote",
"url": "https://mcp.kanera.app/mcp",
"enabled": true
}
}
}
OpenCode 在 Kanera 首次需要身份驗證時會自動啟動 OAuth。 您也可以顯式啟動瀏覽器流:
opencode mcp auth kanera
登入到 Kanera,檢視請求的訪問許可權,然後選擇 允許訪問。執行 opencode mcp list 如果發現或身份驗證失敗,請使用 opencode mcp debug kanera 檢查流量。
海 連線 AI 代理 用於作用域和斷開代理。
安裝 Kanera 技能
MCP 連線允許 OpenCode 訪問 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/或~/.config/opencode/skills/kanera/跨專案的個人技能。.agents/skills/kanera/或.opencode/skills/kanera/將技能與該專案共享。
OpenCode 會向其代理列出技能,並在相關時載入完整的指令。 如果您透過 OpenCode 許可權限制工具或技能,請確保 skill 工具和工具包 kanera_* MCP 工具不被拒絕。
例外:使用 API 金鑰連線
:::警告 儘可能使用 OAuth API 金鑰是您自己儲存和輪換的長期秘密，並且使用個人金鑰完成的工作會記錄為您，而無需 透過 <代理人> 只有在 OAuth 真正無法工作時才使用一個標籤:
- 您的 OpenCode 版本無法完成遠端 OAuth 流程。
- 您需要一個本地 stdio 伺服器,不能使用 Kanera CLI.
kanera auth login使用 OAuth 登入,並且kanera mcp使用該登入服務 stdio,無需金鑰。 - 計算機沒有用於登入的瀏覽器。 嘗試 裝置授權 首先,如果你的客戶端支援它。
當您使用金鑰時,請建立它 只讀 除非代理必須更改工作,並將其儲存在環境變數中而不是提交的檔案中。 : : :
引用環境變數而不是在配置中儲存金鑰:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"kanera": {
"type": "remote",
"url": "https://mcp.kanera.app/mcp",
"oauth": false,
"headers": {
"Authorization": "Bearer {env:KANERA_API_KEY}"
}
}
}
}
建立一個私鑰 配置檔案設定 -> API 金鑰 或者一個工作區鍵 工作區設定 -> API.