Saltar al contenido principal

Configurar GitHub Copilot para Kanera MCP

GitHub Copilot en VS Code se conecta a Kanera a través del Protocolo de contexto modelo. Esta guía cubre la aplicación de escritorio VS Code; Copilot CLI y el agente de codificación de GitHub.com utilizan diferentes ubicaciones de configuración de MCP.

Necesita acceso a GitHub Copilot y VS Code 1.99 o posterior. Si Copilot proviene de una organización Business o Enterprise, su administrador debe habilitar la Servidores MCP en Copilot política.

Para una conexión remota, agregue la dirección MCP de Kanera y autentíquese en su navegador. No es necesario crear ni almacenar una clave API.

  1. Ejecución MCP: Agregar servidor en la paleta de comandos, elija HTTP, entrar https://mcp.kanera.app/mcp, nómbralo kaneray guárdelo en su perfil de usuario. Alternativamente, ejecute MCP: Abrir configuración de usuario y agregue Kanera manualmente, o cree .vscode/mcp.json para el espacio de trabajo actual.

  2. Para la configuración manual, agregue Kanera como servidor HTTP remoto:

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

  3. Inicie el servidor y confirme que confía en su configuración. VS Code detecta el requisito de OAuth y abre el flujo de autenticación del navegador; si las acciones en línea muestran autenticación, selecciónelo.

  4. Inicie sesión en Kanera, revise el acceso solicitado y elija Permitir acceso.

  5. Ejecución MCP: servidores de lista para confirmar que Kanera está conectada. Abrir chat de copiloto en Agente modo y confirme que las herramientas de Kanera aparecen en el selector de herramientas.

Ver Conecte un agente de IA para alcances y desconectar un agente.

Instalar la habilidad Kanera​

La conexión MCP le da a Copilot acceso a las herramientas de Kanera. el opcional Habilidad del agente Kanera le enseña cómo usar esas herramientas de manera confiable: resolver nombres en ID estables, leer el estado en vivo antes de informar o cambiar el trabajo, distinguir el trabajo completado del trabajo recién creado, usar claves de idempotencia y manejar fallas de permisos o límites de velocidad de manera segura.

Instale la habilidad globalmente con el instalador abierto de Agent Skills:

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

Para una instalación manual, descargue el archivo completo kanera directorio de habilidades y colóquelo en una de estas ubicaciones:

  • ~/.agents/skills/kanera/ o ~/.copilot/skills/kanera/ para una habilidad personal disponible en todos los proyectos.
  • .agents/skills/kanera/ o .github/skills/kanera/ en un repositorio para compartir la habilidad con ese proyecto.

En Copilot Chat, utilice /skills para confirmar que la habilidad está disponible. Copilot puede cargarlo automáticamente cuando una solicitud involucra a Kanera, o puede invocar el kanera habilidad explícitamente.

Excepción: conectarse con una clave API​

:::precaución Utilice OAuth siempre que pueda Una clave API es un secreto de larga duración que usted mismo almacena y rota, y el trabajo realizado con una clave personal se registra como usted, sin la a través de <agente> etiqueta. Utilice uno sólo cuando OAuth realmente no pueda funcionar:

  • La configuración de VS Code no puede completar el flujo remoto de OAuth.
  • Necesita un servidor stdio local y no puede usar el Kanera CLI. kanera auth login inicia sesión con OAuth y kanera mcp sirve stdio con ese inicio de sesión, no se requiere clave.
  • La máquina no tiene un navegador para iniciar sesión. Pruebe autorización del dispositivo primero si su cliente lo admite.

Cuando uses una clave, créala Sólo lectura a menos que el agente deba cambiar el trabajo y mantenerlo en una variable de entorno en lugar de en un archivo confirmado. :::

Reemplazar kanera_live_... con una clave personal de Configuración de perfil -> Claves API o una clave de espacio de trabajo de Configuración del espacio de trabajo -> APIy establecer KANERA_PUBLIC_API_URL a https://api.kanera.app. Para una configuración personal de VS Code, una clave personal suele ser la opción adecuada porque sigue el acceso a su propio tablero en todos los espacios de trabajo.

Configuración de la API del espacio de trabajo donde se puede crear una clave API del espacio de trabajo para Kanera MCP.

Aplicación de escritorio VS Code​

GitHub Copilot lee servidores MCP desde un .vscode/mcp.json archivo en su espacio de trabajo. Para una configuración personal disponible en todos los proyectos, ejecute MCP: Abrir configuración de usuario desde la paleta de comandos y edite el usuario mcp.json archivo.

Para un servidor stdio local, ejecute el Kanera CLI como servidor (Nodo 22 o posterior). Si ya corriste kanera auth login, puedes omitir env; kanera mcp reutiliza la credencial almacenada.

{
  "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 un punto final HTTP remoto con una clave API estática:

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

Usa las herramientas​

Abra la vista Copilot Chat, cambie a Agente modo, y las herramientas de Kanera aparecen en el selector de herramientas una vez que se inicia el servidor.

No confirme una clave API en .vscode/mcp.json. Coloque la configuración personal en el archivo de nivel de usuario o utilice el soporte de variables de entrada de VS Code para que se solicite el secreto en lugar de almacenarlo en el repositorio.

Referencias de clientes​