為 Kanera MCP 設定 Codex
ChatGPT 桌面應用程式、Codex CLI 和 Codex IDE 擴充套件透過以下方式連線到 Kanera: 模型上下文協議。它們共享同一 Codex 主機的 MCP 配置，因此您通常只需新增 Kanera 一次。
安裝 Kanera 外掛(推薦)
在 ChatGPT 桌面應用程式中,開啟 外掛, 搜尋 Kanera 由 深圳市華德軟體有限公司，然後安裝它。出現提示時透過 OAuth 連線您的 Kanera 帳戶，然後啟動新的 Codex 聊天並要求其使用 Kanera。該外掛捆綁了 MCP 連線和技能，因此無需單獨安裝技能或手動伺服器註冊。
在 Codex CLI 中,輸入 /plugins 開啟外掛瀏覽器,從可用的市場安裝 Kanera,然後啟動新會話。 帳戶、工作區策略和配置的市場源決定可用性。
IDE 擴充功能不支援插件。使用 手動連線 以及以下針對 IDE、自架 Kanera 部署或外掛程式不可用的用戶端的獨立技能。避免在插件已連接時註冊第二個託管伺服器。
如果插件不可用：手動連接 OAuth
如果您的外掛程式市場中缺少 Kanera 或外掛程式安裝不可用，請直接新增 MCP 伺服器並使用 OAuth 連接您的 Kanera 帳戶。託管的MCP位址是 https://mcp.kanera.app/mcp。對於自託管，請從下列位置複製部署的 MCP 位址： 配置檔案設定 -> API 金鑰 相反。您不需要建立或儲存 API 金鑰。
codex mcp add kanera --url https://mcp.kanera.app/mcp
codex mcp login kanera
登入命令將在瀏覽器中開啟 Kanera。 登入,檢視請求的訪問許可權,然後選擇 允許訪問。執行 codex mcp list 伺服器是否已註冊,或者使用 /mcp 使用 Codex CLI 檢查連線。
在 ChatGPT 桌面應用程式中,開啟 設定 -> MCP 伺服器 -> 新增伺服器。在 IDE 擴充套件中，開啟齒輪選單並選擇 MCP 伺服器 -> 新增伺服器。輸入 Kanera, 選擇 可流式傳輸HTTP，並使用相同的 URL。出現提示時儲存並重新啟動，然後選擇 認證 當 Kanera 要求登入時。
您也可以在下面的步驟中配置遠端伺服器: ~/.codex/config.toml:
[mcp_servers.kanera]
url = "https://mcp.kanera.app/mcp"
那就跑 codex mcp login kanera。參見 連線 AI 代理 用於作用域和斷開代理。
安裝手動連線的技能
如果您安裝了外掛,其捆綁的技能已經可用。 對於手動設定,MCP 連線允許 Codex 訪問 Kanera 的工具。 Kanera 代理技能 教會它如何可靠地選擇這些工具: 路由精確的卡鍵,如 DEV-938 直接向 Kanera 傳送,對於支援的工作,首選 MCP 而非瀏覽器自動化,將名稱解析為穩定 ID,在報告或更改工作之前讀取實時狀態,使用等效金鑰,並安全處理許可權或速率限制故障。
使用開啟的 Agent Skills 安裝程式全域性安裝技能:
npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera --yes --global
要進行手動安裝,請下載完整的 kanera 技能目錄,包括 SKILL.md 以及 agents/openai.yaml，並將其放置在以下位置之一：
~/.agents/skills/kanera/跨專案的個人技能。.agents/skills/kanera/將技能與該專案共享。
Codex 如果它不出現,請重新啟動您的電腦。 Codex. 提及 $kanera 在提示中明確地強制載入,或者讓 Codex 為 Kanera 工作自動選擇它。
使用 /apps 附加Kanera應用程式, /plugins 檢查 Kanera 外掛和捆綁技能是否可用,以及 /mcp verbose 確認工具連線。 例如:
$kanera Update DEV-938 with the investigation findings and agreed implementation plan.
Codex 應該讀那張卡透過 cards.get 並透過以下步驟應用所請求的更改:
cards.update。它應該僅為 MCP 未公開的顯式可視任務或管理操作開啟 Kanera Web 介面。
例外:使用 API 金鑰連線
:::警告 儘可能使用 OAuth API 金鑰是您自己儲存和輪換的長期秘密，並且使用個人金鑰完成的工作會記錄為您，而無需 透過 <代理人> 只有在 OAuth 真正無法工作時才使用一個標籤:
- 您的 Codex 版本無法完成遠端 OAuth 流程。
- 您需要一個本地 stdio 伺服器,不能使用 Kanera CLI.
kanera auth login使用 OAuth 登入,並且kanera mcp使用該登入服務 stdio,無需金鑰。 - 計算機沒有用於登入的瀏覽器。 嘗試 裝置授權 首先,如果你的客戶端支援它。
當您使用金鑰時,請建立它 只讀 除非代理必須更改工作,並將其儲存在環境變數中而不是提交的檔案中。 : : :
替換 kanera_live_... 從一個私人金鑰 配置檔案設定 -> API 金鑰 或者從下面的工作區鍵 工作區設定 -> API，並設定 KANERA_PUBLIC_API_URL 至 https://api.kanera.app。對於個人 Codex 設定，個人金鑰通常是合適的選擇，因為它遵循您自己的跨工作區的板訪問許可權。
ChatGPT 桌面應用程式
開放 設定 -> MCP 伺服器，然後選擇 新增伺服器。您可以在那裡新增本地 stdio 伺服器，或編輯 config.toml 儲存伺服器並選擇"伺服器"選項。 重新啟動.
新增 Kanera 後，開始新對話並確認其工具可用。
配置檔案(應用程式、CLI 和 IDE 擴充套件)
Codex 儲存使用者級 MCP 伺服器 ~/.codex/config.toml。新增一個 [mcp_servers.kanera] 為本地 stdio 伺服器建立一個表,該表執行 Kanera CLI 作為伺服器(Node 22 或更高版本 ) 。 kanera auth login，你可以省略 env; kanera mcp 重用儲存的憑據。
[mcp_servers.kanera]
command = "npx"
args = ["-y", "@kanera/cli", "mcp"]
env = { KANERA_API_KEY = "kanera_live_...", KANERA_PUBLIC_API_URL = "https://api.kanera.app" }
對於具有靜態 API 金鑰的託管 HTTP 伺服器,請將金鑰儲存在環境變數中,而不是將其寫入檔案:
[mcp_servers.kanera]
url = "https://mcp.kanera.app/mcp"
bearer_token_env_var = "KANERA_API_KEY"
集合 KANERA_API_KEY 在啟動 Codex 的環境中,然後重新啟動應用、CLI 或 IDE 擴充套件。
命令列
或者從命令列新增它:
codex mcp add kanera \
--env KANERA_API_KEY=kanera_live_... \
--env KANERA_PUBLIC_API_URL=https://api.kanera.app \
-- npx -y @kanera/cli mcp
在桌面應用程式中,返回到 設定 -> MCP 伺服器 在 IDE 擴充套件中,使用齒輪選單並選擇"連線"按鈕。 MCP伺服器.