为 Kanera MCP 设置 Antigravity
Google Antigravity 通过 模型上下文协议。它支持带有 OAuth 发现和动态客户端注册的远程 Streamable HTTP 服务器,因此不需要预先注册客户端或 API 密钥。同一配置适用于 Antigravity 应用、IDE 和 Antigravity CLI。
使用 OAuth 连接(推荐)
将 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.
然后进行身份验证:
- 在 Antigravity 应用中,打开 Customizations -> Installed。在 MCP Servers,选择 进行身份验证 旁边的 Kanera。
- 在浏览器中登录到 Kanera,查看请求的访问权限,然后选择 允许访问.
- 复制 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 密钥连接
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.