Skip to main content

Claude Code · Codex

Diz ao teu servidor de jogos o que pretendes fazer.

Conecta o Claude Code ou o Codex ao teu servidor. Deixa o teu assistente instalar plugins, ajustar configurações ou investigar problemas de inicialização. Tu decides a quais servidores ele pode aceder.

Ligar assistente de IA Ver exemplos

Integração sem custo adicional. Precisas de um assistente de IA compatível; o fornecedor dele pode cobrar custos próprios.

Com estas tarefas podes começar

Verifica o estado do meu servidor. Não alteres nada por enquanto.
Coloca estes três jogadores na whitelist.
Verifica se este plugin é compatível com a versão do meu servidor. Pergunta-me antes de instalar.

Exemplos de tarefas: as funções disponíveis dependem do jogo, do plano e das permissões atribuídas.

Ligado em quatro passos

Ligar o Claude Code ou o Codex

Escolhe o teu assistente, copia ambos os comandos e executa-os no terminal. Depois escolhes o servidor, as permissões e a duração no navegador.

Não precisas de copiar nenhum token.

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

Para aplicações REST e MCP sem início de sessão no navegador, ainda podes criar um token limitado.

Importante: este não é um comando para o console de jogo do teu servidor. Digita-o no terminal do teu próprio computador (Windows: PowerShell, macOS e Linux: Terminal).

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

O Codex lê o token a partir de uma variável de ambiente. A primeira linha define-a para o terminal atual. Para a manteres, adiciona-a ao teu perfil de shell.

Importante: este não é um comando para o console de jogo do teu servidor. Digita-o no terminal do teu próprio computador (Windows: PowerShell, macOS e 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 a configuração manual, o teu cliente MCP tem de suportar Streamable HTTP e um token Bearer próprio. Os clientes com suporte OAuth ligam-se antes através do início de sessão no navegador, sem token.

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

Sem suporte para MCP? As mesmas ações estão disponíveis como interface REST clássica, com descrição OpenAPI.

Importante: este não é um comando para o console de jogo do teu servidor. Digita-o no terminal do teu próprio computador (Windows: PowerShell, macOS e Linux: Terminal).

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

O marcador <TOKEN> representa o teu acesso. Dentro da tua conta, a página preenche-o automaticamente.

Convém saber

  • Em instalações, cópias de segurança e mudanças de versão, «aceite» ainda não significa «concluído». O assistente deve confirmar o resultado através do estado, do inventário e da consola.
  • As permissões de ficheiros e os comandos de consola permitem alterações profundas. Se não quiseres isso, escolhe as permissões uma a uma no teu perfil.
  • As permissões de conta, como e-mail, palavra-passe e cancelamento, nunca fazem parte da via rápida e têm sempre de ser confirmadas no navegador.
  • Podes revogar o acesso a qualquer momento no painel ou no teu perfil. Fica imediatamente inválido.
  • O guia técnico completo e o contrato da API podem ser lidos sem iniciar sessão.

Abrir o guia técnico OpenAPI

Mostrar todas as funções técnicas

O que um assistente pode fazer

Este é o catálogo completo de ações. Cada ação depende de uma permissão que concedes individualmente ao criar o acesso: o que não concederes não existe para o assistente.

Servidor e energia

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

Jogadores

  • players_list
  • whitelist_read
  • whitelist_add
  • whitelist_remove
  • players_history

Consola

  • console_read
  • console_command

Ficheiros

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

Cópias de segurança

  • backups_list
  • backup_create
  • backup_restore
  • backup_delete

Agendamentos

  • schedules_list
  • schedule_create
  • schedule_update
  • schedule_delete

Configuração

  • config_read
  • config_write

Mundos

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

Versões

  • versions_list
  • version_status
  • version_preview
  • version_change

Software do servidor

  • software_catalog
  • software_preview
  • software_change

Plugins e mods

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

Modpacks

  • modpacks_catalog
  • modpack_preview
  • modpack_status
  • modpack_install
  • modpack_update

Pacotes Bedrock

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

Definições do servidor

  • settings_read
  • settings_update
  • startup_variables_read
  • startup_variables_update

Utilização e histórico

  • metrics_current
  • metrics_history

Registo de atividade

  • activity_list

Saúde e teste de ligação

  • health_status
  • join_test_start
  • join_test_status
  • health_crash_diagnosis

Bases de dados

  • databases_list
  • database_create
  • database_delete
  • database_password_rotate

Exportação e importação de mundos

  • export_start
  • export_status

Subdomínio

  • subdomain_check
  • subdomain_change

Ferramentas do jogo

  • 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

Reinstalação

  • server_reinstall

Conta

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

  • support_ticket_create

O que continua nas tuas mãos

  • Permissões por acesso: leitura, comando, ficheiros, consola e conta escolhem-se em separado.
  • Ligação a servidores: um acesso só vale para os servidores que lhe atribuíres, nunca automaticamente para os novos.
  • Revogação a qualquer momento: um clique no teu perfil e o token fica de imediato inválido em todo o lado.
  • Data de validade: podes limitar a duração de um acesso logo à partida.
  • Rastreabilidade: cada ação consta do registo de atividade do servidor, com a hora e o acesso utilizado.
  • Limite de frequência: as chamadas têm um teto por acesso, por isso um assistente com falhas não consegue sobrecarregar o teu servidor.
  • O token não pertence à conversa: introdu-lo apenas no campo protegido de credenciais do teu assistente.

automation:unattended Permissão adicional para execução autónoma. Sem ela, o assistente pede-te para confirmares estes passos na tua conta: mudança de software do servidor, instalação de Modpack, atualização de Modpack, reinstalação do servidor, importação de mundos, alteração de subdomínio e abertura de um pedido de suporte. As ações de conta — endereço de e-mail, palavra-passe, cancelamento, eliminação — exigem sempre confirmação. Todo o resto é executado diretamente, dentro das permissões que concedeste.

Perguntas frequentes

A interface custa mais alguma coisa?

Não. A API de automatização faz parte de cada servidor e não tem custo adicional. Continuas a pagar apenas o teu servidor.

Que assistentes funcionam?

São compatíveis os clientes MCP com Streamable HTTP e um token Bearer configurável, como o Codex CLI. A compatibilidade depende da versão e configuração da aplicação. Também podes invocar as mesmas ações através da API REST.

O assistente pode gastar dinheiro em meu nome?

Não. Encomendas, renovações e pagamentos passam exclusivamente pelo processo de compra na tua conta com sessão iniciada. Um acesso de assistente não consegue iniciar qualquer pagamento.

O que significa «sem perguntar»?

As ações de conta — e-mail, palavra-passe, cancelamento e eliminação — exigem sempre confirmação. A permissão adicional permite certas ações no servidor sem confirmação no navegador. Os pontos de proteção dependem da ação; não existe uma garantia geral de cópia de segurança ou reversão. Uma cópia de ficheiros não protege bases de dados SQL externas.

Como revogo um acesso?

Retira-o no teu perfil, em «API de automatização». Perde a validade de imediato; os pedidos que o assistente tenha em curso falham a seguir.

Ligar assistente de IA Encomendar um servidor Abrir o guia técnico