Configurar Gemini CLI para Kanera MCP

Gemini CLI se conecta ao Kanera através do Protocolo de Contexto do Modelo. Ele oferece suporte a servidores HTTP remotos, descoberta automática de OAuth, registro dinâmico de cliente e atualização de token.

Conecte-se com OAuth (recomendado)

Adicione Kanera como servidor HTTP remoto:

gemini mcp add --scope user --transport http kanera https://mcp.kanera.app/mcp

Inicie o Gemini CLI e autentique a partir do prompt interativo:

/mcp auth kanera

Gemini CLI abre Kanera em seu navegador. Faça login, revise o acesso solicitado e escolha Permitir acesso. Corre gemini mcp list do seu shell para verificar se o servidor está conectado ou use /mcp dentro do Gemini CLI para inspecioná-lo.

Você também pode configurar o Kanera diretamente na CLI do Gemini settings.json:

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

O OAuth interativo requer um navegador local e um retorno de chamada localhost. Em um ambiente headless ou remoto que não pode concluir esse retorno de chamada, use autorização do dispositivo se o seu cliente suportar a concessão de dispositivo ou recorrer uma chave de API. Veja Conecte um agente de IA para escopos e desconectar um agente.

Instale a habilidade Kanera

A conexão MCP dá ao Gemini acesso CLI às ferramentas do Kanera. O opcional Habilidade do agente Kanera ensina-o a resolver nomes para IDs estáveis, ler o estado ativo 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 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 --yes --global

Para uma instalação manual, baixe o arquivo completo kanera diretório de habilidades e coloque-o em um destes locais:

• ~/.agents/skills/kanera/ ou ~/.gemini/skills/kanera/ para uma habilidade pessoal disponível em todos os projetos.
• .agents/skills/kanera/ ou .gemini/skills/kanera/ em um repositório para compartilhar a habilidade com esse projeto.

Execução /skills list dentro do Gemini CLI para verificar se a habilidade está disponível e /skills reload depois de alterá-lo. Gemini CLI pede confirmação quando ativa uma habilidade.

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 armazena e alterna, e o trabalho realizado com uma chave pessoal é registrado como você, sem o via <agente> rótulo. Use um somente quando o OAuth realmente não funcionar:

• Seu ambiente Gemini CLI não pode concluir o retorno de chamada OAuth do host local.
• Você precisa de um servidor stdio local e não pode usar o Kanera CLI. kanera auth login faz login com OAuth e kanera mcp atende stdio com esse login, nenhuma chave é necessária.
• A máquina não possui navegador para login. Experimente autorização do dispositivo primeiro se o seu cliente suportar.

Quando você usa uma chave, crie-a Somente leitura a menos que o agente precise alterar o trabalho e mantê-lo em uma variável de ambiente em vez de em um arquivo confirmado. :::

Adicione um cabeçalho de autorização a settings.json que lê a chave do seu ambiente:

{
  "mcpServers": {
    "kanera": {
      "httpUrl": "https://mcp.kanera.app/mcp",
      "headers": {
        "Authorization": "Bearer $KANERA_API_KEY"
      }
    }
  }
}

Crie uma chave pessoal em Configurações de perfil -> Chaves de API ou uma chave de espaço de trabalho Configurações do espaço de trabalho -> API. Evite colocar a chave diretamente settings.json.

Referência do cliente

• Guia atual do servidor MCP do Gemini CLI