Configurar Gemini CLI para Kanera MCP

Gemini CLI se conecta a Kanera a través del Protocolo de contexto modelo. Admite servidores HTTP remotos, descubrimiento automático de OAuth, registro dinámico de clientes y actualización de tokens.

Conéctese con OAuth (recomendado)

Agregue Kanera como servidor HTTP remoto:

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

Inicie Gemini CLI, luego autentíquese desde su mensaje interactivo:

/mcp auth kanera

Gemini CLI abre Kanera en su navegador. Inicie sesión, revise el acceso solicitado y elija Permitir acceso. correr gemini mcp list desde su shell para verificar que el servidor esté conectado, o use /mcp dentro de Gemini CLI para inspeccionarlo.

También puede configurar Kanera directamente en la CLI de Gemini settings.json:

{
  "mcpServers": {
    "kanera": {
      "httpUrl": "https://mcp.kanera.app/mcp"
    }
  }
}

OAuth interactivo requiere un navegador local y una devolución de llamada del host local. En un entorno remoto o sin cabeza que no puede completar esa devolución de llamada, use autorización del dispositivo si su cliente admite la concesión del dispositivo, o recurra a una clave API. Ver Conecte un agente de IA para alcances y desconectar un agente.

Instalar la habilidad Kanera

La conexión MCP le da a Gemini CLI acceso 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 ~/.gemini/skills/kanera/ para una habilidad personal disponible en todos los proyectos.
• .agents/skills/kanera/ o .gemini/skills/kanera/ en un repositorio para compartir la habilidad con ese proyecto.

Ejecución /skills list dentro de Gemini CLI para verificar que la habilidad esté disponible, y /skills reload después de cambiarlo. Gemini CLI solicita confirmación cuando activa una habilidad.

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 entorno CLI de Gemini no puede completar la devolución de llamada de OAuth del host local.
• 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. :::

Agregar un encabezado de autorización a settings.json que lee la clave de su entorno:

{
  "mcpServers": {
    "kanera": {
      "httpUrl": "https://mcp.kanera.app/mcp",
      "headers": {
        "Authorization": "Bearer $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. Evite introducir la llave directamente settings.json.

Referencia del cliente

• Guía del servidor MCP actual de Gemini CLI