为 Kanera MCP 设置 GitHub Copilot
通过 GitHub Copilot 在 VS 代码中连接到 Kanera 模型上下文协议。本指南涵盖 VS Code 桌面应用程序； Copilot CLI 和 GitHub.com 编码代理使用不同的 MCP 配置位置。
您需要访问 GitHub Copilot 和 VS Code 1.99 或更高版本。 如果 Copilot 来自商业或企业组织,其管理员必须启用 Copilot 中的 MCP 服务器 政策。
使用 OAuth 连接(推荐)
对于远程连接,添加 Kanera 的 MCP 地址并在浏览器中进行身份验证,无需创建或存储 API 密钥。
-
运行 MCP:添加服务器 从命令调色板中,选择 HTTP，输入
https://mcp.kanera.app/mcp，命名它kanera，并将其保存到您的用户配置文件中。或者，运行 MCP:开放用户配置 并手动添加 Kanera,或创建.vscode/mcp.json当前工作区的设置 -
要进行手动配置,请将 Kanera 添加为远程 HTTP 服务器:
{"servers": {"kanera": {"type": "http","url": "https://mcp.kanera.app/mcp"}}} -
启动服务器并确认您信任其配置。 VS Code 检测到 OAuth 要求并打开浏览器身份验证流程;如果内联操作显示 授权，选择它。
-
登录到 Kanera,查看请求的访问权限,然后选择 允许访问.
-
运行 MCP: 列表服务器 确认 Kanera 已连接。 打开 Copilot 聊天 代理 模式,并确认 Kanera 工具在工具选择器中显示。
海 连接 AI 代理 用于作用域和断开代理。
安装 Kanera 技能
MCP 连接可让 Copilot 访问 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/或~/.copilot/skills/kanera/跨项目的个人技能。.agents/skills/kanera/或.github/skills/kanera/将技能与该项目共享。
在 Copilot 聊天中,使用 /skills 当请求涉及到 Kanera 时,Copilot 可以自动加载它,或者您可以调用 kanera 技能明确。
例外:使用 API 密钥连接
:::警告 尽可能使用 OAuth API 密钥是您自己存储和轮换的长期秘密，并且使用个人密钥完成的工作会记录为您，而无需 通过 <代理人> 只有在 OAuth 真正无法工作时才使用一个标签:
- 您的 VS Code 设置无法完成远程 OAuth 流程。
- 您需要一个本地 stdio 服务器,不能使用 Kanera CLI.
kanera auth login使用 OAuth 登录,并且kanera mcp使用该登录服务 stdio,无需密钥。 - 计算机没有用于登录的浏览器。 尝试 设备授权 首先,如果你的客户端支持它。
当您使用密钥时,请创建它 只读 除非代理必须更改工作,并将其保存在环境变量中而不是提交的文件中。 : : :
替换 kanera_live_... 从一个私人密钥 配置文件设置 -> API 密钥 或者从下面的工作区键 工作区设置 -> API，并设置 KANERA_PUBLIC_API_URL 至 https://api.kanera.app。对于个人 VS Code 设置，个人密钥通常是合适的选择，因为它遵循您自己的跨工作区的板访问权限。
VS Code 桌面应用程序
GitHub 副驾驶读 MCP 从一个服务器 .vscode/mcp.json 要在项目中提供个人配置,请运行 MCP:开放用户配置 从命令调色板中选择并编辑用户 mcp.json 档案
对于本地 stdio 服务器,运行 Kanera CLI 作为服务器(Node 22 或更高版本 ) 。 kanera auth login，你可以省略 env; kanera mcp 重用存储的凭据。
{
"servers": {
"kanera": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@kanera/cli", "mcp"],
"env": {
"KANERA_API_KEY": "kanera_live_...",
"KANERA_PUBLIC_API_URL": "https://api.kanera.app"
}
}
}
}
对于具有静态 API 密钥的远程 HTTP 端点:
{
"servers": {
"kanera": {
"type": "http",
"url": "https://mcp.kanera.app/mcp",
"headers": {
"Authorization": "Bearer kanera_live_..."
}
}
}
}
使用工具
打开 Copilot 聊天视图,切换到 代理 服务器启动后,Kanera 工具将出现在工具选择器中。
请不要提交 API 密钥 .vscode/mcp.json。将个人配置放入用户级文件中，或使用 VS Code 的输入变量支持，以便请求密钥而不是存储在存储库中。