Conectar Claude Code a su panel — Documentación

Con esto configurado, Claude Code puede mirar su panel mientras usted trabaja en una terminal: "¿cuál de mis cuentas está más cerca de su límite de disco?", "muéstrame los registros DNS de example.com". Solo lee lo que su token permite. Todo lo que borra o interrumpe se convierte en una solicitud que espera a que usted pulse Aprobar en el panel. El asistente nunca aprueba su propia solicitud.

Esta es la segunda forma de usar la IA con Nimbopanel. La primera, un panel de chat dentro del propio panel, se describe en Asistente de IA. No necesita aquella para usar esta.

Antes de empezar

La dirección de su panel, por ejemplo https://panel.yourdomain.com. Use la dirección propia del panel, no una IP.
Claude Code instalado en su ordenador (el comando claude funciona en una terminal).
Una cuenta en el panel: administrador, revendedor, cliente o usuario de equipo.

1. El administrador activa la conexión (una sola vez)

Abra Sistema → Seguridad → Conexión de asistente de IA (MCP), marque Permitir que se conecten asistentes de IA, elija qué tipos de personas pueden conectar uno y pulse Guardar. La tarjeta muestra la dirección que usan los asistentes: /mcp sobre la dirección de su panel.

En una instalación nueva esto viene apagado. Mientras no esté encendido, /mcp responde 404 y nada de lo que sigue funciona.

2. Cree un token solo para el asistente

Entre en el panel y abra Tokens de API: los administradores y revendedores lo encuentran en Seguridad, los clientes en Avanzado. Abra Conectar un asistente de IA (Claude y otros).

Póngale un nombre que reconozca, como Claude Code en mi portátil.
Para cada parte del panel elija Sin acceso, Lectura o Leer y cambiar. Empiece por Lectura: el asistente podrá mirar todo lo que marque y no cambiará nada.
Deje Deja de funcionar tras (días) en 90, o ponga el número que prefiera.
Pulse Crear token de asistente.

El panel muestra ahora el token una sola vez. Cópielo antes de salir de la página.

3. Pegue un comando

El panel imprime el comando con su dirección y el token ya incluidos. Cópielo y ejecútelo en una terminal. Tiene este aspecto:

claude mcp add --transport http nimbopanel https://panel.yourdomain.com/mcp --header "Authorization: Bearer <token>"

Lo que dice: añade un servidor MCP llamado nimbopanel, al que se llega por HTTP en la dirección /mcp del panel, y envía su token en la cabecera Authorization en cada llamada.

Dónde lo guarda Claude Code. De forma predeterminada el servidor se guarda solo para el proyecto actual, en ~/.claude.json de su ordenador, no en la carpeta del proyecto. Añada --scope user para usarlo en todos los proyectos. No añada --scope project con un token real: eso escribe el token en .mcp.json, un archivo pensado para subirse al repositorio y compartirse. Si un equipo comparte la conexión, ponga una referencia en .mcp.json y deje que cada persona guarde su propio token en una variable de entorno:

{
  "mcpServers": {
    "nimbopanel": {
      "type": "http",
      "url": "https://panel.yourdomain.com/mcp",
      "headers": { "Authorization": "Bearer ${NIMBOPANEL_TOKEN}" }
    }
  }
}

Cada persona debería crear su propio token, de modo que cada solicitud muestre quién la hizo y un token pueda revocarse por separado.

4. Compruebe que funciona

claude mcp list

nimbopanel debería aparecer como conectado. Dentro de Claude Code también puede escribir /mcp. Después pregunte con palabras sencillas:

"Lista mis cuentas de hosting y dime cuál usa más disco."
"Muéstrame los registros DNS de example.com."
"¿Cuáles de mis bases de datos son las más grandes?"
Administradores: "¿Están funcionando todos los servicios?", "¿Está creciendo la cola de correo?"

El asistente puede consultar las cuentas y su uso, los dominios, los registros DNS, las cuentas de correo (nunca las contraseñas), las bases de datos, las copias de seguridad, la carga y los servicios del servidor, la cola de correo, los revendedores y los tickets de soporte, dentro de las partes que nombra su token y de su propio rol.

Cuando le pide un cambio

Con Leer y cambiar, un registro nuevo y corriente de dirección (A o AAAA) o de texto (TXT) sobre un nombre nuevo y habitual se añade al instante.
Todo lo demás espera a que usted lo decida: borrar un registro, suspender una cuenta o reactivarla, los registros de correo, el propio dominio, los registros CNAME, SRV y CAA, los comodines y los nombres que consultan los programas de correo. Se convierte en una solicitud.

Abra Tokens de API → Solicitudes del asistente. Cada solicitud explica con palabras claras qué va a pasar. Pulse Aprobar… y después Sí, hacerlo ahora. Una solicitud caduca a los 30 minutos. Lea la solicitud, no el mensaje del asistente: la solicitud la escribe el panel y dice exactamente qué se va a hacer.

Como el cambio lo pidió un asistente, el panel primero le pide que confirme que es usted con su contraseña (y su código de verificación si usa inicio de sesión en dos pasos); después no se lo vuelve a pedir durante unos minutos.

Si no funciona

Lo que ve	Qué significa	Qué hacer
`404 Not found` en `/mcp`, o una página que dice que no hay ningún sitio web configurado para esa dirección	La conexión está apagada, o usó una dirección que no es la propia de su panel (una IP u otro dominio)	Paso 1; use la dirección propia del panel, terminada en `/mcp`
`403 forbidden_host`	La dirección llega al panel, pero este no la reconoce como suya	Use la dirección propia del panel, por ejemplo `https://panel.yourdomain.com`
`401 Login required`	Falta el token, está mal escrito, caducó o fue revocado	Cree un token nuevo y ejecute el comando otra vez
`403 mcp_scope_required`	Es un token de API normal, no uno para asistentes	Cree un token en Conectar un asistente de IA (Claude y otros)
`403 mcp_off_for_role`	Su tipo de cuenta no puede conectar un asistente	Pregunte al administrador (paso 1)
`429 rate_limited`	Demasiadas llamadas en poco tiempo	Espere un minuto
Falta una parte del panel	Su área está en Sin acceso	Cree un token nuevo con esa área en Lectura

Si claude mcp list muestra un fallo, lo habitual es que a la URL le falte /mcp, o que la cabecera no sea exactamente Authorization: Bearer <token>.

Cómo quitarlo

claude mcp remove nimbopanel

lo quita de su ordenador. Para que el token deje de funcionar en todas partes, bórrelo en Tokens de API; las solicitudes que dejó abiertas se cancelan. El administrador puede apagar toda la conexión en el paso 1, y /mcp vuelve a responder 404.

Buenas costumbres

Prefiera Lectura. Use Leer y cambiar solo en las áreas que lo necesitan.
Un token por ordenador o por persona, con un nombre que diga de quién es.
Mantenga los 90 días predeterminados, o menos en un equipo compartido.
No pegue nunca un token en un chat, en un ticket ni en un archivo que vaya a subir al repositorio.

Todavía no compatible: los clientes que solo pueden conectarse con inicio de sesión OAuth. Este punto de acceso acepta un token en la cabecera.