為 Kanera MCP 設定 Claude
Claude on the web、Claude Desktop 和 Claude Code 可以透過以下方式連線到 Kanera: 模型上下文協議.
Claude 和 Claude Desktop: 使用 OAuth 連線
Kanera 是已釋出的 Claude 聯結器。 搜尋 Kanera 下 自定義 -> 聯結器 並選擇 連線。 Claude 開啟瀏覽器登入和同意螢幕；您不建立或貼上 API 金鑰。它適用於每個託管的 Kanera 計劃，包括 Free。
如果已釋出的聯結器對於當前帳戶或工作區不可見,請將相同的生產端點新增為自定義聯結器:
-
開放 自定義 -> 聯結器.
-
選擇 + -> 新增自定義聯結器.
-
輸入 Kanera 的 MCP 地址:
https://mcp.kanera.app/mcp -
選擇 新增，那麼 連線.
對於限制聯結器的團隊或企業組織,所有者或主要所有者可能需要啟用 Kanera 下 組織設定 -> 聯結器 會員可以連線它之前。
Claude 開啟 Kanera 選項卡。 登入,檢視代理可以執行的操作,然後選擇 允許訪問。為對話啟用 Kanera + -> 聯結器 選單，位於評論編輯框旁。
管理或稍後從中斷開代理 配置檔案設定 -> API 金鑰。參見 連線 AI 代理 如果 OAuth 不是選項,請參閱 關於API金鑰異常 下文。
Claude 程式碼: 與OAuth連線
當 Claude 程式碼與同一個 Claude 帳戶登入時,首先執行 claude mcp list。如果已釋出的 Kanera 聯結器已存在，則啟動 Claude 程式碼，輸入 /mcp，並在那裡連線或驗證它。不要新增重複的伺服器。
如果 Kanera 未存在,請為您的使用者新增託管伺服器,以便在專案之間可用:
claude mcp add --transport http kanera --scope user https://mcp.kanera.app/mcp
啟動 Claude 程式碼並輸入 /mcp。選擇Kanera並完成瀏覽器身份驗證流程。執行 claude mcp list 確認它報告 連線.
只用外殼的備用
如果代理可以執行 shell 命令但無法使用 MCP,請安裝 Kanera CLI,而不是自動化 Web 介面:
npx -y @kanera/cli commands # inspect it without a global install
npm install --global @kanera/cli # persistent command; requires Node 22+
kanera auth login
kanera setup claude --global
kanera whoami --json
CLI 會公開相同的 Kanera 工具層。 kanera auth login 透過您的瀏覽器使用OAuth登入,與聯結器的方式相同,因此無需建立金鑰;使用 --with-api-key 當已釋出的聯結器可用時,應優先使用該聯結器,因為它不需要安裝。
安裝 Kanera 技能
MCP 連線使 Claude 能夠訪問 Kanera 的工具。 Kanera 代理技能 教會它如何將名稱解析為穩定的 ID,在報告或更改工作之前讀取當前狀態,使用等效金鑰,並安全地處理故障。
npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera --yes --global
如果技能不出現,請重新啟動 Claude 。 Claude 可以自動載入相關工作,或者您可以顯式呼叫它。
例外:使用 API 金鑰連線
:::警告 儘可能使用 OAuth API 金鑰是您自己儲存和輪換的長期秘密，並且使用個人金鑰完成的工作會記錄為您，而無需 透過 <代理人> 只有在 OAuth 真正無法工作時才使用一個標籤:
- 您的 Claude 設定不能使用已釋出的聯結器或帶有 OAuth 的自定義聯結器。
- 您需要一個本地 stdio 伺服器,不能使用 Kanera CLI.
kanera auth login使用 OAuth 登入,並且kanera mcp使用該登入服務 stdio,無需金鑰。 - 計算機沒有用於登入的瀏覽器。 嘗試 裝置授權 首先,如果你的客戶端支援它。
當您使用金鑰時,請建立它 只讀 除非代理必須更改工作,並將其儲存在環境變數中而不是提交的檔案中。 : : :
替換 kanera_live_... 從一個私人金鑰 配置檔案設定 -> API 金鑰 或者從下面的工作區鍵 工作區設定 -> API。對於個人 Claude 設定，個人金鑰通常是合適的選擇，因為它遵循您自己的跨工作區的板訪問許可權。
Claude 程式碼
對於具有靜態金鑰的託管 HTTP 端點:
claude mcp add --transport http kanera --scope user https://mcp.kanera.app/mcp \
--header "Authorization: Bearer kanera_live_..."
對於本地 stdio 伺服器,執行 Kanera CLI 伺服器:
claude mcp add kanera --scope user \
--env KANERA_API_KEY=kanera_live_... \
--env KANERA_PUBLIC_API_URL=https://api.kanera.app \
-- npx -y @kanera/cli mcp
如果你已經跑了 kanera auth login，同時刪除 --env 旗幟； kanera mcp 重用儲存的憑據。 執行 claude mcp list 確認伺服器已連線。
Claude 桌面
開放 設定 -> 開發者 -> 編輯配置，開啟 claude_desktop_config.json，並在下面新增伺服器 mcpServers:
{
"mcpServers": {
"kanera": {
"command": "npx",
"args": ["-y", "@kanera/cli", "mcp"],
"env": {
"KANERA_API_KEY": "kanera_live_...",
"KANERA_PUBLIC_API_URL": "https://api.kanera.app"
}
}
}
}
儲存後重新啟動 Claude Desktop,然後開啟新對話並確認 Kanera 工具可用。 此配置透過 stdio 在本地執行伺服器,並需要 Node 22 或更高版本。
如果您已經在 Claude Desktop 中配置了 Kanera,並且稍後安裝了 Claude Code,則 Claude Code 可以透過以下方式匯入桌面配置:
claude mcp add-from-claude-desktop
此匯入命令可在 macOS 和 Windows 子系統 for Linux (WSL) 上使用。