Saltar al contenido principal

Configurar OpenCode para Kanera MCP

OpenCode se conecta a Kanera a través del Protocolo de contexto modelo. Admite el descubrimiento automático de OAuth y el registro dinámico de clientes para servidores MCP remotos, por lo que no se requiere ningún cliente registrado previamente ni clave API.

Agregue Kanera a su configuración de OpenCode:

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

OpenCode inicia OAuth automáticamente cuando Kanera necesita autenticación por primera vez. También puedes iniciar el flujo del navegador explícitamente:

opencode mcp auth kanera

Inicie sesión en Kanera, revise el acceso solicitado y elija Permitir acceso. correr opencode mcp list para comprobar la conexión. Si el descubrimiento o la autenticación fallan, utilice opencode mcp debug kanera para inspeccionar el flujo.

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

Instalar la habilidad Kanera​

La conexión MCP le da acceso a OpenCode a las herramientas de Kanera. el opcional Habilidad del agente Kanera le enseña a resolver nombres en ID estables, leer el estado en vivo antes de informar o cambiar el trabajo, distinguir el trabajo completado de la actividad de creación, 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 ~/.config/opencode/skills/kanera/ para una habilidad personal disponible en todos los proyectos.
  • .agents/skills/kanera/ o .opencode/skills/kanera/ en un repositorio para compartir la habilidad con ese proyecto.

OpenCode enumera la habilidad a sus agentes y carga sus instrucciones completas cuando sea relevante. Si restringe herramientas o habilidades a través de permisos OpenCode, asegúrese de que skill herramienta y el kanera_* No se niegan las herramientas MCP.

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:

  • Su versión de OpenCode no puede completar el flujo OAuth remoto.
  • 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. :::

Haga referencia a una variable de entorno en lugar de almacenar la clave en la configuración:

{
  "$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}"
      }
    }
  }
}

Crear una clave personal en Configuración de perfil -> Claves API o una clave de espacio de trabajo en Configuración del espacio de trabajo -> API.

Referencia del cliente​