為 Kanera MCP 設定 GitHub Copilot
透過 GitHub Copilot 在 VS 程式碼中連線到 Kanera 模型上下文協議。本指南涵蓋 VS Code 桌面應用程式； Copilot CLI 和 GitHub.com 編碼代理使用不同的 MCP 配置位置。
您需要訪問 GitHub Copilot 和 VS Code 1.99 或更高版本。 如果 Copilot 來自商業或企業組織,其管理員必須啟用 Copilot 中的 MCP 伺服器 政策。
使用 OAuth 連線(推薦)
對於遠端連線,新增 Kanera 的 MCP 地址並在瀏覽器中進行身份驗證,無需建立或儲存 API 金鑰。
-
運行 MCP:新增伺服器 從命令調色盤中,選擇 HTTP，輸入
https://mcp.kanera.app/mcp，命名它kanera，並將其儲存到您的使用者配置檔案中。或者，執行 MCP:開放使用者配置 並手動新增 Kanera,或建立.vscode/mcp.json當前工作區的設定 -
要進行手動配置,請將 Kanera 新增為遠端 HTTP 伺服器:
{"servers": {"kanera": {"type": "http","url": "https://mcp.kanera.app/mcp"}}} -
啟動伺服器並確認您信任其配置。 VS Code 檢測到 OAuth 要求並開啟瀏覽器身份驗證流程;如果內聯操作顯示 授權，選擇它。
-
登入到 Kanera,檢視請求的訪問許可權,然後選擇 允許訪問.
-
運行 MCP: 列表伺服器 確認 Kanera 已連線。 開啟 Copilot 聊天 代理 模式,並確認 Kanera 工具在工具選擇器中顯示。
海 連線 AI 代理 用於作用域和斷開代理。
安裝 Kanera 技能
MCP 連線可讓 Copilot 訪問 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/或~/.copilot/skills/kanera/跨專案的個人技能。.agents/skills/kanera/或.github/skills/kanera/將技能與該專案共享。
在 Copilot 聊天中,使用 /skills 當請求涉及到 Kanera 時,Copilot 可以自動載入它,或者您可以呼叫 kanera 技能明確。
例外:使用 API 金鑰連線
:::警告 儘可能使用 OAuth API 金鑰是您自己儲存和輪換的長期秘密，並且使用個人金鑰完成的工作會記錄為您，而無需 透過 <代理人> 只有在 OAuth 真正無法工作時才使用一個標籤:
- 您的 VS Code 設定無法完成遠端 OAuth 流程。
- 您需要一個本地 stdio 伺服器,不能使用 Kanera CLI.
kanera auth login使用 OAuth 登入,並且kanera mcp使用該登入服務 stdio,無需金鑰。 - 計算機沒有用於登入的瀏覽器。 嘗試 裝置授權 首先,如果你的客戶端支援它。
當您使用金鑰時,請建立它 只讀 除非代理必須更改工作,並將其儲存在環境變數中而不是提交的檔案中。 : : :
替換 kanera_live_... 從一個私人金鑰 配置檔案設定 -> API 金鑰 或者從下面的工作區鍵 工作區設定 -> API，並設定 KANERA_PUBLIC_API_URL 至 https://api.kanera.app。對於個人 VS Code 設定，個人金鑰通常是合適的選擇，因為它遵循您自己的跨工作區的板訪問許可權。
VS Code 桌面應用程式
GitHub 副駕駛讀 MCP 從一個伺服器 .vscode/mcp.json 要在專案中提供個人配置,請執行 MCP:開放使用者配置 從命令調色盤中選擇並編輯使用者 mcp.json 檔案
對於本地 stdio 伺服器,執行 Kanera CLI 作為伺服器(Node 22 或更高版本 ) 。 kanera auth login，你可以省略 env; kanera mcp 重用儲存的憑據。
{
"servers": {
"kanera": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@kanera/cli", "mcp"],
"env": {
"KANERA_API_KEY": "kanera_live_...",
"KANERA_PUBLIC_API_URL": "https://api.kanera.app"
}
}
}
}
對於具有靜態 API 金鑰的遠端 HTTP 端點:
{
"servers": {
"kanera": {
"type": "http",
"url": "https://mcp.kanera.app/mcp",
"headers": {
"Authorization": "Bearer kanera_live_..."
}
}
}
}
使用工具
開啟 Copilot 聊天檢視,切換到 代理 伺服器啟動後,Kanera 工具將出現在工具選擇器中。
請不要提交 API 金鑰 .vscode/mcp.json。將個人配置放入使用者級檔案中，或使用 VS Code 的輸入變數支援，以便請求金鑰而不是儲存在儲存庫中。