API de IA y MCP: conecta Claude, ChatGPT y Cursor
Conecta Claude, ChatGPT, Cursor o n8n a tus servidores de SolumeCore por MCP: tokens, permisos, aprobaciones, auditoría y el Copiloto del panel.
SolumeCore tiene una API de IA basada en el Model Context Protocol (MCP). Permite que un asistente de IA que ya usas, como Claude, ChatGPT, Cursor, VS Code o n8n, gestione con palabras normales tus propios servidores de juego, apps y VPS: leer la consola, reiniciar, editar una línea de configuración, instalar un plugin, hacer un backup. Tú decides qué servidores puede ver, qué puede hacer en cada área, si cada cambio necesita tu aprobación y cuándo caduca su acceso. Todo lo que hace queda registrado.
Esta guía explica cómo conectar un asistente, cómo funcionan los permisos y las aprobaciones, qué herramientas se exponen y qué redes de seguridad existen. También trata el Copiloto, el chat de IA que puede aparecer dentro de las páginas de tus servidores. SolumeCore publica además una guía paso a paso para conectar tu IA.
Importante: la API de IA está en beta. Debes aceptar los términos de la beta antes de crear tu primer token y, durante la beta, solo se pueden conectar tus propios servidores, no los que han compartido contigo. El Copiloto es una función aparte que está desactivada por defecto: solo aparece si SolumeCore la ha activado, así que si no lo ves, todavía no está disponible en la plataforma.
Las piezas
| Pieza | Qué es | Dónde |
|---|---|---|
| API de IA (MCP) | Un servidor al que se conecta tu propia IA, con tokens, permisos, aprobaciones y registro de auditoría | Cuenta → IA y copiloto |
| Copiloto | Un chat de IA dentro de cada servidor que lee la consola y los archivos y propone arreglos que aplicas con un clic | Página del servidor, si está activo |
| Asistente de soporte | Un paso de IA al abrir un ticket: solo lee el centro de ayuda y el estado de tu servicio, y una persona puede tomar el relevo cuando quieras | Tickets, si está activo |
El resto de la guía trata de la API de IA, salvo que se indique otra cosa.
Conectar tu IA
La dirección MCP es https://api.solumecore.com/mcp. Hay dos formas de autorizar a un asistente.
Con un clic mediante OAuth (Claude en la web y la app, ChatGPT): añade un conector personalizado llamado SolumeCore con la dirección MCP, pulsa Conectar y SolumeCore te lleva al panel para elegir servidores y permisos. No hay token que pegar. En Claude: Configuración → Conectores → Agregar conector personalizado. En ChatGPT: Configuración → Apps y conectores → Avanzado, activa el modo desarrollador y crea el conector con autenticación OAuth.
Con un token (Claude Desktop, Claude Code, Cursor, VS Code, n8n, cualquier otro):
- Abre Cuenta → IA y copiloto, acepta los términos de la beta si no lo has hecho y pulsa Nuevo token de IA.
- Recorre los cinco pasos (más abajo), pulsa Crear token y copia el token. Empieza por
slm_ai_y se muestra una sola vez. - Abre la pestaña Conectar, elige tu asistente y copia la configuración, sustituyendo
YOUR_TOKENpor tu token.
claude mcp add --transport http solumecore https://api.solumecore.com/mcp \
--header "Authorization: Bearer slm_ai_xxxxxxxxxxxxxxxx"{
"mcpServers": {
"solumecore": {
"url": "https://api.solumecore.com/mcp",
"headers": { "Authorization": "Bearer slm_ai_xxxxxxxxxxxxxxxx" }
}
}
}{
"servers": {
"solumecore": {
"type": "http",
"url": "https://api.solumecore.com/mcp",
"headers": { "Authorization": "Bearer slm_ai_xxxxxxxxxxxxxxxx" }
}
}
}En n8n, añade un nodo AI Agent con un MCP Client Tool, pon la dirección MCP como endpoint, el transporte HTTP Streamable y la autenticación Header Auth con nombre Authorization y valor Bearer YOUR_TOKEN. Para automatizaciones elige Aprobar en el panel, de modo que los cambios esperen tu visto bueno. Claude Desktop necesita un pequeño bloque en claude_desktop_config.json (usa Node.js); la pestaña Conectar muestra el texto exacto.
Sirve cualquier cliente MCP que hable Streamable HTTP, y el transporte SSE anterior está disponible en /mcp/sse. Una petición en bruto tiene este aspecto:
curl https://api.solumecore.com/mcp \
-H "Authorization: Bearer slm_ai_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Una llamada sin autorización recibe 401 con la información de descubrimiento que necesitan los clientes MCP para OAuth; un token usado desde una IP no permitida o con una cuenta inactiva recibe 403. Los nombres de las herramientas y los mensajes de error están en inglés.
Crear un token
El asistente Nuevo token de IA tiene cinco pasos.
- Nombre: algo que reconozcas en la lista y en el registro, como «Claude Desktop».
- Servidores: Todos mis servidores (también los que compres después) o una selección de servicios de juego, apps y VPS.
- Permisos: parte de un ajuste predefinido y afina por área.
- Seguridad: modo de confirmación, backup antes de cambios grandes, cambios por día, caducidad e IPs permitidas.
- Revisar y Crear token.
Permisos
Cada área tiene un nivel: No, Leer, Cambios o Todo, y cada nivel incluye el anterior. Tres ajustes predefinidos fijan todas las áreas de una vez:
| Ajuste | Qué puede hacer la IA |
|---|---|
| Solo mirar | Leer estado, consola, logs y archivos. No cambia nada |
| Ayudante (recomendado) | Además reinicia, edita archivos, instala plugins y hace backups. Nunca borra ni restaura |
| Control total | Todo, incluido borrar archivos (recuperables 3 días), restaurar backups y forzar el apagado |
Las áreas son Servidores y métricas, Encendido, Consola y logs, Archivos, Backups, Jugadores, Plugins y mods, server.properties, Tareas programadas y VPS. Un token con Leer puede mirar pero nunca cambiar; las herramientas destructivas exigen Todo en su área.
Modo de confirmación
| Modo | Qué ocurre |
|---|---|
| Preguntarme en el chat | La IA muestra qué va a hacer, con un diff para los archivos, y espera tu sí. Es el modo por defecto para tokens sin poder destructivo |
| Aprobar en el panel | Cada cambio espera en la pestaña Aprobaciones hasta que pulses Aprobar. Ideal para automatizaciones y asistentes compartidos |
| No preguntar los cambios normales | Los reinicios y las ediciones se hacen al instante. Borrar, restaurar y forzar el apagado siguen preguntando |
Una propuesta que no respondes caduca a los 15 minutos. Las acciones destructivas siempre necesitan confirmación, y para un token que puede hacerlas el panel recomienda Aprobar en el panel, porque en el modo de chat confirma la propia IA y un archivo o un log con instrucciones ocultas podría empujarla a confirmar algo por su cuenta. Por defecto SolumeCore además exige aprobación en el panel para lo destructivo incluso en tokens en modo chat; es un ajuste de la plataforma que SolumeCore puede cambiar.
Otras salvaguardas
- Backup antes de cambios grandes: antes de restaurar un backup, instalar o actualizar plugins o cambiar
server.propertiesen un servidor de juego, se hace primero un backup (activado por defecto). - Borrados recuperables: los archivos que borra una IA pasan a una carpeta
IA-deleted-filesy se pueden restaurar durante 3 días, desde la pestaña Archivos borrados o pidiéndoselo a la IA; después se borran de verdad. - Cambios por día: un tope diario de cambios (100 por defecto, hasta 2000). Las lecturas no cuentan. Al llegar al tope, la IA puede seguir mirando pero no cambiar.
- Caducidad: 1, 7, 30, 90 o 365 días. No hay tokens eternos.
- IPs permitidas (opcional): hasta 20 direcciones o rangos, uno por línea, para tokens que se usan desde n8n o tus propios scripts. Vacío significa desde cualquier sitio.
- Límites de velocidad: 120 llamadas por minuto por token y 20 cambios por minuto.
- Hasta 25 tokens activos por cuenta. Revocar uno desconecta a la IA al instante y cancela sus propuestas pendientes.
Herramientas que puede usar la IA
El servidor expone 45 herramientas. Los nombres están en inglés y en snake_case, como esperan los clientes MCP. Las destructivas van marcadas.
| Área | Herramientas |
|---|---|
| Servidores y métricas | list_servers, get_server_status, get_server_metrics, get_server_activity |
| Encendido | start_server, restart_server, stop_server, wake_server, kill_server |
| Consola y logs | read_console, search_logs, diagnose_crash, send_command |
| Archivos | list_files, read_file, search_files, write_file, edit_file, create_folder, rename_file, copy_file, list_deleted_files, restore_deleted_files, delete_files |
| Backups | list_backups, create_backup, restore_backup |
| Jugadores | list_players, manage_player |
| Plugins y mods | search_plugins, list_installed_plugins, check_plugin_updates, install_plugin, update_plugins |
| server.properties | get_server_properties, update_server_properties |
| Tareas programadas | list_schedules, run_schedule |
| VPS | list_vps, get_vps_status, vps_power, vps_force_power |
| Control | confirm_action, cancel_action, list_pending_actions |
Cosas que puedes pedir: «¿Por qué se cayó anoche mi servidor de Minecraft?», «Haz un backup de Survival y luego reinícialo», «Pon max-players en 50», «Busca en el log errores de plugins», «Instala EssentialsX y LuckPerms», «Añade a Steve a la whitelist».
Aprobaciones, actividad y auditoría
- Pestaña Aprobaciones: las propuestas pendientes con el servidor, la acción y, en archivos, el diff. Aprobar la ejecuta; Rechazar la cancela. Cuando hay una propuesta esperando también recibes una notificación, «Tu IA quiere hacer un cambio».
- Pestaña Actividad: cada llamada con la hora, el token, la herramienta, el servidor y el resultado (OK, Error, Propuesta, Negado, Límite o Esperando), sus parámetros con los secretos ocultos y la IP de origen. Se guarda 180 días y un gráfico muestra las llamadas, los cambios y los errores de los últimos 14 días.
- Pestaña Archivos borrados: lo que han borrado las IA, con Restaurar y Borrar ya.
- ¿Quieres un mensaje en Discord, Slack, Telegram, Teams, el correo o tu webhook cada vez que una IA cambie algo? Usa el evento
ia.accion; mira Integraciones y notificaciones y Webhooks y eventos de cuenta.
El Copiloto en las páginas de tus servidores
Cuando SolumeCore lo activa, un botón Copiloto abre un chat de IA dentro de un servidor. Lee la consola, los logs y los archivos de ese servidor, explica con palabras simples qué ocurre y propone cambios que revisas y aplicas con Aplicar o descartas con Descartar. No cambia nada hasta que lo aplicas, y antes se hace un backup. Hay un límite diario de preguntas; el panel muestra «X de Y hoy». Por defecto se tapan las direcciones IP de los jugadores en lo que se envía a la IA. Puedes ocultar el Copiloto en todos tus servidores con el interruptor «Mostrar el copiloto en mis servidores» de la página IA y copiloto. Como cualquier IA, puede equivocarse.
Privacidad y responsabilidad
La IA actúa con los permisos que das a cada token, y lo que apruebas es responsabilidad tuya. Lo que el asistente lee para responderte (estados, líneas de consola y de log, el contenido de los archivos que abre) lo procesa el proveedor de IA que hay detrás de ese asistente, con sus propios términos (en el caso del Copiloto, el proveedor que usa SolumeCore). No ve tu contraseña, tus datos de pago ni la contraseña de RCON. Para mantener algo fuera de su alcance, dale al token menos servidores o el ajuste Solo mirar.
Documentos relacionados
- Qué API de SolumeCore usar
- Integraciones y notificaciones
- Webhooks y eventos de cuenta
- Panel de servidores de juego
- Backups y retención
- Seguridad de la cuenta
FAQ
¿Qué es el servidor MCP de SolumeCore?
Es un endpoint, https://api.solumecore.com/mcp, que permite a los asistentes de IA compatibles con MCP listar, leer y gestionar tus propios servidores mediante tokens u OAuth, con permisos, aprobaciones y un registro de auditoría que controlas tú.
¿Puede la IA hacer algo sin mi aprobación?
Por defecto no: cada cambio es una propuesta que apruebas en el chat o en el panel, y las acciones destructivas siempre preguntan. Si en un token eliges «No preguntar los cambios normales», los cambios rutinarios, como reinicios y ediciones de archivos, se ejecutan al instante, y cada llamada queda registrada igualmente.
¿Qué pasa si la IA borra algo importante?
Los archivos borrados van a la carpeta IA-deleted-files del servidor y se pueden restaurar durante 3 días. Además puedes mantener activado Backup antes de cambios grandes para que se haga una copia antes de las acciones arriesgadas.
¿Funciona con servidores que otras personas han compartido conmigo?
No durante la beta. Solo se pueden conectar servidores de tu propia cuenta.
¿Cómo corto el acceso de un asistente?
Revoca su token en Cuenta → IA y copiloto. Deja de funcionar al instante y se cancelan las propuestas pendientes. Los tokens además caducan solos y se pueden limitar a ciertas IPs.
¿Por qué no veo el Copiloto?
Está desactivado por defecto y solo se muestra si SolumeCore lo ha activado. También puede que lo hayas ocultado con el interruptor de la página de IA, o que no esté disponible para tu plan o esté en pausa por hoy.