Saltar al contenido principal

Configurar Claude para Kanera MCP

Claude en la web, Claude Desktop y Claude Code pueden conectarse a Kanera a través del Protocolo de contexto modelo.

Claude y Claude Desktop: conéctate con OAuth​

Kanera es un conector de Claude publicado. Buscar Kanera bajo Personalizar -> Conectores y seleccione Conectar. Claude abre una pantalla de inicio de sesión y consentimiento del navegador; no crea ni pega una clave API. Funciona en todos los planes alojados de Kanera, incluido el gratuito.

Si el conector publicado no es visible para la cuenta o el espacio de trabajo actual, agregue el mismo punto final de producción como conector personalizado:

  1. Abierto Personalizar -> Conectores.

  2. Seleccionar + -> Agregar conector personalizado.

  3. Ingrese la dirección MCP de Kanera:

    https://mcp.kanera.app/mcp

  4. Seleccionar Añadir, entonces Conectar.

Para una organización Team o Enterprise que restringe los conectores, es posible que un propietario o propietario principal deba habilitar Kanera en Configuración de la organización -> Conectores antes de que los miembros puedan conectarlo.

Claude abre una pestaña de Kanera. Inicie sesión, revise lo que el agente puede hacer y elija Permitir acceso. Habilite Kanera para una conversación desde el + -> Conectores menú al lado del compositor.

Administrar o desconectar al agente más tarde de Configuración de perfil -> Claves API. Ver Conecte un agente de IA para más detalles. Si OAuth no es una opción, consulte la excepción de clave API abajo.

Código Claude: conéctate con OAuth​

Cuando Claude Code inicia sesión con la misma cuenta de Claude, primero ejecute claude mcp list. Si el conector Kanera publicado ya está presente, inicie Claude Code, ingrese /mcpy conéctelo o autentíquelo allí. No agregue un servidor duplicado.

Si Kanera no está presente, agregue el servidor alojado para su usuario para que esté disponible en todos los proyectos:

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

Inicie Claude Code e ingrese /mcp. Seleccione Kanera y complete el flujo de autenticación del navegador. correr claude mcp list para confirmarlo informa Conectado.

Respaldo solo de Shell​

Si un agente puede ejecutar comandos de shell pero no puede usar MCP, instale Kanera CLI en lugar de automatizar la interfaz web:

npx -y @kanera/cli commands          # inspect it without a global install
npm install --global @kanera/cli     # persistent command; requires Node 22+
kanera auth login
kanera setup claude --global
kanera whoami --json

La CLI expone la misma capa de herramienta Kanera. kanera auth login inicia sesión a través de tu navegador con OAuth, de la misma manera que lo hace el conector, por lo que no hay que crear ninguna clave; utilizar --with-api-key para un agente desatendido. Prefiera el conector publicado cuando esté disponible, ya que no necesita instalación.

Instalar la habilidad Kanera​

La conexión MCP le da a Claude acceso a las herramientas de Kanera. el opcional Habilidad del agente Kanera le enseña a resolver nombres en ID estables, leer el estado actual antes de informar o cambiar el trabajo, usar claves de idempotencia y manejar fallas de manera segura.

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

Reinicie Claude si la habilidad no aparece. Claude puede cargarlo automáticamente para trabajos relevantes o puede invocarlo 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 configuración de Claude no puede utilizar el conector publicado ni un conector personalizado con 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 -> API. Para una configuración personal de Claude, 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.

Código Claude​

Para el punto final HTTP alojado con una clave estática:

claude mcp add --transport http kanera --scope user https://mcp.kanera.app/mcp \
  --header "Authorization: Bearer kanera_live_..."

Para un servidor stdio local, ejecute el Kanera CLI como servidor:

claude mcp add kanera --scope user \
  --env KANERA_API_KEY=kanera_live_... \
  --env KANERA_PUBLIC_API_URL=https://api.kanera.app \
  -- npx -y @kanera/cli mcp

Si ya corriste kanera auth login, suelta ambos --env banderas; kanera mcp reutiliza la credencial almacenada. correr claude mcp list para confirmar que el servidor está conectado.

Escritorio Claude​

Abierto Configuración -> Desarrollador -> Editar configuración, que se abre claude_desktop_config.jsony agregue el servidor en mcpServers:

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

Reinicie Claude Desktop después de guardar, luego abra una nueva conversación y confirme que las herramientas de Kanera estén disponibles. Esta configuración ejecuta el servidor localmente a través de stdio y necesita el Nodo 22 o posterior.

Si ya configuró Kanera en Claude Desktop y luego instaló Claude Code, Claude Code puede importar la configuración del escritorio con:

claude mcp add-from-claude-desktop

Este comando de importación está disponible en macOS y el Subsistema de Windows para Linux (WSL).

Referencias de clientes​