Railway MCP Server

Le Railway MCP Server est un serveur Model Context Protocol (MCP) qui permet une interaction en langage naturel avec vos projets et votre infrastructure Railway. Demandez à votre IDE ou assistant IA de créer des projets, déployer des templates, gérer des environnements, récupérer des variables, redéployer des services, et bien plus.

Railway propose deux moyens de connexion :

• MCP local — s'exécute via la CLI Railway sur votre machine. Recommandé pour la plupart des workflows d'agents de codage, car il partage l'authentification et le contexte projet de la CLI.
• MCP distant — un point de terminaison hébergé à mcp.railway.com. Aucune installation locale ni CLI requise ; les clients s'authentifient via OAuth dans le navigateur.

Démarrage rapide

Installez la CLI Railway et configurez la prise en charge de l'agent — compétences, MCP et authentification — en une seule commande. Basculez les options pour adapter la commande à ce que vous souhaitez configurer :

Si la CLI est déjà installée, ignorez l'amorçage et exécutez :

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

Lisez la suite pour la configuration manuelle par éditeur, la liste des outils disponibles et les considérations de sécurité.

Configuration par éditeur

Si vous préférez câbler un éditeur manuellement — ou si vous voulez voir exactement ce que railway mcp install écrit — utilisez le bouton pour basculer entre la configuration stdio locale et la configuration HTTP distante :

railway mcp install fusionne l'entrée du serveur Railway dans les configurations existantes sans supprimer les autres serveurs MCP. Réexécutez-le à tout moment pour mettre à jour.

Comprendre MCP

Le Model Context Protocol (MCP) définit une norme sur la manière dont les applications d'IA (hôtes) peuvent interagir avec des outils externes et des sources de données via une architecture client-serveur.

• Hôtes : Applications telles que Cursor, VS Code, Claude Code ou Windsurf qui se connectent aux serveurs MCP.
• Clients : La couche au sein des hôtes qui maintient des connexions individuelles avec les serveurs MCP.
• Serveurs : Programmes autonomes (comme le Railway MCP Server) qui exposent des outils et des workflows pour gérer des systèmes externes.

Le Railway MCP Server local traduit les demandes en langage naturel en workflows CLI alimentés par la CLI Railway. Le serveur MCP distant s'exécute sur l'infrastructure de Railway et s'authentifie via OAuth.

Prérequis

• MCP local — installez et authentifiez la CLI Railway.
• MCP distant — un compte Railway. Aucune installation locale requise.

Exemples d'utilisation

• Créer et déployer une nouvelle application

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

• Déployer à partir d'un template

  Deploy a Postgres database
  

• Récupérer les variables d'environnement

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

• Déboguer un déploiement en échec (outil distant uniquement railway-agent)

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

• Redéployer un service

  Redeploy my api service in the production environment
  

Outils MCP disponibles

Le Railway MCP Server fournit un ensemble d'outils soigneusement sélectionnés. Votre assistant IA les appelle automatiquement en fonction du contexte de votre demande.

MCP local

Le serveur local s'exécute via la CLI Railway et expose un ensemble plus large d'outils CRUD :

• Statut
  • check-railway-status — vérifier l'installation de la CLI et l'authentification
• Projets et services
  • list-projects, create-project-and-link
  • list-services, link-service
  • deploy — déployer un service
  • deploy-template — déployer à partir de la bibliothèque de templates Railway
• Environnements
  • create-environment, link-environment
• Configuration
  • list-variables, set-variables
  • generate-domain
• Observabilité
  • get-logs

MCP distant

Le serveur distant expose un ensemble ciblé d'outils ainsi qu'un point d'entrée d'agent puissant. Pour toute opération complexe, déléguez à railway-agent.

• Compte
  • whoami
• Projets
  • list-projects, create-project, list-services
• Déploiements
  • redeploy
  • accept-deploy — valider les modifications en attente et déployer (destructeur ; les clients demandent une confirmation)
• Agent
  • railway-agent — transmettre une demande en langage naturel à l'agent IA de Railway pour des opérations en plusieurs étapes comme l'analyse de logs, le débogage et la configuration de services

Considérations de sécurité

Le Railway MCP Server exécute des commandes CLI ou invoque les API Railway en votre nom. Les opérations destructrices sont intentionnellement exclues de la liste d'outils du serveur local, mais vous devez tout de même :

• Examiner les actions demandées par le LLM avant de les approuver, en particulier les actions destructrices (redeploy, accept-deploy, railway-agent).
• Restreindre l'accès pour garantir que seuls les utilisateurs de confiance peuvent invoquer le serveur MCP.
• Éviter les risques en production en limitant l'utilisation à des environnements non critiques lorsque cela est possible.

Pour le serveur distant spécifiquement :

• Portée OAuth. Lorsque vous donnez votre consentement, vous choisissez les espaces de travail et les projets auxquels le client peut accéder. Les jetons sont de courte durée et peuvent être révoqués depuis les paramètres de votre compte Railway.
• Les actions destructrices sont marquées au niveau du protocole. Les clients qui respectent ces indications demanderont une confirmation.
• Les jetons de projet ne sont pas acceptés. Le serveur MCP distant nécessite une identité utilisateur pour la facturation et les pistes d'audit.

Demandes de fonctionnalités

Le Railway MCP Server est un travail en cours. Nous ajoutons activement plus d'outils et de fonctionnalités. Si vous avez une demande de fonctionnalité, laissez vos commentaires sur ce post Central Station.