Pular para o conteúdo principal

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.

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:

  1. No aplicativo Antigravity, abra Customizations -> Installed. Em MCP Servers, escolha Autenticar ao lado do Kanera.
  2. Faça login no Kanera no navegador, revise o acesso solicitado e escolha Permitir acesso.
  3. 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​

Use OAuth sempre que puder

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 login faz login com OAuth e kanera mcp serve 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.

Referência do cliente​