MCP para agentes de IA

O Railyard roda um servidor Model Context Protocol em https://app.railyard.run/api/mcp, via streamable HTTP. Ele usa os mesmos tokens de API da CLI e da API REST, então um agente só pode fazer exatamente o que o token dele permite, nada além disso.

Conectando um agente

Crie um token em Settings → Team → API tokens. Use um token read se o agente só precisar consultar. Depois:

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_..." } } } }

Qualquer outro cliente MCP que fale streamable HTTP e consiga enviar um header Authorization funciona do mesmo jeito.

Ferramentas

Ferramenta	Token	O que faz
list_servers	read	Os servidores da equipe
list_apps	read	Os apps da equipe
get_app	read	Os detalhes de um app
app_logs	read	As últimas linhas de log de um app (100 por padrão, até 500)
deploy_app	write	Faz deploy de um app, seguindo as mesmas regras de aprovação e limite de taxa do painel
restart_app	write	Reinicia um app
set_env	write	Define uma variável de ambiente (aplicada no próximo deploy)
unset_env	write, aprovação	Remove uma variável
delete_app	write, aprovação	Exclui um app

Aprovações

Remover uma variável ou excluir um app nunca roda direto a partir de um agente. Isso cria uma solicitação na página Approvals, que também aparece no painel, e nada muda até um admin da equipe aprovar. Aprovar executa a ação e registra o resultado. Rejeitar descarta a solicitação.

Boas práticas

• Dê a cada agente seu próprio token com data de expiração, e revogue quando terminar.
• Use um token read para agentes que só respondem perguntas (“por que o checkout está lento?”).
• Deploys que um agente inicia passam pela mesma aprovação de deploy e pelo mesmo limite de taxa do app que qualquer outro.

Limites

O servidor MCP cobre as ações acima. Qualquer outra coisa, como servidores, domínios ou bancos de dados, passa pela API REST ou pela CLI.