Saltar al contenido principal

Configurar el cursor para Kanera MCP

El cursor se conecta a Kanera a través del Protocolo de contexto modelo. Cursor admite servidores HTTP Streamable remotos con OAuth, por lo que puede conectarse a través de un navegador sin crear ni almacenar una clave API.

Instalación con un clic​

Con Cursor instalado, abra este enlace para agregar Kanera a Cursor en un solo paso:

Agregar Kanera al cursor

El cursor muestra el servidor que está a punto de agregar (https://mcp.kanera.app/mcp) y le pide que lo confirme. Luego complete el inicio de sesión en el navegador que se describe a continuación. Si el enlace no abre Cursor, o usted mismo aloja Kanera, agregue la configuración manualmente. el Generador de configuración MCP también crea el enlace para una dirección autohospedada.

Configuración manual​

Kanera muestra esta configuración, con su dirección MCP completada, en Configuración de perfil -> Claves API -> O configurarlo a mano -> Cursor.

Agregue Kanera a su configuración global de Cursor MCP en ~/.cursor/mcp.json, o a .cursor/mcp.json en un proyecto cuando la conexión solo debería estar disponible allí:

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

El cursor detecta que Kanera requiere OAuth y le pide que se autentique. En Cursor Agent, puede iniciar el flujo del navegador explícitamente:

cursor-agent mcp login kanera

Inicie sesión en Kanera, revise el acceso solicitado y elija Permitir acceso. Luego verifique la conexión y las herramientas disponibles:

cursor-agent mcp list
cursor-agent mcp list-tools kanera

En el editor de cursores, abra Configuración -> Herramientas y MCP para inspeccionar el servidor y sus herramientas. Ver Conecte un agente de IA para alcances y desconectar un agente.

Instalar la habilidad Kanera​

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

Reinicie el cursor si la habilidad no aparece. El cursor puede cargarlo automáticamente para solicitudes relevantes, o puede invocar /kanera 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:

  • Su versión de Cursor 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. :::

Lea la clave de una variable de entorno en lugar de enviarla a una configuración de proyecto:

{
  "mcpServers": {
    "kanera": {
      "url": "https://mcp.kanera.app/mcp",
      "headers": {
        "Authorization": "Bearer ${env:KANERA_API_KEY}"
      }
    }
  }
}

conjunto KANERA_API_KEY en el entorno que inicia Cursor. 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​