Pular para o conteúdo principal

Configurar o GitHub Copilot para Kanera MCP

GitHub Copilot no VS Code se conecta ao Kanera por meio do Protocolo de Contexto do Modelo. Este guia aborda o aplicativo de desktop VS Code; A CLI do Copilot e o agente de codificação GitHub.com usam locais de configuração de MCP diferentes.

Você precisa de acesso ao GitHub Copilot e ao VS Code 1.99 ou posterior. Se o Copilot vier de uma organização Business ou Enterprise, seu administrador deverá habilitar o Servidores MCP no Copilot política.

Para uma conexão remota, adicione o endereço MCP da Kanera e autentique em seu navegador. Você não precisa criar ou armazenar uma chave de API.

  1. Execução MCP: Adicionar servidor na paleta de comandos, escolha HTTP, entre https://mcp.kanera.app/mcp, dê um nome kanerae salve-o em seu perfil de usuário. Alternativamente, execute MCP: Abrir configuração do usuário e adicione Kanera manualmente ou crie .vscode/mcp.json para o espaço de trabalho atual.

  2. Para configuração manual, adicione Kanera como servidor HTTP remoto:

    {
      "servers": {
        "kanera": {
          "type": "http",
          "url": "https://mcp.kanera.app/mcp"
        }
      }
    }

  3. Inicie o servidor e confirme se você confia em sua configuração. O VS Code detecta o requisito OAuth e abre o fluxo de autenticação do navegador; se as ações embutidas mostrarem Autenticação, selecione-o.

  4. Faça login no Kanera, revise o acesso solicitado e escolha Permitir acesso.

  5. Execução MCP: listar servidores para confirmar que Kanera está conectado. Abra o Copilot Chat em Agente modo e confirme se as ferramentas Kanera aparecem no seletor de ferramentas.

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

Instale a habilidade Kanera​

A conexão MCP dá ao Copilot acesso às ferramentas do Kanera. O opcional Habilidade do agente Kanera ensina como usar essas ferramentas de maneira confiável: resolver nomes para IDs estáveis, ler o estado ativo antes de relatar ou alterar o trabalho, distinguir o trabalho concluído do trabalho recém-criado, 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 ~/.copilot/skills/kanera/ para uma habilidade pessoal disponível em todos os projetos.
  • .agents/skills/kanera/ ou .github/skills/kanera/ em um repositório para compartilhar a habilidade com esse projeto.

No Copilot Chat, use /skills para confirmar que a habilidade está disponível. O Copilot pode carregá-lo automaticamente quando uma solicitação envolve Kanera, ou você pode invocar o kanera habilidade 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:
  • A configuração do seu VS Code 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. :::

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 -> APIe definir KANERA_PUBLIC_API_URL para https://api.kanera.app. Para uma configuração pessoal do VS Code, 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.

Aplicativo de desktop VS Code​

GitHub Copilot lê servidores MCP de um .vscode/mcp.json arquivo em seu espaço de trabalho. Para uma configuração pessoal disponível em projetos, execute MCP: Abrir configuração do usuário na paleta de comandos e edite o usuário mcp.json arquivo.

Para um servidor stdio local, execute o Kanera CLI como o servidor (Nó 22 ou posterior). Se você já correu kanera auth login, você pode omitir env; kanera mcp reutiliza a credencial armazenada.

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

Para um endpoint HTTP remoto com uma chave de API estática:

{
  "servers": {
    "kanera": {
      "type": "http",
      "url": "https://mcp.kanera.app/mcp",
      "headers": {
        "Authorization": "Bearer kanera_live_..."
      }
    }
  }
}

Use as ferramentas​

Abra a visualização do Copilot Chat, alterne para Agente modo, e as ferramentas Kanera aparecem no seletor de ferramentas assim que o servidor é iniciado.

Não confirme uma chave de API em .vscode/mcp.json. Coloque a configuração pessoal no arquivo de nível de usuário ou use o suporte de variável de entrada do VS Code para que o segredo seja solicitado em vez de armazenado no repositório.

Referências de clientes​