Railway MCP Server

Der Railway MCP Server verbindet KI-Assistenten mit Railway, einer Cloud-Plattform für das Bereitstellen von Anwendungen und Datenbanken. Statt zwischen Editor, Terminal und Dashboard zu wechseln, sagen Sie dem Assistenten, was Sie brauchen: „Lege ein neues Projekt an“, „Welche Services laufen in diesem Projekt?“ oder „Stoße ein neues Deployment an“. Der Assistent ruft dafür die passenden Werkzeuge des Servers auf und berichtet das Ergebnis. Der Server wird von Railway selbst betrieben und in der offiziellen Dokumentation beschrieben. Seine Stärke liegt in der Nähe zum Entwicklungsalltag: Wer Railway ohnehin nutzt, kann Routineaufgaben direkt aus Claude Code, Cursor, VS Code oder Windsurf erledigen.

Was ist der Railway MCP Server?

Der Server implementiert das Model Context Protocol (MCP), einen offenen Standard, über den KI-Anwendungen Werkzeuge ansprechen. Er läuft gehostet unter https://mcp.railway.com, eine lokale Installation des Servers ist für den Normalfall nicht nötig. Laut Dokumentation kann der Assistent damit Projekte erstellen, Vorlagen bereitstellen, Umgebungen verwalten, Variablen abrufen und Services neu ausrollen. Das frühere Open-Source-Repository des Servers auf GitHub ist inzwischen archiviert; maßgeblich ist die gehostete Variante, die die Dokumentation beschreibt.

Welche Werkzeuge der gehostete Server bereitstellt

Die Dokumentation nennt für den gehosteten Server mehrere Gruppen. Mit whoami zeigt der Assistent das angemeldete Konto. Mit list-projects, create-project und list-services verschaffen Sie sich einen Überblick und legen Projekte an. Für Feature-Flags gibt es list-feature-flags, get-feature-flag, set-feature-flag und delete-feature-flag. Für Deployments stehen redeploy und accept-deploy bereit, dazu ein Werkzeug namens railway-agent für mehrschrittige Aufgaben. Daneben existiert ein lokaler Server, den die Railway-CLI mit railway mcp local startet; er hat laut Dokumentation einen anderen, größeren Werkzeugsatz, unter anderem für Variablen, Domains, Netzwerk, Vorlagen, Speicher und Beobachtbarkeit.

Einrichtung und Anmeldung

Der empfohlene Weg ist der Befehl railway setup agent; er verbindet den Assistenten über die Railway-CLI und setzt laut Dokumentation die CLI-Version 5.44.0 oder neuer voraus. Dabei nutzt der Server Ihre bestehende railway login-Sitzung, sodass in der Editor-Konfiguration kein langlebiger Zugangsschlüssel von Railway liegt. Alternativ verbindet railway setup agent --oauth direkt über OAuth mit dem gehosteten Server; die Tokens sind dann kurzlebig und in den Kontoeinstellungen widerrufbar, und Sie legen fest, auf welche Workspaces und Projekte der Zugriff reicht. Wer die Konfiguration für einen bestimmten Editor schreiben möchte, nutzt railway mcp install, auch mit der Option --local für den lokalen Server. Projekt-Tokens akzeptiert der Server nicht, weil er eine Nutzeridentität verlangt.

Sicherheit und Grenzen

Der Server kann Dinge verändern, nicht nur lesen. Die Dokumentation markiert zerstörerische Werkzeuge auf Protokollebene, sodass Clients, die diese Hinweise beachten, vor der Ausführung nachfragen. Sie rät außerdem, vom Sprachmodell angeforderte Aktionen vor der Freigabe zu prüfen, besonders bei redeploy, accept-deploy und railway-agent, den Zugriff auf vertrauenswürdige Personen zu beschränken und den Server möglichst nur mit unkritischen Umgebungen zu verwenden. Ein Neuausrollen kann eine laufende Produktionsanwendung kurzzeitig beeinträchtigen. Beschränken Sie den OAuth-Zugriff deshalb auf die Projekte, die der Assistent wirklich braucht.

Kosten

Die Dokumentation nennt keine gesonderte Gebühr für den MCP-Server. Die Nutzung zählt zu Ihrem Railway-Konto. Laut Preisseite arbeitet Railway mit nutzungsbasierter Abrechnung, bei der Rechenzeit, Arbeitsspeicher und Speicherplatz sekundengenau erfasst werden. Es gibt eine kostenlose Testphase mit einmaligem Guthaben ohne Kreditkarte, einen Free-Plan, kostenpflichtige Pläne für Einzelpersonen und Teams sowie Enterprise mit individuellen Konditionen. Aktuelle Beträge stehen auf der offiziellen Preisseite. Zur Lizenz des gehosteten Servers macht die Dokumentation keine Angaben.

Für wen lohnt sich der Railway MCP Server?

Er lohnt sich für Entwicklerinnen und Entwickler, die ihre Anwendungen bereits auf Railway betreiben und wiederkehrende Aufgaben wie Projektanlage, Statusabfragen oder Neu-Deployments aus dem Chat erledigen wollen. Besonders praktisch ist er, wenn der Assistent ohnehin Code schreibt und das Ergebnis gleich ausgerollt werden soll. Wer Railway nicht nutzt, hat keinen Vorteil, denn der Server ist ein Zugang zur Plattform. Für kritische Produktionsumgebungen sollten Sie die Freigabe jeder schreibenden Aktion bewusst von Hand erteilen.

Ein Railway-Konto, die Railway-CLI ab Version 5.44.0 (für den empfohlenen Weg) oder ein OAuth-fähiger MCP-Client sowie ein MCP-Client wie Claude Code, Cursor, VS Code oder Windsurf.

Der Railway MCP Server läuft gehostet bei Railway. Dieser Ratgeber führt durch Einrichtung, Zugriffsbegrenzung und die ersten Befehle.

Schritt 1: Voraussetzungen

Sie brauchen ein Railway-Konto und einen MCP-Client wie Claude Code, Cursor, VS Code oder Windsurf. Für den empfohlenen Weg muss die Railway-CLI in Version 5.44.0 oder neuer installiert sein.

Schritt 2: Mit der CLI verbinden

Melden Sie sich mit railway login an und führen Sie railway setup agent aus. Der Server nutzt dann Ihre CLI-Sitzung, in der Editor-Konfiguration liegt kein langlebiger Zugangsschlüssel von Railway.

Schritt 3: Mit OAuth verbinden

Wollen Sie ohne CLI-Sitzung arbeiten, nutzen Sie railway setup agent --oauth. Der Client verbindet sich direkt mit https://mcp.railway.com. Die Tokens sind kurzlebig und in den Kontoeinstellungen widerrufbar, und Sie wählen aus, auf welche Workspaces und Projekte der Zugriff reicht.

Schritt 4: Für einen bestimmten Editor einrichten

railway mcp install schreibt die Konfiguration für den gewählten Editor und führt sie mit bestehenden MCP-Einträgen zusammen. Mit railway mcp install --local richten Sie stattdessen den lokalen Server ein, der einen anderen Werkzeugsatz hat.

Erste Befehle

Beginnen Sie lesend: Lassen Sie den Assistenten das Konto, die Projekte und die Services auflisten. Gehen Sie erst danach zu schreibenden Aktionen über, und geben Sie redeploy, accept-deploy und railway-agent immer nur nach eigener Prüfung frei.

railway setup agent

Bestehende railway-login-Sitzung der CLI oder OAuth gegen mcp.railway.com mit kurzlebigen, widerrufbaren Tokens; Projekt-Tokens werden nicht akzeptiert.

Projekte und Services auflisten, Projekte anlegen, Feature-Flags verwalten, Services neu ausrollen und Deployments freigeben; bei OAuth wählbar nach Workspace und Projekt.

Der Server läuft gehostet bei Railway. Ergebnisse von Werkzeugaufrufen gelangen in den Kontext des KI-Clients und damit zum Modellanbieter.

Schreibende Werkzeuge wie redeploy, accept-deploy und railway-agent können laufende Anwendungen beeinflussen; zu weit gefasster Workspace-Zugriff und Variablen mit Geheimnissen im Modellkontext.