为 Kanera MCP 设置 OpenCode
连接到网络 Kanera 通过 模型上下文协议。它支持远程 MCP 服务器的自动 OAuth 发现和动态客户端注册，因此不需要预先注册客户端或 API 密钥。
使用 OAuth 连接(推荐)
将 Kanera 添加到您的 OpenCode 配置中：
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"kanera": {
"type": "remote",
"url": "https://mcp.kanera.app/mcp",
"enabled": true
}
}
}
OpenCode 在 Kanera 首次需要身份验证时会自动启动 OAuth。 您也可以显式启动浏览器流:
opencode mcp auth kanera
登录到 Kanera,查看请求的访问权限,然后选择 允许访问。运行 opencode mcp list 如果发现或身份验证失败,请使用 opencode mcp debug kanera 检查流量。
海 连接 AI 代理 用于作用域和断开代理。
安装 Kanera 技能
MCP 连接允许 OpenCode 访问 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/或~/.config/opencode/skills/kanera/跨项目的个人技能。.agents/skills/kanera/或.opencode/skills/kanera/将技能与该项目共享。
OpenCode 会向其代理列出技能,并在相关时加载完整的指令。 如果您通过 OpenCode 权限限制工具或技能,请确保 skill 工具和工具包 kanera_* MCP 工具不被拒绝。
例外:使用 API 密钥连接
:::警告 尽可能使用 OAuth API 密钥是您自己存储和轮换的长期秘密，并且使用个人密钥完成的工作会记录为您，而无需 通过 <代理人> 只有在 OAuth 真正无法工作时才使用一个标签:
- 您的 OpenCode 版本无法完成远程 OAuth 流程。
- 您需要一个本地 stdio 服务器,不能使用 Kanera CLI.
kanera auth login使用 OAuth 登录,并且kanera mcp使用该登录服务 stdio,无需密钥。 - 计算机没有用于登录的浏览器。 尝试 设备授权 首先,如果你的客户端支持它。
当您使用密钥时,请创建它 只读 除非代理必须更改工作,并将其保存在环境变量中而不是提交的文件中。 : : :
引用环境变量而不是在配置中存储密钥:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"kanera": {
"type": "remote",
"url": "https://mcp.kanera.app/mcp",
"oauth": false,
"headers": {
"Authorization": "Bearer {env:KANERA_API_KEY}"
}
}
}
}
创建一个私钥 配置文件设置 -> API 密钥 或者一个工作区键 工作区设置 -> API.