Claude Code

Esta página conecta la app de línea de comandos Claude Code a Kernl, para que Claude Code pueda usar las herramientas de Kernl. "Claude Code" también nombra otra función, en la que Kernl usa tu suscripción de Claude como su IA. Esa está en Conectar un modelo.

Necesitás Kernl corriendo y tu token. Si no lo tenés, mirá Primer arranque.

#Agregar Kernl

En Linux, con kernl en tu PATH:

claude mcp add --transport http -s user kernl http://localhost:3086/mcp --header "Authorization: Bearer $(kernl token)"

-s user deja Kernl disponible en todos los proyectos. Usá -s local (el valor por defecto de Claude Code) solo para el proyecto actual, privado para vos. No uses -s project con un token: escribe el servidor en el .mcp.json de la raíz del repositorio, que está pensado para commitearse, y tu token terminaría en git. Respetá el orden que se muestra: nombre, URL y después --header.

Los pasos de macOS y Windows salen del packaging de Kernl; el equipo todavía no los probó en esos sistemas.

En macOS, reemplazá $(kernl token) por la ruta completa:

claude mcp add --transport http -s user kernl http://localhost:3086/mcp --header "Authorization: Bearer $(/Applications/Kernl.app/Contents/MacOS/kernl token)"

Con Docker, corrélo desde la carpeta de Kernl. La opción -T evita que Docker asigne una terminal, así el token vuelve como texto limpio. No corrimos esta línea exacta; lo que sí verificamos es el simple docker compose exec kernel cat /app/data/.kernel-auth-token:

claude mcp add --transport http -s user kernl http://localhost:3086/mcp --header "Authorization: Bearer $(docker compose exec -T kernel cat /app/data/.kernel-auth-token)"

En Windows, imprimí el token con .\start.bat token y pegalo en el comando en lugar de <token>:

claude mcp add --transport http -s user kernl http://localhost:3086/mcp --header "Authorization: Bearer <token>"

Claude Code lo confirma con Added HTTP MCP server kernl y oculta el token en ese mensaje.

#Verificar la conexión

claude mcp list

Tendrías que ver:

kernl: http://localhost:3086/mcp (HTTP) - ✔ Connected

Dentro de una sesión de Claude Code también podés escribir /mcp para ver el servidor y sus herramientas.

#Cuidado con claude mcp get

claude mcp get kernl imprime tu encabezado Authorization completo, token incluido. No pegues su salida en un chat, un issue ni una captura de pantalla.

#Cuando no se conecta

Un token incorrecto se ve así:

kernl: http://localhost:3086/mcp (HTTP) - ✘ Failed to connect — Server rejected the configured Authorization header (HTTP 401). ...

Un token faltante da un mensaje distinto y engañoso:

kernl: http://localhost:3086/mcp (HTTP) - ✘ Failed to connect — JSON Parse error: Unrecognized token '<'

Los dos significan que el token falta o es incorrecto. Mirá 401 Unauthorized y Unexpected token '<'. Para arreglarlo, quitá el servidor y agregalo de nuevo con un token nuevo.

claude mcp remove kernl -s user