Zum Inhalt springen

Claude Code · Codex

Sag deinem Gameserver, was du vorhast.

Verbinde Claude Code oder Codex mit deinem Server. Lass deinen Assistenten Plugins installieren, Einstellungen anpassen oder Startprobleme untersuchen. Du bestimmst, auf welche Server er zugreifen darf.

Anbindung ohne Aufpreis. Du benötigst einen kompatiblen KI-Assistenten; dessen Anbieter kann eigene Kosten berechnen.

Mit diesen Aufgaben kannst du starten

Prüfe den Status meines Servers. Ändere zunächst nichts.
Setze diese drei Spieler auf die Whitelist.
Prüfe, ob dieses Plugin zu meiner Serverversion passt. Frage mich vor der Installation.

Beispielaufträge: Verfügbare Funktionen hängen vom Spiel, Tarif und den vergebenen Rechten ab.

In vier Schritten verbunden

Claude Code oder Codex verbinden

Wähle deinen Assistenten, kopiere beide Befehle und führe sie im Terminal aus. Danach wählst du im Browser Server, Rechte und Laufzeit.

Du musst keinen Token kopieren.

claude mcp add --scope user --transport http ezplayhost https://ezplayhost.com/api/automation/v1/mcp
claude mcp login ezplayhost
Manuell mit Token verbinden

Für REST und MCP-Anwendungen ohne Browser-Anmeldung kannst du weiterhin einen begrenzten Token erstellen.

Wichtig: Das ist kein Befehl für die Spielkonsole deines Servers. Du gibst ihn im Terminal deines eigenen Computers ein (Windows: PowerShell, macOS und Linux: Terminal).

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

Codex liest den Token aus einer Umgebungsvariable. Die erste Zeile setzt sie für das aktuelle Terminal. Soll sie dauerhaft gelten, gehört sie in dein Shell-Profil.

Wichtig: Das ist kein Befehl für die Spielkonsole deines Servers. Du gibst ihn im Terminal deines eigenen Computers ein (Windows: PowerShell, macOS und 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

Für die manuelle Einrichtung muss dein MCP-Client Streamable HTTP und einen eigenen Bearer-Token unterstützen. Clients mit OAuth-Unterstützung verbinden sich stattdessen über die Anmeldung im Browser, ohne Token.

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

Ohne MCP-Unterstützung geht es auch klassisch: dieselben Aktionen liegen als REST-Schnittstelle mit OpenAPI-Beschreibung bereit.

Wichtig: Das ist kein Befehl für die Spielkonsole deines Servers. Du gibst ihn im Terminal deines eigenen Computers ein (Windows: PowerShell, macOS und Linux: Terminal).

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

Der Platzhalter <TOKEN> steht für deinen Zugang. In deinem Konto setzt die Seite ihn automatisch ein.

Gut zu wissen

  • „Angenommen" heißt bei Installationen, Sicherungen und Versionswechseln noch nicht „fertig". Der Assistent soll den Abschluss über Status, Bestand und Konsole prüfen.
  • Dateirechte und Konsolenbefehle erlauben weitreichende Änderungen. Wer das nicht möchte, wählt im Profil die Rechte einzeln aus.
  • Kontorechte wie E-Mail, Passwort und Kündigung sind im schnellen Weg nie enthalten und bleiben immer im Browser zu bestätigen.
  • Den Zugang widerrufst du jederzeit in der Kachel oder im Profil. Er ist dann sofort ungültig.
  • Die vollständige technische Anleitung und der API-Vertrag sind ohne Anmeldung lesbar.

Technische Anleitung öffnen OpenAPI

Alle technischen Funktionen anzeigen

Was ein Assistent übernehmen kann

Das ist der vollständige Aktionskatalog. Jede Aktion hängt an einem Recht, das du beim Anlegen des Zugangs einzeln freigibst – was du nicht freigibst, existiert für den Assistenten nicht.

Server & Strom

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

Spieler

  • players_list
  • whitelist_read
  • whitelist_add
  • whitelist_remove
  • players_history

Konsole

  • console_read
  • console_command

Dateien

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

Sicherungen

  • backups_list
  • backup_create
  • backup_restore
  • backup_delete

Zeitpläne

  • schedules_list
  • schedule_create
  • schedule_update
  • schedule_delete

Konfiguration

  • config_read
  • config_write

Welten

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

Versionen

  • versions_list
  • version_status
  • version_preview
  • version_change

Serversoftware

  • software_catalog
  • software_preview
  • software_change

Plugins & Mods

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

Modpacks

  • modpacks_catalog
  • modpack_preview
  • modpack_status
  • modpack_install
  • modpack_update

Bedrock-Packs

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

Servereinstellungen

  • settings_read
  • settings_update
  • startup_variables_read
  • startup_variables_update

Auslastung und Verlauf

  • metrics_current
  • metrics_history

Aktivitätsprotokoll

  • activity_list

Gesundheit und Join-Test

  • health_status
  • join_test_start
  • join_test_status
  • health_crash_diagnosis

Datenbanken

  • databases_list
  • database_create
  • database_delete
  • database_password_rotate

Welt-Export und -Import

  • export_start
  • export_status

Subdomain

  • subdomain_check
  • subdomain_change

Spiel-Werkzeuge

  • 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

Neuinstallation

  • server_reinstall

Konto

  • 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

Support-Tickets

  • support_ticket_create

Was du in der Hand behältst

  • Rechte pro Zugang: Lesen, Steuern, Dateien, Konsole und Konto sind getrennt wählbar.
  • Server-Bindung: Ein Zugang gilt nur für die Server, die du ihm zuweist – nie automatisch für neue.
  • Widerruf jederzeit: Ein Klick im Profil, und der Token ist sofort und überall ungültig.
  • Ablaufdatum: Du kannst einen Zugang von vornherein zeitlich begrenzen.
  • Nachvollziehbarkeit: Jede Aktion steht mit Zeitpunkt und Zugang im Aktivitätsprotokoll des Servers.
  • Begrenzte Aufrufrate: Anfragen sind pro Zugang gedeckelt, ein fehlerhafter Assistent kann den Server nicht überrennen.
  • Der Token gehört nicht in den Chat: Trage ihn nur in das geschützte Zugangsfeld deines Assistenten ein.

automation:unattended Zusätzliches Recht für unbeaufsichtigte Ausführung. Ohne dieses Recht lässt der Assistent folgende Schritte von dir im angemeldeten Konto bestätigen: Wechsel der Serversoftware, Modpack-Installation, Modpack-Update, Neuinstallation des Servers, Weltimport, Subdomainwechsel und das Anlegen eines Support-Tickets. Kontoaktionen – E-Mail, Passwort, Kündigung, Löschung – bleiben immer bestätigungspflichtig. Alles Übrige führt der Assistent direkt aus, im Rahmen der Rechte, die du ihm gegeben hast.

Häufige Fragen

Kostet die Schnittstelle extra?

Nein. Die Automatisierungs-API gehört zu jedem Server und kostet nichts zusätzlich. Du zahlst weiterhin nur deinen Server.

Welche Assistenten funktionieren?

Geeignet sind MCP-Clients mit Streamable HTTP und konfigurierbarem Bearer-Token, zum Beispiel Codex CLI. Ob deine Anwendung das unterstützt, hängt von ihrer Version und Einrichtung ab. Alternativ lassen sich dieselben Aktionen über die REST-API aufrufen.

Kann der Assistent in meinem Namen Geld ausgeben?

Nein. Bestellungen, Verlängerungen und Zahlungen laufen ausschließlich über den Checkout in deinem angemeldeten Konto. Ein Zugang für den Assistenten kann keine Zahlung auslösen.

Was heißt „ohne Rückfrage"?

Kontoaktionen – E-Mail-Adresse, Passwort, Kündigung, Löschung – bleiben immer bestätigungspflichtig. Das zusätzliche Recht erlaubt bestimmte Serveraktionen ohne Browserbestätigung. Schutzpunkte gelten je nach Aktion; eine allgemeine Sicherungs- oder Rückabwicklungsgarantie gibt es nicht. Ein Dateibackup schützt keine externen SQL-Datenbanken.

Wie widerrufe ich einen Zugang wieder?

Im Profil unter „Automatisierungs-API" den Zugang zurückziehen. Er verliert sofort seine Gültigkeit; laufende Anfragen des Assistenten schlagen danach fehl.