Asistente de IA — el del panel, y cómo conectar Claude a su panel

Nimbopanel le ofrece dos formas de usar la IA. Ambas están apagadas hasta que usted las active, y en ambas el asistente solo puede ver lo que puede ver la persona que lo usa.

El asistente integrado

Las personas preguntan en su propio idioma — "¿por qué no me llega el correo?", "¿cuánto disco me queda?" — y el asistente lee el panel para responder.

Activarlo (administrador):

1. Abra Sistema → Seguridad → Asistente de IA en el panel.
2. Elija el Proveedor de IA (vea la lista de abajo). Un enlace junto a la opción le lleva a donde ese proveedor crea las claves.
3. Pegue su Clave de API de ese proveedor. Se guarda en un archivo de su servidor que solo puede leer root y no se vuelve a mostrar nunca — ni a usted ni a nadie. Al cambiar de proveedor no se traslada la clave del proveedor anterior.
4. Elija el Modelo. La lista ofrece algunos nombres habituales del proveedor, y puede escribir cualquier nombre de modelo exactamente como lo indica el proveedor.
5. Elija Quién puede usarlo: administradores, revendedores, clientes, usuarios de equipo.
6. Fije los límites: Preguntas por persona al día y el Presupuesto mensual (tokens) para todo el servidor. Cuando se agota el presupuesto, el asistente se detiene hasta el mes siguiente.
7. Marque Activar el asistente y guarde.

Proveedores que puede elegir. Diez aparecen por su nombre, más dos para cualquier otra dirección:

En las dos opciones Otro usted escribe la dirección de la API del proveedor, tal como la indica su documentación. La dirección debe empezar por https://. El http:// a secas solo se acepta para este servidor o una red privada (un servidor de modelos que usted mismo ejecuta). Se rechazan las direcciones que contengan un nombre de usuario, una consulta (query) o un fragmento, y las direcciones del rango de metadatos de la nube.

Límite honesto. El asistente se ha probado con un proveedor simulado que se comporta como cada protocolo. Todavía no se ha probado contra el servicio real de cada proveedor, así que haga una o dos preguntas después de activarlo y antes de avisar a sus clientes. Los nombres de modelo cambian a menudo; si un proveedor responde que no conoce el modelo, escriba el nombre actual.

Elegir un proveedor de IA y mantener la factura pequeña

• Usted paga al proveedor, según el uso — El coste crece con el número de preguntas y la longitud de las respuestas. Los precios cambian a menudo, así que abra la página de precios del proveedor antes de decidir y fije también un límite de gasto en el panel del propio proveedor. Nimbopanel no cobra nada extra.
• ¿Qué proveedor? — Para buenas respuestas con el menor esfuerzo, elija un proveedor alojado como Anthropic, OpenAI o Google. Para una sola clave que llegue a muchos modelos, elija OpenRouter. Para que cada pregunta se quede en su propio servidor, ejecute Ollama allí: sin coste por pregunta, pero necesita memoria suficiente y los modelos pequeños responden peor. Puede cambiar de proveedor más tarde.
• Empiece con poco — Mantenga los límites iniciales (30 preguntas por persona al día y 2.000.000 de tokens al mes para todo el servidor) y al principio deje que lo usen solo los administradores. 0 significa sin límite, así que déjelo para más adelante.
• Decida qué puede leer la IA — Marque «Mantener los tickets de soporte fuera del servicio de IA» si no quiere que los mensajes de los clientes se envíen a un proveedor. Cada persona ve un aviso de privacidad antes de su primera pregunta.
• Pruébelo antes de avisar a los clientes — Haga unas preguntas en una cuenta de prueba y pruebe un cambio propuesto: aprobarlo pide la contraseña de quien lo aprueba.

Lo que puede y lo que no puede hacer

• Lee con los propios permisos de la persona que pregunta: el asistente de un cliente ve la cuenta de ese cliente y nada más; el asistente de un revendedor conserva los privilegios del revendedor.
• No puede cambiar nada por sí solo. Para unos pocos cambios (añadir o borrar un registro DNS, suspender una cuenta o reactivarla) prepara una tarjeta debajo de su respuesta. La tarjeta la escribe el panel — no la IA — y dice exactamente qué va a pasar. No ocurre nada hasta que la persona pulsa Aprobar… y después Sí, hacerlo ahora. También puede pulsar Rechazar. 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.
• Cuando el asistente ha leído mensajes escritos por otras personas (por ejemplo, tickets de soporte) antes de proponer algo, la tarjeta lo indica. Apruebe solo lo que usted realmente pidió.
• Las solicitudes esperan 30 minutos y después caducan. Al apagar el asistente se cancelan todas las propuestas abiertas.
• No está disponible con un token de API ni en una pestaña de "Entrar como" — solo en la sesión propia de una persona.

Privacidad. Antes de su primera pregunta, cada persona ve un aviso: las preguntas, y los datos del panel que el asistente lee para responderlas, se envían al proveedor que usted eligió, a través de su cuenta. Las contraseñas y las claves se eliminan de lo que se envía cuando el panel puede reconocerlas, pero nadie debería escribir nunca una contraseña en el asistente. El asistente de un administrador o de un revendedor puede leer datos de otros clientes que estos tengan permiso para ver.

Conectar un asistente de IA (MCP)

Esto permite que alguien use su propio asistente (por ejemplo, Claude) con el panel, mediante el Model Context Protocol.

1. Administrador: abra Sistema → Seguridad → Conexión de asistente de IA (MCP), marque Permitir que se conecten asistentes de IA, elija qué roles pueden conectarse y guarde.

2. La persona (administrador, revendedor, cliente o usuario de equipo) abre Tokens de API → Conectar un asistente de IA (Claude y otros). Para cada parte del panel elija Sin acceso, Lectura o Leer y cambiar — elija Lectura cuando el asistente solo deba mirar — y luego pulse Crear token de asistente. El token deja de funcionar a los 90 días, salvo que usted ponga otro número en Deja de funcionar tras (días).

3. El panel muestra el comando que hay que pegar. Para Claude Code:

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

   Otros clientes MCP usan la misma dirección con el token en la cabecera Authorization: Bearer.

Lo que puede hacer un asistente conectado: leer las partes que indica su token; añadir un registro de dirección o de texto para un nombre nuevo y corriente. Todo lo demás — borrar un registro, suspender una cuenta o reactivarla, los registros de correo, el propio dominio, los registros CNAME/SRV/CAA, los comodines y los nombres que consultan los programas de correo (autodiscover, autoconfig, mail, …) — se convierte en una solicitud. El propietario del token la ve en Tokens de API → Solicitudes del asistente y la aprueba o la rechaza. Un asistente nunca puede aprobar su propia solicitud.

Todavía no compatible: los clientes que solo pueden conectarse con inicio de sesión OAuth (el punto de acceso acepta un token en la cabecera). Puede revocar un token en cualquier momento en Tokens de API; sus solicitudes abiertas se cancelan.

Buenas costumbres

• Dé a cada token de asistente solo las partes que necesita, y prefiera Lectura a Leer y cambiar.
• Lea cada tarjeta de aprobación. Es la tarjeta — no el mensaje del asistente — la que dice qué va a pasar.
• Mantenga fijados el límite diario de preguntas y el presupuesto mensual; consulte el uso de este mes en la misma tarjeta.