为 Kanera MCP 设置 Claude
Claude on the web、Claude Desktop 和 Claude Code 可以通过以下方式连接到 Kanera: 模型上下文协议.
Claude 和 Claude Desktop: 使用 OAuth 连接
Kanera 是已发布的 Claude 连接器。 搜索 Kanera 下 自定义 -> 连接器 并选择 连接。 Claude 打开浏览器登录和同意屏幕；您不创建或粘贴 API 密钥。它适用于每个托管的 Kanera 计划，包括 Free。
如果已发布的连接器对于当前帐户或工作区不可见,请将相同的生产端点添加为自定义连接器:
-
开放 自定义 -> 连接器.
-
选择 + -> 添加自定义连接器.
-
输入 Kanera 的 MCP 地址:
https://mcp.kanera.app/mcp -
选择 添加，那么 连接.
对于限制连接器的团队或企业组织,所有者或主要所有者可能需要启用 Kanera 下 组织设置 -> 连接器 会员可以连接它之前。
Claude 打开 Kanera 选项卡。 登录,查看代理可以执行的操作,然后选择 允许访问。为对话启用 Kanera + -> 连接器 菜单，位于评论编辑框旁。
管理或稍后从中断开代理 配置文件设置 -> API 密钥。参见 连接 AI 代理 如果 OAuth 不是选项,请参阅 关于API密钥异常 下文。
Claude 代码: 与OAuth连接
当 Claude 代码与同一个 Claude 帐户登录时,首先运行 claude mcp list。如果已发布的 Kanera 连接器已存在，则启动 Claude 代码，输入 /mcp，并在那里连接或验证它。不要添加重复的服务器。
如果 Kanera 未存在,请为您的用户添加托管服务器,以便在项目之间可用:
claude mcp add --transport http kanera --scope user https://mcp.kanera.app/mcp
启动 Claude 代码并输入 /mcp。选择Kanera并完成浏览器身份验证流程。运行 claude mcp list 确认它报告 连接.
只用外壳的备用
如果代理可以运行 shell 命令但无法使用 MCP,请安装 Kanera CLI,而不是自动化 Web 界面:
npx -y @kanera/cli commands # inspect it without a global install
npm install --global @kanera/cli # persistent command; requires Node 22+
kanera auth login
kanera setup claude --global
kanera whoami --json
CLI 会公开相同的 Kanera 工具层。 kanera auth login 通过您的浏览器使用OAuth登录,与连接器的方式相同,因此无需创建密钥;使用 --with-api-key 当已发布的连接器可用时,应优先使用该连接器,因为它不需要安装。
安装 Kanera 技能
MCP 连接使 Claude 能够访问 Kanera 的工具。 Kanera 代理技能 教会它如何将名称解析为稳定的 ID,在报告或更改工作之前读取当前状态,使用等效密钥,并安全地处理故障。
npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera --yes --global
如果技能不出现,请重新启动 Claude 。 Claude 可以自动加载相关工作,或者您可以显式调用它。
例外:使用 API 密钥连接
:::警告 尽可能使用 OAuth API 密钥是您自己存储和轮换的长期秘密，并且使用个人密钥完成的工作会记录为您，而无需 通过 <代理人> 只有在 OAuth 真正无法工作时才使用一个标签:
- 您的 Claude 设置不能使用已发布的连接器或带有 OAuth 的自定义连接器。
- 您需要一个本地 stdio 服务器,不能使用 Kanera CLI.
kanera auth login使用 OAuth 登录,并且kanera mcp使用该登录服务 stdio,无需密钥。 - 计算机没有用于登录的浏览器。 尝试 设备授权 首先,如果你的客户端支持它。
当您使用密钥时,请创建它 只读 除非代理必须更改工作,并将其保存在环境变量中而不是提交的文件中。 : : :
替换 kanera_live_... 从一个私人密钥 配置文件设置 -> API 密钥 或者从下面的工作区键 工作区设置 -> API。对于个人 Claude 设置，个人密钥通常是合适的选择，因为它遵循您自己的跨工作区的板访问权限。
Claude 代码
对于具有静态密钥的托管 HTTP 端点:
claude mcp add --transport http kanera --scope user https://mcp.kanera.app/mcp \
--header "Authorization: Bearer kanera_live_..."
对于本地 stdio 服务器,运行 Kanera CLI 服务器:
claude mcp add kanera --scope user \
--env KANERA_API_KEY=kanera_live_... \
--env KANERA_PUBLIC_API_URL=https://api.kanera.app \
-- npx -y @kanera/cli mcp
如果你已经跑了 kanera auth login，同时删除 --env 旗帜； kanera mcp 重用存储的凭据。 运行 claude mcp list 确认服务器已连接。
Claude 桌面
开放 设置 -> 开发者 -> 编辑配置，打开 claude_desktop_config.json，并在下面添加服务器 mcpServers:
{
"mcpServers": {
"kanera": {
"command": "npx",
"args": ["-y", "@kanera/cli", "mcp"],
"env": {
"KANERA_API_KEY": "kanera_live_...",
"KANERA_PUBLIC_API_URL": "https://api.kanera.app"
}
}
}
}
保存后重新启动 Claude Desktop,然后打开新对话并确认 Kanera 工具可用。 此配置通过 stdio 在本地运行服务器,并需要 Node 22 或更高版本。
如果您已经在 Claude Desktop 中配置了 Kanera,并且稍后安装了 Claude Code,则 Claude Code 可以通过以下方式导入桌面配置:
claude mcp add-from-claude-desktop
此导入命令可在 macOS 和 Windows 子系统 for Linux (WSL) 上使用。