Configurar o Antigravity para o Kanera MCP
O Google Antigravity se conecta ao Kanera por meio do Model Context Protocol. Ele oferece suporte a servidores HTTP Streamable remotos com descoberta de OAuth e registro dinâmico de clientes, portanto não é necessário nenhum cliente pré-registrado nem chave de API. A mesma configuração funciona no aplicativo Antigravity, no IDE e no Antigravity CLI.
Conecte-se com OAuth (recomendado)
Adicione o Kanera à sua configuração global de MCP do Antigravity em ~/.gemini/config/mcp_config.json, ou para .agents/mcp_config.json em um projeto quando a conexão só deveria estar disponível lá:
{
"mcpServers": {
"kanera": {
"serverUrl": "https://mcp.kanera.app/mcp"
}
}
}
Se o arquivo já listar outros servidores, adicione a entrada kanera dentro do objeto mcpServers existente. No IDE, você pode abrir este arquivo pelo painel lateral do agente: escolha … -> MCP Servers -> Manage MCP Servers -> View raw config.
Em seguida, autentique-se:
- No aplicativo Antigravity, abra Customizations -> Installed. Em MCP Servers, escolha Autenticar ao lado do Kanera.
- Faça login no Kanera no navegador, revise o acesso solicitado e escolha Permitir acesso.
- Copie o código de autorização que o Antigravity mostra, cole-o em Enter authorization code, e escolha Submit.
O Antigravity se reconecta ao Kanera e renova o token automaticamente quando ele expira. No Antigravity CLI, digite /mcp para abrir o gerenciador de MCP, verificar se o Kanera está conectado e ler os logs de conexão.
O Antigravity pede confirmação antes de executar uma ferramenta MCP que não tenha regra de permissão. Para que ele use as ferramentas do Kanera sem perguntar toda vez, permita mcp(kanera/*) nas suas permissões do Antigravity. Independentemente do que o cliente permita, o Kanera continua verificando, a cada solicitação, sua função em cada quadro e a política de agentes de IA da sua organização.
Veja Conecte um agente de IA para ver os escopos e como desconectar um agente.
Instale a habilidade Kanera
A conexão MCP dá ao Antigravity acesso às ferramentas do Kanera. A opcional habilidade de agente do Kanera opcional ensina o agente a resolver nomes em IDs estáveis, ler o estado atual antes de relatar ou alterar o trabalho, distinguir o trabalho concluído da atividade de criação, usar chaves de idempotência e lidar com falhas de permissão ou de limite de taxa com segurança.
Instale a habilidade globalmente com o instalador aberto do Agent Skills:
npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera -a antigravity --yes --global
Para uma instalação manual, baixe o diretório completo da habilidade kanera e coloque-o em um destes locais:
~/.gemini/config/skills/kanera/para uma habilidade pessoal disponível em todos os projetos..agents/skills/kanera/em um repositório para compartilhar a habilidade com esse projeto.
O Antigravity mostra a skill ao seu agente e carrega as instruções completas quando uma solicitação é relevante. Você também pode citar a skill no seu prompt ou digitar /kanera no aplicativo ou na CLI. Na CLI, execute /skills reload se você adicionou a skill durante uma sessão.
Exceção: conecte-se com uma chave de API
Uma chave de API é um segredo de longa duração que você mesmo guarda e alterna, e o trabalho feito com uma chave pessoal é registrado em seu nome, sem o via <agente>. Use uma só quando o OAuth realmente não puder funcionar:
- Sua versão do Antigravity não consegue concluir o fluxo de OAuth remoto.
- Você precisa de um servidor stdio local e não pode usar a Kanera CLI.
kanera auth loginfaz login com OAuth ekanera mcpserve stdio com esse login, sem precisar de chave. - A máquina não tem navegador para o login. Tente autorização do dispositivo primeiro se o seu cliente suportar.
Quando for usar uma chave, crie-a como Somente leitura a menos que o agente precise alterar o trabalho.
O Antigravity envia os valores dos cabeçalhos exatamente como escritos, portanto a chave fica armazenada no próprio arquivo de configuração. Use o arquivo global ~/.gemini/config/mcp_config.json em vez de um arquivo de projeto, e nunca faça commit dele:
{
"mcpServers": {
"kanera": {
"serverUrl": "https://mcp.kanera.app/mcp",
"headers": {
"Authorization": "Bearer YOUR_KANERA_API_KEY"
}
}
}
}
Crie uma chave pessoal em Configurações de perfil -> Chaves de API ou uma chave de espaço de trabalho em Configurações do espaço de trabalho -> API.