跳转到主要内容

为 Kanera MCP 设置 Antigravity

Google Antigravity 通过 模型上下文协议。它支持带有 OAuth 发现和动态客户端注册的远程 Streamable HTTP 服务器,因此不需要预先注册客户端或 API 密钥。同一配置适用于 Antigravity 应用、IDE 和 Antigravity CLI。

将 Kanera 添加到你的全局 Antigravity MCP 配置 ~/.gemini/config/mcp_config.json,或者当连接只应在某个项目中可用时,添加到该项目的 .agents/mcp_config.json 中:

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

如果文件中已列出其他服务器,请将 kanera 条目添加到现有的 mcpServers 对象中。在 IDE 中,你可以从代理侧边栏打开此文件:选择 … -> MCP Servers -> Manage MCP Servers -> View raw config.

然后进行身份验证:

  1. 在 Antigravity 应用中,打开 Customizations -> Installed。在 MCP Servers,选择 进行身份验证 旁边的 Kanera。
  2. 在浏览器中登录到 Kanera,查看请求的访问权限,然后选择 允许访问.
  3. 复制 Antigravity 显示的授权码,将其粘贴到 Enter authorization code,并选择 Submit.

Antigravity 会在令牌过期时自动刷新并重新连接到 Kanera。在 Antigravity CLI 中,输入 /mcp 打开 MCP 管理器,检查 Kanera 是否已连接,并查看其连接日志。

Antigravity 在运行没有权限规则的 MCP 工具之前会先询问。要让它无需每次询问即可使用 Kanera 的工具,请将 mcp(kanera/*) 添加到你的 Antigravity 权限中。无论客户端允许什么,Kanera 仍会在每次请求时检查你在每个看板上的角色以及你组织的 AI代理政策 。

参见 连接 AI 代理 了解作用域以及如何断开代理。

安装 Kanera 技能​

MCP 连接让 Antigravity 能够访问 Kanera 的工具。可选的 Kanera 代理技能 可以教它把名称解析为稳定的 ID、在汇报或更改工作之前读取实时状态、区分已完成的工作和创建活动、使用幂等键,并安全地处理权限或速率限制失败。

使用开放的 Agent Skills 安装程序全局安装该技能:

npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera -a antigravity --yes --global

要进行手动安装,请下载完整的 kanera 技能目录,并将其放在以下位置之一:

  • ~/.gemini/config/skills/kanera/ 用作可跨项目使用的个人技能。
  • .agents/skills/kanera/ 放在仓库中,可与该项目共享该技能。

Antigravity 会向其代理展示该技能,并在请求相关时加载完整说明。你也可以在提示中指明该技能,或者输入 /kanera (在应用或 CLI 中)。在 CLI 中,运行 /skills reload (如果你在会话期间添加了该技能)。

例外:使用 API 密钥连接​

尽可能使用 OAuth

API 密钥是需要你自行保管和轮换的长期机密,使用个人密钥完成的工作会记录为你本人,且不带 通过 <代理人> 标签。只有在 OAuth 确实无法使用时才使用密钥:

  • 你的 Antigravity 版本无法完成远程 OAuth 流程。
  • 你需要一个本地 stdio 服务器,不能使用 Kanera CLI. kanera auth login 使用 OAuth 登录,而 kanera mcp 使用该登录凭据提供 stdio 服务,无需密钥。
  • 该机器没有可用于登录的浏览器。请首先尝试 设备授权 (如果你的客户端支持)。

使用密钥时,请将其创建为 只读 ,除非代理必须更改工作。

Antigravity 会按原样发送标头值,因此密钥会存储在配置文件本身中。请使用全局 ~/.gemini/config/mcp_config.json 而不是项目文件,并且切勿提交它:

{
"mcpServers": {
"kanera": {
"serverUrl": "https://mcp.kanera.app/mcp",
"headers": {
"Authorization": "Bearer YOUR_KANERA_API_KEY"
}
}
}
}

个人密钥创建于 个人资料设置 -> API 密钥 ,工作区密钥创建于 工作区设置 -> API.

客户端参考​