Pular para o conteúdo principal

Configure Claude para Kanera MCP

Claude na web, Claude Desktop e Claude Code podem se conectar ao Kanera através do Protocolo de Contexto do Modelo.

Claude e Claude Desktop: conecte-se com OAuth​

Kanera é um conector Claude publicado. Procure por Kanera sob Personalizar -> Conectores e selecione Conectar. Claude abre uma tela de login e consentimento do navegador; você não cria ou cola uma chave de API. Funciona em todos os planos Kanera hospedados, incluindo o Gratuito.

Se o conector publicado não estiver visível para a conta atual ou o espaço de trabalho, adicione o mesmo ponto final de produção como um conector personalizado:

  1. Abrir Personalizar -> Conectores.

  2. Selecione + -> Adicionar conector personalizado.

  3. Digite o endereço MCP de Kanera:

    https://mcp.kanera.app/mcp

  4. Selecione Adicionar, então Conectar.

Para uma organização Team ou Enterprise que restringe conectores, um Proprietário ou Proprietário Principal pode precisar ativar o Kanera em Configurações da organização -> Conectores antes que os membros possam conectá-lo.

Claude abre uma aba Kanera. Faça login, analise o que o agente pode fazer e escolha Permitir acesso. Habilite Kanera para uma conversa do + -> Conectores menu ao lado do compositor.

Gerencie ou desconecte o agente posteriormente de Configurações de perfil -> Chaves de API. Veja Conecte um agente de IA para obter detalhes. Se OAuth não for uma opção, consulte a exceção da chave API abaixo.

Código Claude: conecte-se com OAuth​

Quando o Claude Code estiver conectado com a mesma conta do Claude, execute primeiro claude mcp list. Se o conector Kanera publicado já estiver presente, inicie o Claude Code, digite /mcpe conecte-o ou autentique-o lá. Não adicione um servidor duplicado.

Se Kanera não estiver presente, adicione o servidor hospedado para seu usuário para que esteja disponível em todos os projetos:

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

Inicie o Claude Code e digite /mcp. Selecione Kanera e conclua o fluxo de autenticação do navegador. Corre claude mcp list para confirmar isso relata Conectado.

Substituição somente do Shell​

Se um agente puder executar comandos shell, mas não puder usar o MCP, instale a CLI do Kanera em vez de automatizar a interface da web:

npx -y @kanera/cli commands          # inspect it without a global install
npm install --global @kanera/cli     # persistent command; requires Node 22+
kanera auth login
kanera setup claude --global
kanera whoami --json

A CLI expõe a mesma camada de ferramenta Kanera. kanera auth login faz login através do seu navegador com OAuth, da mesma forma que o conector faz, portanto não há chave para criar; usar --with-api-key para um agente autônomo. Prefira o conector publicado quando estiver disponível, pois não precisa de instalação.

Instale a habilidade Kanera​

A conexão MCP dá a Claude acesso às ferramentas de Kanera. O opcional Habilidade do agente Kanera ensina a resolver nomes para IDs estáveis, ler o estado atual antes de relatar ou alterar o trabalho, usar chaves de idempotência e lidar com falhas com segurança.

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

Reinicie Claude se a habilidade não aparecer. Claude pode carregá-lo automaticamente para trabalhos relevantes ou você pode invocá-lo explicitamente.

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:
  • Sua configuração do Claude não pode usar o conector publicado ou um conector personalizado com OAuth.
  • 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. :::

Substituir kanera_live_... com uma chave pessoal de Configurações de perfil -> Chaves de API ou uma chave de espaço de trabalho de Configurações do espaço de trabalho -> API. Para uma configuração pessoal do Claude, uma chave pessoal geralmente é a opção certa porque segue o acesso do seu próprio quadro em todos os espaços de trabalho.

Configurações de API do espaço de trabalho onde uma chave de API do espaço de trabalho pode ser criada para Kanera MCP.

Código Claude​

Para o endpoint HTTP hospedado com uma chave estática:

claude mcp add --transport http kanera --scope user https://mcp.kanera.app/mcp \
  --header "Authorization: Bearer kanera_live_..."

Para um servidor stdio local, execute o Kanera CLI como o servidor:

claude mcp add kanera --scope user \
  --env KANERA_API_KEY=kanera_live_... \
  --env KANERA_PUBLIC_API_URL=https://api.kanera.app \
  -- npx -y @kanera/cli mcp

Se você já correu kanera auth login, solte ambos --env bandeiras; kanera mcp reutiliza a credencial armazenada. Corre claude mcp list para confirmar que o servidor está conectado.

Claude Desktop​

Abrir Configurações -> Desenvolvedor -> Editar configuração, que abre claude_desktop_config.jsone adicione o servidor em mcpServers:

{
  "mcpServers": {
    "kanera": {
      "command": "npx",
      "args": ["-y", "@kanera/cli", "mcp"],
      "env": {
        "KANERA_API_KEY": "kanera_live_...",
        "KANERA_PUBLIC_API_URL": "https://api.kanera.app"
      }
    }
  }
}

Reinicie o Claude Desktop após salvar, abra uma nova conversa e confirme se as ferramentas Kanera estão disponíveis. Esta configuração executa o servidor localmente por meio do stdio e precisa do Nó 22 ou posterior.

Se você já configurou o Kanera no Claude Desktop e posteriormente instalou o Claude Code, o Claude Code pode importar a configuração do desktop com:

claude mcp add-from-claude-desktop

Este comando de importação está disponível no macOS e no Windows Subsystem for Linux (WSL).

Referências de clientes​