MCP für KI-Agenten

Railyard betreibt einen Model Context Protocol-Server unter https://app.railyard.run/api/mcp, über Streamable HTTP. Er nutzt dieselben API-Tokens wie CLI und REST-API, sodass ein Agent genau das tun kann, was sein Token erlaubt, und nicht mehr.

Einen Agenten verbinden

Erstelle einen Token unter Settings → Team → API tokens. Nutze einen read-Token, wenn der Agent nur schauen muss. Dann:

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

Jeder andere MCP-Client, der Streamable HTTP spricht und einen Authorization-Header senden kann, funktioniert genauso.

Tools

Tool	Token	Was es tut
list_servers	read	Die Server des Teams
list_apps	read	Die Apps des Teams
get_app	read	Details einer App
app_logs	read	Die letzten Log-Zeilen einer App (standardmäßig 100, bis zu 500)
deploy_app	write	Eine App deployen, über dieselben Freigabe-Regeln und das Rate-Limit wie das Dashboard
restart_app	write	Eine App neu starten
set_env	write	Eine Umgebungsvariable setzen (wirkt beim nächsten Deploy)
unset_env	write, approval	Eine Variable entfernen
delete_app	write, approval	Eine App löschen

Freigaben

Das Entfernen einer Variable oder das Löschen einer App läuft nie direkt von einem Agenten aus. Es erstellt eine Anfrage auf der Approvals-Seite, die auch im Dashboard angezeigt wird, und ändert nichts, bis ein Team-Admin sie freigibt. Freigeben führt die Aktion aus und protokolliert das Ergebnis. Ablehnen verwirft sie.

Gute Gewohnheiten

• Gib jedem Agenten seinen eigenen Token mit Ablaufdatum, und widerrufe ihn, wenn du fertig bist.
• Nutze einen read-Token für Agenten, die nur Fragen beantworten (“warum ist der Checkout langsam?”).
• Deploys, die ein Agent anstößt, durchlaufen dieselbe Deploy-Freigabe und dasselbe Rate-Limit wie jeder andere.

Grenzen

Der MCP-Server deckt die obigen Aktionen ab. Alles andere, etwa Server, Domains oder Datenbanken, läuft über die REST-API oder die CLI.