为 Kanera MCP 设置 Gemini CLI
Gemini CLI 通过以下链接连接到 Kanera 模型上下文协议。它支持远程 HTTP 服务器、自动 OAuth 发现、动态客户端注册和令牌刷新。
使用 OAuth 连接(推荐)
添加 Kanera 作为远程 HTTP 服务器：
gemini mcp add --scope user --transport http kanera https://mcp.kanera.app/mcp
启动 Gemini CLI,然后从交互式提示符进行身份验证:
/mcp auth kanera
双子座 CLI 开幕 Kanera 登录,查看请求的访问权限,然后选择"登录"按钮。 允许访问。运行 gemini mcp list 从你的 shell 验证服务器是否连接,或者使用 /mcp 双子座CLI内部检查它。
您也可以直接在Gemini CLI中配置Kanera settings.json:
{
"mcpServers": {
"kanera": {
"httpUrl": "https://mcp.kanera.app/mcp"
}
}
}
交互式 OAuth 需要本地浏览器和 localhost 回调。 在无头或远程环境中,如果无法完成该回调,请使用 设备授权 如果您的客户端支持设备授权,或回归到 API 密钥。参见 连接 AI 代理 用于作用域和断开代理。
安装 Kanera 技能
MCP 连接可让 Gemini CLI 访问 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/或~/.gemini/skills/kanera/跨项目的个人技能。.agents/skills/kanera/或.gemini/skills/kanera/将技能与该项目共享。
运行 /skills list Gemini CLI 内部验证技能是否可用,并且 /skills reload Gemini CLI 在激活技能时会要求确认。
例外:使用 API 密钥连接
:::警告 尽可能使用 OAuth API 密钥是您自己存储和轮换的长期秘密，并且使用个人密钥完成的工作会记录为您，而无需 通过 <代理人> 只有在 OAuth 真正无法工作时才使用一个标签:
- 您的 Gemini CLI 环境无法完成 localhost OAuth 回调。
- 您需要一个本地 stdio 服务器,不能使用 Kanera CLI.
kanera auth login使用 OAuth 登录,并且kanera mcp使用该登录服务 stdio,无需密钥。 - 计算机没有用于登录的浏览器。 尝试 设备授权 首先,如果你的客户端支持它。
当您使用密钥时,请创建它 只读 除非代理必须更改工作,并将其保存在环境变量中而不是提交的文件中。 : : :
添加授权标头 settings.json 从您的环境中读取密钥:
{
"mcpServers": {
"kanera": {
"httpUrl": "https://mcp.kanera.app/mcp",
"headers": {
"Authorization": "Bearer $KANERA_API_KEY"
}
}
}
}
创建一个私钥 配置文件设置 -> API 密钥 或者一个工作区键 工作区设置 -> API。避免将钥匙直接插入 settings.json.