Railway MCP

npx add-mcp 'https://mcp.railway.com'

Der Railway MCP Server implementiert das Model Context Protocol (MCP). Es ermöglicht KI-Assistenten, Projekte zu erstellen, Vorlagen bereitzustellen, Umgebungen zu verwalten, Variablen abzurufen und Dienste erneut bereitzustellen.

Der Server läuft unter mcp.railway.com. Verbinden Sie sich auf eine von zwei Arten:

• Über die CLI (Standard). Der Befehl railway mcp verbindet Ihren Editor mit mcp.railway.com über die Railway CLI und verwendet dabei Ihre railway login-Anmeldedaten, sodass keine zweite Authentifizierung erforderlich ist.
• Mit OAuth. Editoren, die OAuth unterstützen, verbinden sich direkt mit https://mcp.railway.com, ohne die CLI.

Hinweis: Für die Verbindung über die CLI ist Version 5.44.0 oder höher der CLI erforderlich.

Schnellstart

Installieren Sie die Railway CLI und konfigurieren Sie Agent-Fähigkeiten, MCP und Authentifizierung in einem einzigen Befehl. Wählen Sie die Optionen aus, um den Einrichtungsbefehl zu generieren:

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

railway setup agent          # connect through the CLI (default)
railway setup agent --oauth  # connect with OAuth

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

Konfiguration pro Editor

Wenn Sie einen Editor lieber manuell konfigurieren möchten oder prüfen wollen, was railway mcp install schreibt, verwenden Sie den Selektor, um zwischen der CLI-Verbindung, OAuth und dem lokalen Ausführen des Servers zu wechseln:

railway mcp install fügt den Railway-Servereintrag 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 Tools und Datenquellen interagieren können.

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

Der Railway MCP-Server läuft auf der Infrastruktur von Railway. Der Befehl railway mcp verbindet sich über stdio mit ihm und hängt Anmeldedaten aus Ihrer railway login-Sitzung an jede Anfrage an. Editoren, die OAuth unterstützen, verbinden sich stattdessen direkt.

Voraussetzungen

Für die Verbindung mit dem Railway MCP-Server ist ein Railway-Konto erforderlich. Die Standard-CLI-Verbindung erfordert außerdem eine installierte Railway CLI und eine railway login-Sitzung, damit diese Anmeldedaten wiederverwendet werden können. OAuth erfordert keine CLI.

Beispielverwendung

Verwenden Sie Aufforderungen, die das gewünschte Railway-Ergebnis beschreiben, das der Agent erzielen soll.

• Eine 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
  

• Eine fehlgeschlagene Bereitstellung debuggen (verwendet das Tool railway-agent)

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

• Einen Dienst erneut bereitstellen

  Redeploy my api service in the production environment
  

• Feature-Flags verwalten

  List feature flags for project <projectId>
  

  Set the checkout-v2 feature flag to true on project <projectId>
  

Verfügbare MCP-Tools

Der Railway MCP-Server stellt die folgenden Tools bereit. Ihr KI-Assistent wählt Tools basierend auf Ihrer Anfrage aus. Verwenden Sie railway-agent für mehrstufige Operationen.

• Konto
  • whoami
• Projekte
  • list-projects, create-project, list-services
• Feature-Flags
  • list-feature-flags, get-feature-flag
  • set-feature-flag, delete-feature-flag (Admin; destruktives Löschen ist auf Protokollebene markiert)
• Bereitstellungen
  • redeploy
  • accept-deploy: Staging-Änderungen committen und bereitstellen (destruktiv; Clients fordern eine Bestätigung an)
• Agent
  • railway-agent: eine natürlichsprachliche Anfrage an den KI-Agenten von Railway für mehrstufige Operationen wie Log-Analyse, Debugging und Dienstkonfiguration übergeben

Den Server lokal ausführen

Die CLI enthält auch einen prozessinternen MCP-Server für Maschinen, die mcp.railway.com nicht erreichen können, z. B. in Netzwerken mit eingeschränktem ausgehendem Datenverkehr. Starten Sie ihn mit railway mcp local oder schreiben Sie die Konfiguration für unterstützte Editoren mit railway mcp install --local. Er kommuniziert direkt mit der Railway-API über Ihre CLI-Anmeldedaten, markiert destruktive Tools mit Hinweisen auf Protokollebene und gibt eine Vorschau zurück, bevor confirm: true erforderlich ist.

Der lokale Server stellt einen anderen Tool-Satz bereit als mcp.railway.com:

• Konto: whoami
• Projekte und Dienste: list_workspaces, list_projects, create_project, list_services, create_service, remove_service, connect_service_source, disconnect_service_source, link_service, get_service_config, update_service und scale_service
• Umgebungen und Bereitstellungen: create_environment, link_environment, environment_status, list_deployments und deploy
• Variablen: list_variables, set_variables und add_reference_variable
• Domains: generate_domain, list_domains, domain_status, update_domain, delete_domain und retry_domain_certificate
• Netzwerk: list_tcp_proxies, get_tcp_proxy, create_tcp_proxy, remove_tcp_proxy, private_network_status und private_network_update
• Vorlagen: search_templates und deploy_template
• Speicher: create_bucket, remove_bucket, create_volume, update_volume und remove_volume
• Beobachtbarkeit: get_logs, service_metrics, http_requests, http_error_rate und http_response_time
• Dokumentation: docs_search und docs_fetch

Sicherheitshinweise

Der Railway MCP-Server ruft Railway-APIs in Ihrem Namen auf. Beachten Sie die folgenden Punkte:

• CLI-Authentifizierung. Der Befehl railway mcp liest und aktualisiert Ihre railway login-Anmeldedaten. Die Editor-Konfiguration enthält keine langlebigen Railway-Anmeldedaten.
• OAuth-Bereichsbegrenzung. Mit OAuth wählen Sie aus, auf welche Workspaces und Projekte der Client zugreifen kann. Tokens sind kurzlebig und können in Ihren Railway-Kontoeinstellungen widerrufen werden.
• Destruktive Aktionen sind auf Protokollebene markiert. Clients, die diese Hinweise respektieren, fordern eine Bestätigung an.
• Projekt-Tokens werden nicht akzeptiert. Der Server erfordert eine Benutzeridentität für Abrechnung und Prüfprotokolle.

Sie sollten außerdem:

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

Feature-Anfragen

Teilen Sie Feature-Anfragen im Beitrag Railway MCP Server Central Station mit.