為 Kanera MCP 設定游標

游標透過連線到Kanera 模型上下文協議。 Cursor 支援具有 OAuth 的遠端可流式 HTTP 伺服器，因此您可以透過瀏覽器進行連線，而無需建立或儲存 API 金鑰。

使用 OAuth 連線(推薦)

一鍵安裝

安裝 Cursor 後,開啟此連結,一步將 Kanera 新增到 Cursor:

游標顯示即將新增的伺服器 (https://mcp.kanera.app/mcp）並要求您確認。然後完成如下所述的瀏覽器登入。如果連結未開啟 Cursor，或者您自行託管 Kanera，請改為手動新增配置。的 MCP配置生成器還為自託管地址構建連結。

手動配置

Kanera 顯示此配置,並在下方填入您的 MCP 地址 配置檔案設定 -> API 金鑰 -> 或手動配置 -> 游標.

將 Kanera 新增到您的全域性 Cursor MCP 配置中： ~/.cursor/mcp.json，或到 .cursor/mcp.json 當連線只應該在專案中可用時:

{
  "mcpServers": {
    "kanera": {
      "url": "https://mcp.kanera.app/mcp"
    }
  }
}

Cursor 檢測到 Kanera 需要 OAuth 並要求您進行身份驗證。在 Cursor Agent 中,您可以顯式啟動瀏覽器流:

cursor-agent mcp login kanera

登入到 Kanera,檢視請求的訪問許可權,然後選擇 允許訪問。然後驗證連線和可用工具：

cursor-agent mcp list
cursor-agent mcp list-tools kanera

在游標編輯器中,開啟 設定 -> 工具和 MCP 檢查伺服器及其工具。參見連線 AI 代理用於作用域和斷開代理。

安裝 Kanera 技能

MCP 連線可讓 Cursor 訪問 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/ 或 ~/.cursor/skills/kanera/ 跨專案的個人技能。
.agents/skills/kanera/ 或 .cursor/skills/kanera/ 將技能與該專案共享。

如果技能不出現,請重新啟動 Cursor。 Cursor 可以在相關請求時自動載入技能,或者您可以呼叫 /kanera 明確地。

例外:使用 API 金鑰連線

:::警告儘可能使用 OAuth API 金鑰是您自己儲存和輪換的長期秘密，並且使用個人金鑰完成的工作會記錄為您，而無需 透過 <代理人> 只有在 OAuth 真正無法工作時才使用一個標籤:

您的 Cursor 版本無法完成遠端 OAuth 流程。
您需要一個本地 stdio 伺服器,不能使用 Kanera CLI. kanera auth login 使用 OAuth 登入,並且 kanera mcp 使用該登入服務 stdio,無需金鑰。
計算機沒有用於登入的瀏覽器。嘗試裝置授權首先,如果你的客戶端支援它。

當您使用金鑰時,請建立它只讀除非代理必須更改工作,並將其儲存在環境變數中而不是提交的檔案中。 : : :

從環境變數讀取金鑰,而不是將其提交到專案配置:

{
  "mcpServers": {
    "kanera": {
      "url": "https://mcp.kanera.app/mcp",
      "headers": {
        "Authorization": "Bearer ${env:KANERA_API_KEY}"
      }
    }
  }
}

集合 KANERA_API_KEY 在啟動 Cursor 的環境中建立私鑰。 配置檔案設定 -> API 金鑰 或者一個工作區鍵 工作區設定 -> API.

客戶參考

游標的當前 MCP 指南

使用 OAuth 連線(推薦)​

一鍵安裝​

手動配置​

安裝 Kanera 技能​

例外:使用 API 金鑰連線​

客戶參考​