为 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服务器.