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, de déployer des modèles, de gérer des environnements, de récupérer des variables et de redéployer des services.

Le serveur est accessible à l’adresse mcp.railway.com. Connectez-vous de l’une des deux façons suivantes :

• Via la CLI (par défaut). La commande railway mcp connecte votre éditeur à mcp.railway.com via la Railway CLI, en réutilisant vos identifiants railway login pour éviter une seconde authentification.
• Avec OAuth. Les éditeurs compatibles avec OAuth se connectent directement à https://mcp.railway.com, sans passer par la CLI.

Remarque : la connexion via la CLI nécessite la version 5.44.0 ou ultérieure de la CLI.

Démarrage rapide

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

Si la CLI est déjà installée, ignorez l’initialisation et exécutez :

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

Poursuivez votre lecture pour découvrir 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 souhaitez examiner ce que railway mcp install écrit, utilisez le sélecteur pour passer de la connexion via la CLI à OAuth ou à l’exécution du serveur en local :

railway mcp install fusionne l’entrée du serveur Railway avec les configurations existantes sans supprimer les autres serveurs MCP. Relancez-le à tout moment pour effectuer une mise à jour.

Comprendre MCP

Le Model Context Protocol (MCP) définit une norme permettant aux applications d’IA (hôtes) d’interagir avec des outils et des sources de données externes selon une architecture client-serveur.

• Hôtes : applications telles que Cursor, VS Code, Claude Code ou Windsurf qui se connectent à des serveurs MCP.
• Clients : couche au sein des hôtes qui maintient des connexions individuelles avec chaque serveur 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 joint à chaque requête les identifiants de votre session railway login. Les éditeurs compatibles avec 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 l’installation de la Railway CLI et une session railway login afin de pouvoir réutiliser ces identifiants. OAuth ne nécessite pas la CLI.

Exemples d’utilisation

Utilisez des requêtes qui décrivent le résultat que vous souhaitez obtenir avec Railway.

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

  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 requête. Utilisez railway-agent pour les opérations en plusieurs étapes.

• Compte
  • whoami
• Projets
  • list-projects, create-project, list-services
• Indicateurs de fonctionnalité
  • list-feature-flags, get-feature-flag
  • set-feature-flag, delete-feature-flag (administrateur ; la suppression destructive est signalée au niveau du protocole)
• Déploiements
  • redeploy
  • accept-deploy : valider les modifications préparées 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, comme l’analyse des journaux, le débogage et la configuration des services
• Tâches de l’agent cloud (voir Tâches)
  • run-cloud-agent-task : confier une tâche à un agent cloud (le lancement d’un nouvel agent est facturé ; les clients demandent une confirmation)
  • check-cloud-agent-task, list-cloud-agent-tasks, get-cloud-agent-transcript
  • respond-cloud-agent-task, cancel-cloud-agent-task
  • list-cloud-agent-models

Exécuter le serveur en local

La CLI inclut également un serveur MCP intégré au processus pour les machines qui ne peuvent pas accéder à mcp.railway.com, par exemple sur des réseaux où le trafic sortant est restreint. Lancez-le avec railway mcp local, ou générez la configuration des éditeurs compatibles avec railway mcp install --local. Il communique directement avec l’API Railway à l’aide de vos identifiants CLI, signale les outils destructifs au niveau du protocole et fournit un aperçu avant de demander confirm: true.

Le serveur local expose un ensemble d’outils différent de celui 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 appelle les API Railway en votre nom. Gardez les points suivants à l’esprit :

• Authentification CLI. La commande railway mcp lit et actualise vos identifiants railway login. La configuration de l’éditeur ne contient aucun identifiant Railway à longue durée de vie.
• Portée OAuth. Avec OAuth, vous choisissez les espaces de travail et les projets auxquels le client peut accéder. Les jetons ont une durée de vie limitée et peuvent être révoqués dans les paramètres de votre compte Railway.
• Les actions destructives sont signalées au niveau du protocole. Les clients qui tiennent compte de ces indications demandent 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 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 et, pour le serveur local, remove_service, delete_domain, remove_tcp_proxy, remove_bucket et remove_volume).
• Restreindre l’accès afin que seuls les utilisateurs de confiance puissent invoquer le serveur MCP.
• Éviter les risques en production en limitant autant que possible l’utilisation aux environnements non critiques.

Demandes de fonctionnalités

Partagez vos demandes de fonctionnalités dans la publication Railway MCP Server Central Station.