Skip to main content

Claude Code · Codex

게임 서버에 네가 하려는 일을 말해줘.

Claude Code나 Codex를 네 서버에 연결해봐. AI 어시스턴트에게 플러그인 설치, 설정 조정, 시작 문제 조사를 맡길 수 있어. 어떤 서버에 접근할 수 있는지는 네가 직접 정해.

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