Agentes de IA

Deixe seu agente de código fazer o deploy.

O Railyard tem um servidor MCP embutido. Seu agente consegue ver suas apps, ler os logs, fazer deploy e reiniciar, com um token cujo alcance você define. Qualquer coisa destrutiva espera uma pessoa aprovar.

Servidor MCP

Nove ferramentas em um só endpoint.

POST https://app.railyard.run/api/mcp fala o Model Context Protocol (JSON-RPC sobre HTTP em streaming) e se autentica com um token de API do Railyard como header Bearer. Ele só vê a equipe à qual esse token pertence.

FerramentaO que fazPrecisa de
list_servers Os servidores da equipe com status, provedor, carga e atualizações de segurança pendentes leitura
list_apps As apps da equipe com status, URL, servidor e ambiente leitura
get_app Uma app: status, URL, domínios, nomes das variáveis e deploys recentes leitura
app_logs As linhas de log recentes de uma app, até 500 leitura
deploy_app Builda e faz o deploy do último commit da app escrita
restart_app Reinicia os containers em execução da app escrita
set_env Define uma variável, aplicada no próximo deploy escrita
unset_env Remove uma variável escrita + aprovação
delete_app Exclui uma app e seus dados escrita + aprovação

Conectar

Adicione ao seu agente.

Crie um token de API nas configurações da equipe e depois cole no lugar de rly_....

Claude Code
claude mcp add --transport http railyard https://app.railyard.run/api/mcp \
  --header "Authorization: Bearer rly_..."
Cursor · .cursor/mcp.json
{
  "mcpServers": {
    "railyard": {
      "url": "https://app.railyard.run/api/mcp",
      "headers": {
        "Authorization": "Bearer rly_..."
      }
    }
  }
}

Barreiras de segurança

Tokens com alcance limitado, aprovações humanas.

  • Um token de leitura consegue listar servidores e apps, mostrar uma app e ler seus logs. Nada além disso.
  • Um token de escrita também consegue fazer deploy, reiniciar e definir variáveis.
  • Os tokens podem expirar, são revogados um por vez e ficam guardados só como hash.
  • Deploys que um agente inicia aparecem marcados como vindos do MCP no histórico de deploys.

> Faça o deploy de storefront e verifique se está saudável

→ list_apps

storefront · running · bold-moose

→ deploy_app storefront

deploy #42 concluído · health check ok

→ app_logs storefront

100 linhas, sem erros

> Remova a variável STRIPE_TEST_KEY

→ unset_env storefront STRIPE_TEST_KEY

esperando um humano aprovar isso na Railyard

Shell e HTTP

A CLI e a API REST também funcionam.

Agentes que executam comandos de shell podem usar a mesma CLI que você usa, e qualquer coisa pode chamar a API REST com os mesmos tokens. Erros de API saem com código diferente de zero, e railyard run sai com o próprio código do comando remoto, para que um agente saiba quando algo falhou.

Referência da CLI → Referência da API →

terminal
railyard login https://app.railyard.run
railyard deploy shop --follow
railyard logs shop --follow --process web
railyard run shop -- bin/rails db:migrate
railyard rollback shop 218

Seus próprios servidores

As experiências do agente rodam em servidores que você já paga.

Agentes fazem deploy com frequência e testam coisas. Numa plataforma que cobra por serviço ou por uso, cada experiência é mais uma linha na fatura. No Railyard, as cópias de staging e as tentativas de um agente são containers em servidores que você já paga. As cópias de staging e os dados que elas guardam ficam nos seus próprios servidores, e você pode cortar o acesso do agente revogando um único token.

Faça o deploy do seu primeiro app em um servidor que é seu.

Conecte uma máquina com um host, um usuário e uma chave SSH, ou deixe a Railyard criar uma na sua conta de nuvem. Ela instala o resto e acompanha até a app entrar no ar.

Plano grátis, sem cartão, e 14 dias de Pro para cada equipe nova. Um preço fixo por equipe.