MCP para agentes de IA

Railyard corre un servidor de Model Context Protocol en https://app.railyard.run/api/mcp, sobre HTTP con streaming. Usa los mismos tokens de API que la CLI y la REST API, así que un agente puede hacer exactamente lo que su token permite y nada más.

Conecta un agente

Crea un token en Settings → Team → API tokens. Usa un token de read si el agente solo necesita mirar. Luego:

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

Cualquier otro cliente MCP que hable HTTP con streaming y pueda enviar un encabezado Authorization funciona igual.

Herramientas

Herramienta	Token	Qué hace
list_servers	read	Los servidores del equipo
list_apps	read	Las apps del equipo
get_app	read	Los detalles de una app
app_logs	read	Las líneas de log recientes de una app (100 por defecto, hasta 500)
deploy_app	write	Despliega una app, con las mismas reglas de aprobación y límite de tasa que el panel
restart_app	write	Reinicia una app
set_env	write	Define una variable de entorno (se aplica en el siguiente despliegue)
unset_env	write, approval	Elimina una variable
delete_app	write, approval	Elimina una app

Aprobaciones

Eliminar una variable o eliminar una app nunca se ejecuta directamente desde un agente. Se crea una solicitud en la página Approvals, que también aparece en el panel, y no cambia nada hasta que un admin del equipo la aprueba. Aprobarla ejecuta la acción y registra el resultado. Rechazarla la descarta.

Buenas prácticas

• Dale a cada agente su propio token con fecha de expiración, y revócalo cuando termines.
• Usa un token de read para agentes que solo responden preguntas (“¿por qué el checkout está lento?”).
• Los despliegues que inicia un agente pasan por la aprobación de despliegue y el límite de tasa de la app como cualquier otro.

Límites

El servidor MCP cubre las acciones de arriba. Cualquier otra cosa, como servidores, dominios o bases de datos, pasa por la REST API o la CLI.