Railway MCP

Le Serveur MCP Railway 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 les environnements, récupérer des variables, redéployer des services, et bien plus encore.

Railway propose deux moyens de connexion :

• MCP Local — s'exécute via la CLI Railway sur votre machine. Recommandé pour la plupart des flux de travail avec agents de codage, car il partage l'authentification et le contexte de 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 des agents — compétences, MCP et authentification — en une seule commande. Utilisez 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 configurer un éditeur manuellement — ou si vous voulez voir exactement ce que railway mcp install écrit — utilisez le sélecteur 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 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 Serveur MCP Railway) qui exposent des outils et des flux de travail pour gérer des systèmes externes.

Le Serveur MCP Railway local traduit les requêtes en langage naturel en flux de travail 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
  

• Gérer les indicateurs de fonctionnalités

  List feature flags for project <projectId>
  

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

Outils MCP disponibles

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

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 et l'authentification de la CLI
• 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
• Indicateurs de fonctionnalités
  • list-feature-flags, get-feature-flag
  • set-feature-flag, delete-feature-flag (admin ; la suppression destructive est signalée au niveau du protocole)
• Déploiements
  • redeploy
  • accept-deploy — valider les modifications en attente et déployer (destructif ; les clients demandent une confirmation)
• Agent
  • railway-agent — transmettre une requête en langage naturel à l'agent IA de Railway pour des opérations en plusieurs étapes telles que l'analyse de logs, le débogage et la configuration de services

Considérations de sécurité

Le Serveur MCP Railway exécute des commandes CLI ou invoque les API Railway en votre nom. Les opérations destructives 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 destructives (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 aux environnements non critiques lorsque cela est possible.

Pour le serveur distant en particulier :

• 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 destructives sont signalé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 Serveur MCP Railway est un travail en cours. Nous ajoutons activement de nouveaux outils et fonctionnalités. Si vous avez une demande de fonctionnalité, laissez vos commentaires sur ce post Central Station.