Pular para o conteúdo principal

Configure o OpenCode para Kanera MCP

OpenCode se conecta ao Kanera através do Protocolo de Contexto do Modelo. Ele oferece suporte à descoberta automática de OAuth e ao registro dinâmico de clientes para servidores MCP remotos, portanto, nenhum cliente pré-registrado ou chave de API é necessário.

Adicione Kanera à sua configuração OpenCode:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kanera": {
      "type": "remote",
      "url": "https://mcp.kanera.app/mcp",
      "enabled": true
    }
  }
}

OpenCode inicia o OAuth automaticamente quando Kanera precisa de autenticação pela primeira vez. Você também pode iniciar o fluxo do navegador explicitamente:

opencode mcp auth kanera

Faça login no Kanera, revise o acesso solicitado e escolha Permitir acesso. Corre opencode mcp list para verificar a conexão. Se a descoberta ou autenticação falhar, use opencode mcp debug kanera para inspecionar o fluxo.

Veja Conecte um agente de IA para escopos e desconectar um agente.

Instale a habilidade Kanera​

A conexão MCP dá ao OpenCode acesso à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 ~/.config/opencode/skills/kanera/ para uma habilidade pessoal disponível em todos os projetos.
  • .agents/skills/kanera/ ou .opencode/skills/kanera/ em um repositório para compartilhar a habilidade com esse projeto.

O OpenCode lista a habilidade para seus agentes e carrega as instruções completas quando relevante. Se você restringir ferramentas ou habilidades por meio de permissões OpenCode, certifique-se de que o skill ferramenta e o kanera_* As ferramentas MCP não são negadas.

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 versão do OpenCode não pode concluir o fluxo OAuth remoto.
  • 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. :::

Faça referência a uma variável de ambiente em vez de armazenar a chave na configuração:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kanera": {
      "type": "remote",
      "url": "https://mcp.kanera.app/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env: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.

Referência do cliente​