Railway MCP

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

Railway bietet zwei MCP-Server an:

• Lokaler MCP läuft über die Railway CLI auf Ihrem Rechner und verwendet den lokalen CLI-Kontext.
• Remote-MCP läuft unter mcp.railway.com. Verbinden Sie sich direkt über OAuth oder führen Sie railway mcp proxy aus, um Anmeldedaten aus Ihrer railway login-Sitzung wiederzuverwenden.

Schnellstart

Installieren Sie die Railway CLI und konfigurieren Sie Agent-Fähigkeiten, MCP und Authentifizierung mit 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                  # Local MCP
railway setup agent --remote         # Remote MCP through the CLI proxy
railway setup agent --remote --oauth # Remote MCP 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 lokalem stdio, Remote-MCP über den CLI-Proxy und Remote-MCP mit OAuth 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 mit einzelnen MCP-Servern aufrechterhält.
• Server: Eigenständige Programme (wie der Railway MCP Server), die Tools und Workflows zur Verwaltung externer Systeme bereitstellen.

Der lokale MCP-Server übersetzt Anfragen in natürlicher Sprache in CLI-Workflows, die von der Railway CLI unterstützt werden. Remote-MCP läuft auf der Infrastruktur von Railway und unterstützt OAuth. Der CLI-Proxy bietet einen weiteren Verbindungsweg, indem er Anmeldedaten aus Ihrer railway login-Sitzung an Remote-MCP weitergibt.

Voraussetzungen

Der Server und die Authentifizierungsmethode bestimmen, welche lokalen Tools und Anmeldedaten Sie benötigen.

• Lokaler MCP erfordert eine installierte und authentifizierte Railway CLI.
• Remote-MCP erfordert ein Railway-Konto. Direktes OAuth erfordert keine CLI. Der CLI-Proxy erfordert eine installierte CLI und eine railway login-Sitzung, damit er diese Anmeldedaten wiederverwenden kann.

Beispielverwendung

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

• 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-Tool)

  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
  

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

Lokaler MCP

Lokaler MCP läuft über die Railway CLI und stellt diese Tools bereit:

• 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 Deployments: 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

Remote-MCP

Remote-MCP stellt die folgenden Tools bereit. Verwenden Sie railway-agent für mehrstufige Vorgänge.

• 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 gekennzeichnet)
• Deployments
  • redeploy
  • accept-deploy: gestaffelte Änderungen committen und bereitstellen (destruktiv; Clients fordern zur Bestätigung auf)
• Agent
  • railway-agent: übergeben Sie eine Anfrage in natürlicher Sprache an den KI-Agenten von Railway für mehrstufige Vorgänge wie Log-Analyse, Debugging und Dienstkonfiguration

Sicherheitshinweise

Der Railway MCP Server führt CLI-Befehle aus oder ruft Railway-APIs in Ihrem Namen auf. Lokaler MCP kennzeichnet destruktive Tools mit Hinweisen auf Protokollebene und gibt eine Vorschau zurück, bevor confirm: true erforderlich ist. Sie sollten dennoch:

• Aktionen überprüfen, die vom LLM angefordert werden, bevor Sie sie genehmigen, insbesondere destruktive (remove_service, delete_domain, remove_tcp_proxy, remove_bucket, remove_volume, redeploy, accept-deploy und railway-agent).
• 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.

Für Remote-MCP:

• CLI-Proxy-Authentifizierung. Der Proxy liest und aktualisiert Ihre railway login-Anmeldedaten. Die Editor-Konfiguration enthält keine langlebigen Railway-Anmeldedaten.
• OAuth-Bereichsbegrenzung. Bei direktem OAuth wählen Sie, 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 gekennzeichnet. Clients, die diese Hinweise beachten, fordern zur Bestätigung auf.
• Projekt-Tokens werden nicht akzeptiert. Remote-MCP erfordert eine Benutzeridentität für Abrechnung und Audit-Trails.

Feature-Anfragen

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