Skip to main content

Claude Code · Codex

Dile a tu servidor de juegos lo que quieres hacer.

Conecta Claude Code o Codex con tu servidor. Deja que tu asistente instale plugins, ajuste la configuración o investigue problemas de arranque. Tú decides a qué servidores puede acceder.

Conexión sin coste adicional. Necesitas un asistente de IA compatible; su proveedor puede cobrar costes propios.

Con estas tareas puedes empezar

Comprueba el estado de mi servidor. De momento no cambies nada.
Añade a estos tres jugadores a la whitelist.
Comprueba si este plugin es compatible con la versión de mi servidor. Pregúntame antes de instalarlo.

Tareas de ejemplo: las funciones disponibles dependen del juego, del plan y de los permisos concedidos.

Conectado en cuatro pasos

Conectar Claude Code o Codex

Elige tu asistente, copia ambos comandos y ejecútalos en la terminal. Después, en el navegador, seleccionas servidor, permisos y duración.

No necesitas copiar ningún token.

claude mcp add --scope user --transport http ezplayhost https://ezplayhost.com/api/automation/v1/mcp
claude mcp login ezplayhost
Conectar manualmente con un token

Para aplicaciones REST y MCP sin inicio de sesión en el navegador, aún puedes crear un token limitado.

Importante: Este no es un comando para la consola de juego de tu servidor. Introdúcelo en la terminal de tu propio ordenador (Windows: PowerShell, macOS y Linux: Terminal).

claude mcp add --scope user --transport http ezplayhost https://ezplayhost.com/api/automation/v1/mcp --header "Authorization: Bearer <TOKEN>"

Codex lee el token de una variable de entorno. La primera línea la define para la terminal actual. Si quieres conservarla, añádela a tu perfil de shell.

Importante: Este no es un comando para la consola de juego de tu servidor. Introdúcelo en la terminal de tu propio ordenador (Windows: PowerShell, macOS y Linux: Terminal).

export EZPLAYHOST_ASSISTANT_TOKEN="<TOKEN>"
codex mcp add ezplayhost --url https://ezplayhost.com/api/automation/v1/mcp --bearer-token-env-var EZPLAYHOST_ASSISTANT_TOKEN

Para la configuración manual, tu cliente MCP debe admitir Streamable HTTP y un token Bearer configurable. Los clientes compatibles con OAuth se conectan en su lugar iniciando sesión en el navegador, sin token.

URL: https://ezplayhost.com/api/automation/v1/mcp
Header: Authorization: Bearer <TOKEN>

¿Sin compatibilidad con MCP? Las mismas acciones están disponibles como interfaz REST clásica con descripción OpenAPI.

Importante: Este no es un comando para la consola de juego de tu servidor. Introdúcelo en la terminal de tu propio ordenador (Windows: PowerShell, macOS y Linux: Terminal).

curl -H "Authorization: Bearer <TOKEN>" https://ezplayhost.com/api/automation/v1/servers

El marcador <TOKEN> representa tu acceso. Dentro de tu cuenta, la página lo rellena automáticamente.

Conviene saber

  • En instalaciones, copias de seguridad y cambios de versión, «aceptado» todavía no significa «terminado». El asistente debe comprobar el resultado mediante el estado, el inventario y la consola.
  • Los permisos de archivos y los comandos de consola permiten cambios de gran alcance. Si no lo deseas, elige los permisos uno a uno en tu perfil.
  • Los permisos de cuenta, como correo, contraseña y cancelación, nunca forman parte de la vía rápida y siempre se confirman en el navegador.
  • Puedes revocar el acceso en cualquier momento desde el panel o desde tu perfil. Deja de ser válido de inmediato.
  • La guía técnica completa y el contrato de la API se pueden leer sin iniciar sesión.

Abrir la guía técnica OpenAPI

Mostrar todas las funciones técnicas

Lo que puede hacer un asistente

Este es el catálogo completo de acciones. Cada acción depende de un permiso que concedes por separado al crear el acceso: lo que no concedes no existe para el asistente.

Servidor y energía

  • servers_list
  • server_status
  • server_start
  • server_stop
  • server_restart
  • reinstall_status

Jugadores

  • players_list
  • whitelist_read
  • whitelist_add
  • whitelist_remove
  • players_history

Consola

  • console_read
  • console_command

Archivos

  • files_list
  • file_read
  • file_write
  • directory_create
  • files_delete
  • file_copy
  • file_rename
  • files_compress
  • file_decompress

Copias de seguridad

  • backups_list
  • backup_create
  • backup_restore
  • backup_delete

Tareas programadas

  • schedules_list
  • schedule_create
  • schedule_update
  • schedule_delete

Configuración

  • config_read
  • config_write

Mundos

  • worlds_list
  • world_create
  • world_switch
  • world_delete
  • world_import_status
  • world_import_install

Versiones

  • versions_list
  • version_status
  • version_preview
  • version_change

Software del servidor

  • software_catalog
  • software_preview
  • software_change

Plugins y mods

  • addons_list
  • addons_search
  • addon_versions
  • addon_install
  • addon_update
  • addon_remove

Modpacks

  • modpacks_catalog
  • modpack_preview
  • modpack_status
  • modpack_install
  • modpack_update

Paquetes de Bedrock

  • bedrock_packs_list
  • bedrock_catalog
  • bedrock_pack_install
  • bedrock_pack_enable
  • bedrock_pack_disable
  • bedrock_pack_remove

Ajustes del servidor

  • settings_read
  • settings_update
  • startup_variables_read
  • startup_variables_update

Uso e historial

  • metrics_current
  • metrics_history

Registro de actividad

  • activity_list

Salud y prueba de conexión

  • health_status
  • join_test_start
  • join_test_status
  • health_crash_diagnosis

Bases de datos

  • databases_list
  • database_create
  • database_delete
  • database_password_rotate

Exportación e importación de mundos

  • export_start
  • export_status

Subdominio

  • subdomain_check
  • subdomain_change

Herramientas del juego

  • rust_wipe_schedule_read
  • rust_wipe_schedule_create
  • rust_wipe_schedule_cancel
  • rust_startup_params_read
  • rust_startup_params_update
  • rust_map_preview
  • cs2_map_pool_read
  • cs2_map_pool_write
  • cs2_match_status
  • cs2_match_load
  • cs2_match_control
  • cs2_map_change
  • ark_ini_read
  • ark_ini_write
  • ark_mod_order_read
  • ark_mod_order_write
  • valheim_worlds_list
  • valheim_world_activate
  • valheim_backups_list
  • valheim_backup_create
  • valheim_plugins_list
  • valheim_plugin_toggle

Reinstalación

  • server_reinstall

Cuenta

  • account_read
  • account_profile_update
  • account_billing_history
  • account_subscriptions
  • account_email_change
  • account_password_change
  • account_delete_request
  • subscription_cancel
  • subscription_reactivate
  • account_security_status
  • account_two_factor_manage
  • account_payment_methods_manage
  • account_order_prepare

Tickets de soporte

  • support_ticket_create

Lo que sigue bajo tu control

  • Permisos por acceso: lectura, control, archivos, consola y cuenta se eligen por separado.
  • Vinculación a servidores: un acceso solo vale para los servidores que le asignes, nunca automáticamente para los nuevos.
  • Revocación en cualquier momento: un clic en tu perfil y el token deja de ser válido de inmediato y en todas partes.
  • Fecha de caducidad: puedes limitar un acceso a un plazo determinado desde el principio.
  • Trazabilidad: cada acción aparece en el registro de actividad del servidor con su fecha y el acceso utilizado.
  • Límite de frecuencia: las llamadas están limitadas por acceso, así que un asistente defectuoso no puede saturar tu servidor.
  • El token no va en el chat: introdúcelo únicamente en el campo protegido de credenciales de tu asistente.

automation:unattended Permiso adicional para la ejecución desatendida. Sin él, el asistente te pide confirmar estos pasos en tu cuenta: cambio de software del servidor, instalación de Modpack, actualización de Modpack, reinstalación del servidor, importación de mundos, cambio de subdominio y apertura de un ticket de soporte. Las acciones de cuenta —correo electrónico, contraseña, cancelación, eliminación— siempre requieren confirmación. Todo lo demás se ejecuta directamente, dentro de los permisos que le has concedido.

Preguntas frecuentes

¿La interfaz cuesta aparte?

No. La API de automatización forma parte de cada servidor y no tiene coste adicional. Sigues pagando únicamente tu servidor.

¿Qué asistentes funcionan?

Se admiten clientes MCP con Streamable HTTP y un token Bearer configurable, como Codex CLI. La compatibilidad depende de la versión y configuración de la aplicación. También puedes invocar las mismas acciones mediante la API REST.

¿Puede el asistente gastar dinero en mi nombre?

No. Los pedidos, las renovaciones y los pagos pasan exclusivamente por el proceso de compra dentro de tu cuenta. Un acceso de asistente no puede iniciar ningún pago.

¿Qué significa «sin preguntar»?

Las acciones de cuenta —correo electrónico, contraseña, cancelación y eliminación— siempre requieren confirmación. El permiso adicional permite ciertas acciones del servidor sin confirmación en el navegador. Los puntos de protección dependen de la acción; no existe una garantía general de copia de seguridad ni de reversión. Una copia de archivos no protege bases de datos SQL externas.

¿Cómo revoco un acceso?

Retíralo en tu perfil, en «API de automatización». Pierde su validez de inmediato; las peticiones que el asistente tenga en curso fallarán después.