为 Kanera MCP 设置光标

光标通过连接到Kanera 模型上下文协议。 Cursor 支持具有 OAuth 的远程可流式 HTTP 服务器，因此您可以通过浏览器进行连接，而无需创建或存储 API 密钥。

使用 OAuth 连接(推荐)

一键安装

安装 Cursor 后,打开此链接,一步将 Kanera 添加到 Cursor:

光标显示即将添加的服务器 (https://mcp.kanera.app/mcp）并要求您确认。然后完成如下所述的浏览器登录。如果链接未打开 Cursor，或者您自行托管 Kanera，请改为手动添加配置。的 MCP配置生成器还为自托管地址构建链接。

手动配置

Kanera 显示此配置,并在下方填入您的 MCP 地址 配置文件设置 -> API 密钥 -> 或手动配置 -> 光标.

将 Kanera 添加到您的全局 Cursor MCP 配置中： ~/.cursor/mcp.json，或到 .cursor/mcp.json 当连接只应该在项目中可用时:

{
  "mcpServers": {
    "kanera": {
      "url": "https://mcp.kanera.app/mcp"
    }
  }
}

Cursor 检测到 Kanera 需要 OAuth 并要求您进行身份验证。在 Cursor Agent 中,您可以显式启动浏览器流:

cursor-agent mcp login kanera

登录到 Kanera,查看请求的访问权限,然后选择 允许访问。然后验证连接和可用工具：

cursor-agent mcp list
cursor-agent mcp list-tools kanera

在光标编辑器中,打开 设置 -> 工具和 MCP 检查服务器及其工具。参见连接 AI 代理用于作用域和断开代理。

安装 Kanera 技能

MCP 连接可让 Cursor 访问 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/ 或 ~/.cursor/skills/kanera/ 跨项目的个人技能。
.agents/skills/kanera/ 或 .cursor/skills/kanera/ 将技能与该项目共享。

如果技能不出现,请重新启动 Cursor。 Cursor 可以在相关请求时自动加载技能,或者您可以调用 /kanera 明确地。

例外:使用 API 密钥连接

:::警告尽可能使用 OAuth API 密钥是您自己存储和轮换的长期秘密，并且使用个人密钥完成的工作会记录为您，而无需 通过 <代理人> 只有在 OAuth 真正无法工作时才使用一个标签:

您的 Cursor 版本无法完成远程 OAuth 流程。
您需要一个本地 stdio 服务器,不能使用 Kanera CLI. kanera auth login 使用 OAuth 登录,并且 kanera mcp 使用该登录服务 stdio,无需密钥。
计算机没有用于登录的浏览器。尝试设备授权首先,如果你的客户端支持它。

当您使用密钥时,请创建它只读除非代理必须更改工作,并将其保存在环境变量中而不是提交的文件中。 : : :

从环境变量读取密钥,而不是将其提交到项目配置:

{
  "mcpServers": {
    "kanera": {
      "url": "https://mcp.kanera.app/mcp",
      "headers": {
        "Authorization": "Bearer ${env:KANERA_API_KEY}"
      }
    }
  }
}

集合 KANERA_API_KEY 在启动 Cursor 的环境中创建私钥。 配置文件设置 -> API 密钥 或者一个工作区键 工作区设置 -> API.

客户参考

光标的当前 MCP 指南

使用 OAuth 连接(推荐)​

一键安装​

手动配置​

安装 Kanera 技能​

例外:使用 API 密钥连接​

客户参考​