Railway MCP

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

Le serveur Railway MCP implémente le Model Context Protocol (MCP). Il permet aux assistants IA de créer des projets, déployer des modèles, gérer des environnements, récupérer des variables et redéployer des services.

Le serveur s'exécute à mcp.railway.com. Connectez-vous de deux manières :

• Via le CLI (par défaut). La commande railway mcp connecte votre éditeur à mcp.railway.com via le Railway CLI, réutilisant vos identifiants railway login afin qu'aucune seconde authentification ne soit requise.
• Avec OAuth. Les éditeurs prenant en charge OAuth se connectent directement à https://mcp.railway.com sans le CLI.

Remarque : La connexion via le CLI nécessite la version 5.44.0 ou ultérieure du CLI.

Démarrage rapide

Installez le Railway CLI et configurez les compétences de l'agent, MCP et l'authentification en une seule commande. Sélectionnez les options pour générer la commande de configuration :

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

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

Poursuivez 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 souhaitez inspecter ce que railway mcp install écrit, utilisez le sélecteur pour basculer entre la connexion CLI, OAuth et l'exécution locale du serveur :

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 pour 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 Railway MCP) qui exposent des outils et des flux de travail pour gérer des systèmes externes.

Le serveur Railway MCP s'exécute sur l'infrastructure de Railway. La commande railway mcp s'y connecte via stdio et attache les identifiants de votre session railway login à chaque requête. Les éditeurs prenant en charge OAuth se connectent directement à la place.

Prérequis

La connexion au serveur Railway MCP nécessite un compte Railway. La connexion CLI par défaut nécessite également un Railway CLI installé et une session railway login afin de réutiliser ces identifiants. OAuth ne nécessite pas le CLI.

Exemples d'utilisation

Utilisez des invites décrivant le résultat Railway souhaité que l'agent doit produire.

• 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 modèle

  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 (utilise l'outil 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 Railway MCP expose les outils suivants. Votre assistant IA sélectionne les outils en fonction de votre demande. Utilisez railway-agent pour les opérations en plusieurs étapes.

• 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 marqué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 demande en langage naturel à l'agent IA de Railway pour des opérations en plusieurs étapes comme l'analyse de journaux, le débogage et la configuration de services

Exécuter le serveur localement

Le CLI inclut également un serveur MCP intégré pour les machines qui ne peuvent pas atteindre mcp.railway.com, par exemple sur des réseaux à sortie restreinte. Démarrez-le avec railway mcp local, ou écrivez la configuration pour les éditeurs pris en charge avec railway mcp install --local. Il communique directement avec l'API Railway en utilisant vos identifiants CLI, marque les outils destructifs avec des indications au niveau du protocole et renvoie un aperçu avant de demander confirm: true.

Le serveur local expose un ensemble d'outils différent de mcp.railway.com :

• Compte : whoami
• Projets et services : 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, et scale_service
• Environnements et déploiements : create_environment, link_environment, environment_status, list_deployments, et deploy
• Variables : list_variables, set_variables, et add_reference_variable
• Domaines : generate_domain, list_domains, domain_status, update_domain, delete_domain, et retry_domain_certificate
• Réseau : list_tcp_proxies, get_tcp_proxy, create_tcp_proxy, remove_tcp_proxy, private_network_status, et private_network_update
• Modèles : search_templates et deploy_template
• Stockage : create_bucket, remove_bucket, create_volume, update_volume, et remove_volume
• Observabilité : get_logs, service_metrics, http_requests, http_error_rate, et http_response_time
• Documentation : docs_search et docs_fetch

Considérations de sécurité

Le serveur Railway MCP invoque les API Railway en votre nom. Gardez ces points à l'esprit :

• Authentification CLI. La commande railway mcp lit et actualise vos identifiants railway login. La configuration de l'éditeur ne contient pas d'identifiant Railway à longue durée de vie.
• Portée OAuth. Avec OAuth, vous choisissez les espaces de travail et projets auxquels le client peut accéder. Les jetons sont à courte durée de vie et peuvent être révoqués depuis les paramètres de votre compte Railway.
• Actions destructives 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 exige une identité utilisateur pour la facturation et les pistes d'audit.

Vous devez également :

• Examiner les actions demandées par le LLM avant de les approuver, en particulier les actions destructives (redeploy, accept-deploy, railway-agent, et celles du serveur local remove_service, delete_domain, remove_tcp_proxy, remove_bucket, et remove_volume).
• Restreindre l'accès pour garantir que seuls les utilisateurs de confiance peuvent invoquer le serveur MCP.
• Éviter les risques de production en limitant l'utilisation aux environnements non critiques lorsque cela est possible.

Demandes de fonctionnalités

Partagez vos demandes de fonctionnalités sur le post Railway MCP Server Central Station.