Skip to main content

Claude Code · Codex

告诉你的游戏服务器你想做什么

将 Claude Code 或 Codex 与你的服务器连接起来。让你的助手安装插件、调整设置或排查启动问题。你可以自己决定它能访问哪些服务器。

连接 AI 助手 查看示例

连接功能免费提供。你需要一个兼容的 AI 助手；其提供商可能会收取自己的费用。

你可以从这些任务开始

检查一下我服务器的状态。暂时先不要做任何更改。
把这三名玩家加入白名单。
检查这个插件是否适配我的服务器版本。安装前先问我一下。

以上仅为示例任务：可用功能取决于游戏、套餐以及所授予的权限。

Connected in four steps

连接 Claude Code 或 Codex

选择助手，复制两行命令并在终端运行。随后在浏览器中选择服务器、权限和有效期。

无需复制令牌。

claude mcp add --scope user --transport http ezplayhost https://ezplayhost.com/api/automation/v1/mcp
claude mcp login ezplayhost
使用令牌手动连接

对于不支持浏览器登录的 REST 和 MCP 应用，你仍可创建受限令牌。

Important: this is not a command for your server's game console. Enter it in the terminal on your own computer (Windows: PowerShell, macOS and Linux: Terminal).

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

Codex reads the token from an environment variable. The first line sets it for the current terminal. To keep it permanently, add it to your shell profile.

Important: this is not a command for your server's game console. Enter it in the terminal on your own computer (Windows: PowerShell, macOS and 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

For manual setup, your MCP client must support Streamable HTTP and a configurable bearer token. Clients with OAuth support connect through the browser sign-in instead, without a token.

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

No MCP support? The same actions are available as a plain REST interface with an OpenAPI description.

Important: this is not a command for your server's game console. Enter it in the terminal on your own computer (Windows: PowerShell, macOS and Linux: Terminal).

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

The <TOKEN> placeholder stands for your access. Inside your account the page fills it in automatically.

Good to know

  • For installs, backups and version changes, "accepted" does not mean "finished" yet. The assistant should verify completion through status, inventory and console.
  • File permissions and console commands allow far-reaching changes. If you do not want that, choose the permissions individually in your profile.
  • Account permissions such as email, password and cancellation are never part of the quick path and always have to be confirmed in the browser.
  • You can revoke the access at any time in the tile or in your profile. It becomes invalid immediately.
  • The complete technical guide and the API contract are readable without signing in.

Open the technical guide OpenAPI

查看所有技术功能

What an assistant can do

This is the complete action catalog. Every action sits behind a permission you grant individually when creating the token - whatever you do not grant does not exist for the assistant.

Server & power

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

Players

  • players_list
  • whitelist_read
  • whitelist_add
  • whitelist_remove
  • players_history

Console

  • console_read
  • console_command

Files

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

Backups

  • backups_list
  • backup_create
  • backup_restore
  • backup_delete

Schedules

  • schedules_list
  • schedule_create
  • schedule_update
  • schedule_delete

Configuration

  • config_read
  • config_write

Worlds

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

Versions

  • versions_list
  • version_status
  • version_preview
  • version_change

Server software

  • 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

Server settings

  • settings_read
  • settings_update
  • startup_variables_read
  • startup_variables_update

Metrics and history

  • metrics_current
  • metrics_history

Activity log

  • activity_list

Health and join test

  • health_status
  • join_test_start
  • join_test_status
  • health_crash_diagnosis

Databases

  • databases_list
  • database_create
  • database_delete
  • database_password_rotate

World export and import

  • export_start
  • export_status

Subdomain

  • subdomain_check
  • subdomain_change

Game tools

  • 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

Reinstall

  • server_reinstall

Account

  • 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

What stays under your control

  • Permissions per token: reading, power control, files, console and account are selected separately.
  • Server binding: a token only covers the servers you assign to it, never new ones automatically.
  • Revoke at any time: one click in your profile and the token is invalid everywhere, immediately.
  • Expiry date: you can limit a token to a fixed lifetime from the start.
  • Traceability: every action appears in the server activity log with its timestamp and the token used.
  • Request limits: calls are capped per token, so a misbehaving assistant cannot overrun your server.
  • The token does not belong in a chat: only ever paste it into your assistant's protected credentials field.

automation:unattended Extra permission for unattended execution. Without it, the assistant asks you to confirm these steps in your signed-in account: server software changes, Modpack installation, Modpack updates, server reinstall, world import, subdomain changes and opening a support ticket. Account actions — email address, password, cancellation, deletion — always stay confirmation-bound. Everything else runs directly, within the permissions you granted.

Frequently asked questions

Does the interface cost extra?

No. The Automation API is part of every server and costs nothing on top. You still pay for your server only.

Which assistants work?

MCP clients with Streamable HTTP and a configurable bearer token are supported, for example Codex CLI. Compatibility depends on the application version and configuration. Alternatively, call the same actions through the REST API.

Can the assistant spend money on my behalf?

No. Orders, renewals and payments run exclusively through the checkout in your signed-in account. An assistant token cannot trigger a payment.

What does "without asking" mean?

Account actions — email address, password, cancellation, deletion — always require confirmation. The extra permission allows certain server actions without browser confirmation. Protection points depend on the action; there is no general backup or rollback guarantee. A file backup does not protect external SQL databases.

How do I revoke a token?

Withdraw it in your profile under "Automation API". It loses validity immediately; any request the assistant has in flight fails afterwards.

连接 AI 助手 Order a server Open the technical guide