Railway MCP

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.

Railway propose deux serveurs MCP :

• MCP local s'exécute via la CLI Railway sur votre machine et utilise le contexte CLI local.
• MCP distant s'exécute à mcp.railway.com. Connectez-vous directement avec OAuth, ou exécutez railway mcp proxy pour réutiliser les identifiants de votre session railway login.

Démarrage rapide

Installez la CLI Railway 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 la CLI est déjà installée, ignorez l'initialisation et exécutez :

railway setup agent                  # Local MCP
railway setup agent --remote         # Remote MCP through the CLI proxy
railway setup agent --remote --oauth # Remote MCP with OAuth

Poursuivez la lecture 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 stdio local, MCP distant via le proxy CLI, et MCP distant avec OAuth :

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 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 MCP local traduit les requêtes en langage naturel en flux de travail CLI propulsés par la CLI Railway. Le MCP distant s'exécute sur l'infrastructure de Railway et prend en charge OAuth. Le proxy CLI fournit un autre chemin de connexion en transmettant les identifiants de votre session railway login au MCP distant.

Prérequis

Le serveur et la méthode d'authentification déterminent les outils locaux et les identifiants dont vous avez besoin.

• MCP local nécessite une CLI Railway installée et authentifiée.
• MCP distant nécessite un compte Railway. L'OAuth direct ne nécessite pas la CLI. Le proxy CLI nécessite une CLI installée et une session railway login afin de pouvoir réutiliser ces identifiants.

Exemples d'utilisation

Utilisez des invites qui décrivent le résultat Railway que vous souhaitez que l'agent produise.

• 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 (outil railway-agent réservé au distant)

  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.

MCP local

Le MCP local s'exécute via la CLI Railway et expose ces outils :

• 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

MCP distant

Le MCP distant expose les outils suivants. 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 indexé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 de journaux, le débogage et la configuration de services

Considérations de sécurité

Le serveur Railway MCP exécute des commandes CLI ou invoque les API Railway en votre nom. Le MCP local marque les outils destructifs avec des indications au niveau du protocole et renvoie un aperçu avant d'exiger confirm: true. Vous devez néanmoins :

• Examiner les actions demandées par le LLM avant de les approuver, en particulier les actions destructives (remove_service, delete_domain, remove_tcp_proxy, remove_bucket, remove_volume, redeploy, accept-deploy et railway-agent).
• 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 à des environnements non critiques lorsque c'est possible.

Pour le MCP distant :

• Authentification par proxy CLI. Le proxy 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 l'OAuth direct, vous choisissez les espaces de travail et les 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 MCP distant exige une identité utilisateur pour la facturation et les pistes d'audit.

Demandes de fonctionnalités

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