Skip to main content

Claude Code · Codex

Dis à ton serveur de jeu ce que tu as en tête.

Connecte Claude Code ou Codex à ton serveur. Laisse ton assistant installer des plugins, ajuster des paramètres ou analyser des problèmes de démarrage. Tu décides à quels serveurs il peut accéder.

Connecter un assistant IA Voir des exemples

Connexion sans supplément. Tu as besoin d'un assistant IA compatible ; son fournisseur peut facturer ses propres frais.

Voici des tâches pour bien démarrer

Vérifie l'état de mon serveur. Ne modifie rien pour le moment.
Ajoute ces trois joueurs à la whitelist.
Vérifie si ce plugin est compatible avec la version de mon serveur. Demande-moi avant de l'installer.

Exemples de demandes : les fonctions disponibles dépendent du jeu, de l'offre et des droits accordés.

Connecté en quatre étapes

Connecter Claude Code ou Codex

Choisis ton assistant, copie les deux commandes et exécute-les dans le terminal. Ensuite, choisis dans le navigateur le serveur, les droits et la durée.

Tu n'as pas besoin de copier de jeton.

claude mcp add --scope user --transport http ezplayhost https://ezplayhost.com/api/automation/v1/mcp
claude mcp login ezplayhost
Se connecter manuellement avec un jeton

Pour les applications REST et MCP sans connexion par navigateur, tu peux toujours créer un jeton limité.

Important : il ne s'agit pas d'une commande pour la console de jeu de ton serveur. Tu la saisis dans le terminal de ton propre ordinateur (Windows : PowerShell, macOS et Linux : Terminal).

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

Codex lit le jeton dans une variable d’environnement. La première ligne la définit pour le terminal en cours. Pour la conserver, ajoute-la à ton profil shell.

Important : il ne s'agit pas d'une commande pour la console de jeu de ton serveur. Tu la saisis dans le terminal de ton propre ordinateur (Windows : PowerShell, macOS et 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

Pour une configuration manuelle, votre client MCP doit prendre en charge Streamable HTTP et un jeton Bearer personnalisé. Les clients compatibles OAuth se connectent plutôt via la connexion dans le navigateur, sans jeton.

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

Pas de prise en charge de MCP ? Les mêmes actions sont disponibles sous forme d'interface REST classique avec description OpenAPI.

Important : il ne s'agit pas d'une commande pour la console de jeu de ton serveur. Tu la saisis dans le terminal de ton propre ordinateur (Windows : PowerShell, macOS et Linux : Terminal).

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

Le repère <TOKEN> représente ton accès. Dans ton compte, la page le remplace automatiquement.

Bon à savoir

  • Pour les installations, les sauvegardes et les changements de version, « accepté » ne veut pas encore dire « terminé ». L’assistant doit vérifier le résultat via l’état, l’inventaire et la console.
  • Les droits sur les fichiers et les commandes console permettent des modifications étendues. Si tu ne le souhaites pas, choisis les droits un par un dans ton profil.
  • Les droits de compte comme l’e-mail, le mot de passe et la résiliation ne font jamais partie de la voie rapide et restent toujours à confirmer dans le navigateur.
  • Tu peux révoquer l’accès à tout moment dans la tuile ou dans ton profil. Il devient aussitôt invalide.
  • Le guide technique complet et le contrat de l’API sont lisibles sans connexion.

Ouvrir le guide technique OpenAPI

Afficher toutes les fonctions techniques

Ce qu'un assistant peut faire

Voici le catalogue complet des actions. Chaque action dépend d'un droit que vous accordez individuellement à la création de l'accès : ce que vous n'accordez pas n'existe pas pour l'assistant.

Serveur et alimentation

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

Joueurs

  • players_list
  • whitelist_read
  • whitelist_add
  • whitelist_remove
  • players_history

Console

  • console_read
  • console_command

Fichiers

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

Sauvegardes

  • backups_list
  • backup_create
  • backup_restore
  • backup_delete

Planifications

  • schedules_list
  • schedule_create
  • schedule_update
  • schedule_delete

Configuration

  • config_read
  • config_write

Mondes

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

Versions

  • versions_list
  • version_status
  • version_preview
  • version_change

Logiciel serveur

  • software_catalog
  • software_preview
  • software_change

Plugins et mods

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

Modpacks

  • modpacks_catalog
  • modpack_preview
  • modpack_status
  • modpack_install
  • modpack_update

Packs Bedrock

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

Paramètres du serveur

  • settings_read
  • settings_update
  • startup_variables_read
  • startup_variables_update

Utilisation et historique

  • metrics_current
  • metrics_history

Journal d'activité

  • activity_list

Santé et test de connexion

  • health_status
  • join_test_start
  • join_test_status
  • health_crash_diagnosis

Bases de données

  • databases_list
  • database_create
  • database_delete
  • database_password_rotate

Export et import de mondes

  • export_start
  • export_status

Sous-domaine

  • subdomain_check
  • subdomain_change

Outils de jeu

  • 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

Réinstallation

  • server_reinstall

Compte

  • 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 support

  • support_ticket_create

Ce qui reste sous votre contrôle

  • Droits par accès : lecture, pilotage, fichiers, console et compte se choisissent séparément.
  • Rattachement aux serveurs : un accès ne vaut que pour les serveurs que vous lui attribuez, jamais automatiquement pour les nouveaux.
  • Révocation à tout moment : un clic dans votre profil et le jeton devient aussitôt invalide partout.
  • Date d'expiration : vous pouvez limiter la durée de vie d'un accès dès le départ.
  • Traçabilité : chaque action figure dans le journal d'activité du serveur avec son horodatage et l'accès utilisé.
  • Fréquence d'appel limitée : les requêtes sont plafonnées par accès, un assistant défaillant ne peut donc pas saturer votre serveur.
  • Le jeton n'a pas sa place dans une conversation : saisissez-le uniquement dans le champ protégé d'identifiants de votre assistant.

automation:unattended Droit supplémentaire pour l'exécution sans surveillance. Sans lui, l'assistant vous demande de confirmer ces étapes depuis votre compte : changement de logiciel serveur, installation de Modpack, mise à jour de Modpack, réinstallation du serveur, importation de mondes, changement de sous-domaine et ouverture d'un ticket de support. Les actions de compte — adresse e-mail, mot de passe, résiliation, suppression — restent toujours soumises à confirmation. Tout le reste s'exécute directement, dans les limites des droits que vous avez accordés.

Questions fréquentes

L'interface coûte-t-elle un supplément ?

Non. L'API d'automatisation fait partie de chaque serveur et ne coûte rien de plus. Vous ne payez toujours que votre serveur.

Quels assistants fonctionnent ?

Les clients MCP prenant en charge Streamable HTTP et un jeton Bearer configurable sont compatibles, par exemple Codex CLI. La compatibilité dépend de la version et de la configuration de l’application. Vous pouvez aussi appeler les mêmes actions via l’API REST.

L'assistant peut-il dépenser de l'argent en mon nom ?

Non. Les commandes, les renouvellements et les paiements passent exclusivement par le tunnel d'achat de votre compte connecté. Un accès d'assistant ne peut déclencher aucun paiement.

Que signifie « sans demander » ?

Les actions de compte — adresse e-mail, mot de passe, résiliation, suppression — nécessitent toujours une confirmation. Le droit supplémentaire permet certaines actions serveur sans confirmation dans le navigateur. Les points de protection dépendent de l’action ; aucune garantie générale de sauvegarde ou de retour arrière n’est offerte. Une sauvegarde de fichiers ne protège pas les bases SQL externes.

Comment révoquer un accès ?

Retirez-le dans votre profil, sous « API d'automatisation ». Il perd sa validité immédiatement ; les requêtes en cours de l'assistant échouent ensuite.

Connecter un assistant IA Commander un serveur Ouvrir le guide technique