Railway MCP Server

Der Railway MCP Server ist ein Model Context Protocol (MCP)-Server, der die Interaktion mit Ihren Railway-Projekten und Ihrer Infrastruktur in natürlicher Sprache ermöglicht. Bitten Sie Ihre IDE oder Ihren KI-Assistenten, Projekte zu erstellen, Vorlagen bereitzustellen, Umgebungen zu verwalten, Variablen abzurufen, Dienste erneut bereitzustellen und vieles mehr.

Railway bietet zwei Verbindungsmöglichkeiten:

• Lokales MCP — läuft über die Railway CLI auf Ihrem Rechner. Empfohlen für die meisten Coding-Agent-Workflows, da es die Authentifizierung und den Projektkontext der CLI teilt.
• Remote-MCP — ein gehosteter Endpunkt unter mcp.railway.com. Keine lokale Installation oder CLI erforderlich; Clients authentifizieren sich über OAuth im Browser.

Schnellstart

Installieren Sie die Railway CLI und konfigurieren Sie die Agent-Unterstützung – Skills, MCP und Authentifizierung – mit einem Befehl. Passen Sie die Optionen an, um den Befehl auf Ihre gewünschte Einrichtung zuzuschneiden:

Wenn die CLI bereits installiert ist, überspringen Sie das Bootstrap und führen Sie aus:

railway setup agent          # local MCP
railway setup agent --remote # remote MCP

Lesen Sie weiter für die manuelle Konfiguration pro Editor, die verfügbare Werkzeugliste und Sicherheitshinweise.

Konfiguration pro Editor

Wenn Sie einen Editor lieber von Hand einrichten möchten – oder genau sehen möchten, was railway mcp install schreibt – verwenden Sie den Umschalter, um zwischen der lokalen stdio-Konfiguration und der Remote-HTTP-Konfiguration zu wechseln:

railway mcp install fügt den Railway-Server-Eintrag in bestehende Konfigurationen ein, ohne andere MCP-Server zu entfernen. Führen Sie es jederzeit erneut aus, um zu aktualisieren.

MCP verstehen

Das Model Context Protocol (MCP) definiert einen Standard dafür, wie KI-Anwendungen (Hosts) über eine Client-Server-Architektur mit externen Werkzeugen und Datenquellen interagieren können.

• Hosts: Anwendungen wie Cursor, VS Code, Claude Code oder Windsurf, die sich mit MCP-Servern verbinden.
• Clients: Die Schicht innerhalb der Hosts, die Eins-zu-eins-Verbindungen mit einzelnen MCP-Servern aufrechterhält.
• Server: Eigenständige Programme (wie der Railway MCP Server), die Werkzeuge und Workflows zur Verwaltung externer Systeme bereitstellen.

Der lokale Railway MCP Server übersetzt Anfragen in natürlicher Sprache in CLI-Workflows, die von der Railway CLI unterstützt werden. Der Remote-MCP-Server läuft auf der Infrastruktur von Railway und authentifiziert sich über OAuth.

Voraussetzungen

• Lokales MCP — Installieren und authentifizieren Sie die Railway CLI.
• Remote-MCP — ein Railway-Konto. Keine lokale Installation erforderlich.

Anwendungsbeispiele

• Neue App erstellen und bereitstellen

  Create a Next.js app in this directory and deploy it to Railway.
  Also assign it a domain.
  

• Aus einer Vorlage bereitstellen

  Deploy a Postgres database
  

• Umgebungsvariablen abrufen

  Pull environment variables for my project and save them to a .env file
  

• Fehlgeschlagenes Deployment debuggen (nur Remote railway-agent-Werkzeug)

  Use the railway agent to figure out why my backend service is
  crashing on deploy
  

• Dienst erneut bereitstellen

  Redeploy my api service in the production environment
  

Verfügbare MCP-Werkzeuge

Der Railway MCP Server bietet einen kuratierten Satz an Werkzeugen. Ihr KI-Assistent ruft diese automatisch basierend auf dem Kontext Ihrer Anfrage auf.

Lokales MCP

Der lokale Server läuft über die Railway CLI und stellt einen breiteren Satz an CRUD-Werkzeugen bereit:

• Status
  • check-railway-status — CLI-Installation und Authentifizierung überprüfen
• Projekte & Dienste
  • list-projects, create-project-and-link
  • list-services, link-service
  • deploy — einen Dienst bereitstellen
  • deploy-template — aus der Railway Template Library bereitstellen
• Umgebungen
  • create-environment, link-environment
• Konfiguration
  • list-variables, set-variables
  • generate-domain
• Observability
  • get-logs

Remote-MCP

Der Remote-Server stellt einen fokussierten Satz an Werkzeugen sowie einen leistungsstarken Agent-Einstiegspunkt bereit. Für komplexe Aufgaben delegieren Sie an railway-agent.

• Konto
  • whoami
• Projekte
  • list-projects, create-project, list-services
• Deployments
  • redeploy
  • accept-deploy — bereitgestellte Änderungen committen und deployen (destruktiv; Clients fordern Bestätigung an)
• Agent
  • railway-agent — eine Anfrage in natürlicher Sprache an den KI-Agenten von Railway für mehrstufige Operationen wie Log-Analyse, Debugging und Dienstkonfiguration übergeben

Sicherheitshinweise

Der Railway MCP Server führt CLI-Befehle aus oder ruft Railway-APIs in Ihrem Namen auf. Destruktive Operationen sind bewusst aus der Werkzeugliste des lokalen Servers ausgeschlossen, dennoch sollten Sie:

• Aktionen überprüfen, die vom LLM angefordert werden, bevor Sie sie genehmigen, insbesondere destruktive (redeploy, accept-deploy, railway-agent).
• Zugriff beschränken, um sicherzustellen, dass nur vertrauenswürdige Benutzer den MCP-Server aufrufen können.
• Produktionsrisiken vermeiden, indem Sie die Nutzung nach Möglichkeit auf unkritische Umgebungen beschränken.

Speziell für den Remote-Server:

• OAuth-Bereichsdefinition. Wenn Sie zustimmen, wählen Sie, auf welche Workspaces und Projekte der Client zugreifen darf. Tokens sind kurzlebig und können in Ihren Railway-Kontoeinstellungen widerrufen werden.
• Destruktive Aktionen sind auf Protokollebene gekennzeichnet. Clients, die diese Hinweise respektieren, werden zur Bestätigung auffordern.
• Projekt-Tokens werden nicht akzeptiert. Der Remote-MCP-Server benötigt eine Benutzeridentität für Abrechnungs- und Audit-Trails.

Funktionswünsche

Der Railway MCP Server ist in Entwicklung. Wir fügen aktiv weitere Werkzeuge und Funktionen hinzu. Wenn Sie einen Funktionswunsch haben, hinterlassen Sie Ihr Feedback in diesem Central Station-Beitrag.