Railway MCP

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

El Railway MCP Server implementa el Model Context Protocol (MCP). Permite que los asistentes de IA creen proyectos, desplieguen plantillas, gestionen entornos, obtengan variables y vuelvan a desplegar servicios.

El servidor se ejecuta en mcp.railway.com. Conéctate a él de una de estas dos formas:

• A través de la CLI (por defecto). El comando railway mcp conecta tu editor a mcp.railway.com mediante la Railway CLI, reutilizando tus credenciales de railway login para que no se requiera una segunda autenticación.
• Con OAuth. Los editores que admiten OAuth se conectan directamente a https://mcp.railway.com sin la CLI.

Nota: Conectarse a través de la CLI requiere la versión 5.44.0 o posterior de la CLI.

Inicio rápido

Instala la Railway CLI y configura las habilidades del agente, MCP y la autenticación en un solo comando. Selecciona las opciones para generar el comando de configuración:

Si la CLI ya está instalada, omite el arranque y ejecuta:

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

Continúa leyendo para la configuración manual por editor, la lista de herramientas disponibles y las consideraciones de seguridad.

Configuración por editor

Si prefieres configurar un editor manualmente, o quieres inspeccionar lo que escribe railway mcp install, usa el selector para alternar entre la conexión CLI, OAuth y ejecutar el servidor localmente:

railway mcp install fusiona la entrada del servidor Railway en las configuraciones existentes sin eliminar otros servidores MCP. Vuelve a ejecutarlo en cualquier momento para actualizar.

Entendiendo MCP

El Model Context Protocol (MCP) define un estándar para que las aplicaciones de IA (hosts) puedan interactuar con herramientas externas y fuentes de datos a través de una arquitectura cliente-servidor.

• Hosts: Aplicaciones como Cursor, VS Code, Claude Code o Windsurf que se conectan a servidores MCP.
• Clientes: La capa dentro de los hosts que mantiene conexiones uno a uno con servidores MCP individuales.
• Servidores: Programas independientes (como el Railway MCP Server) que exponen herramientas y flujos de trabajo para gestionar sistemas externos.

El Railway MCP server se ejecuta en la infraestructura de Railway. El comando railway mcp se conecta a él a través de stdio y adjunta credenciales de tu sesión de railway login a cada solicitud. Los editores que admiten OAuth se conectan directamente en su lugar.

Requisitos previos

Conectarse al Railway MCP server requiere una cuenta de Railway. La conexión CLI por defecto también requiere una Railway CLI instalada y una sesión de railway login para poder reutilizar esas credenciales. OAuth no requiere la CLI.

Ejemplo de uso

Usa indicaciones que describan el resultado de Railway que quieres que el agente produzca.

• Crear y desplegar una nueva aplicación

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

• Desplegar desde una plantilla

  Deploy a Postgres database
  

• Obtener variables de entorno

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

• Depurar un despliegue fallido (usa la herramienta railway-agent)

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

• Volver a desplegar un servicio

  Redeploy my api service in the production environment
  

• Gestionar indicadores de funciones

  List feature flags for project <projectId>
  

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

Herramientas MCP disponibles

El Railway MCP Server expone las siguientes herramientas. Tu asistente de IA selecciona herramientas según tu solicitud. Usa railway-agent para operaciones de varios pasos.

• Cuenta
  • whoami
• Proyectos
  • list-projects, create-project, list-services
• Indicadores de funciones
  • list-feature-flags, get-feature-flag
  • set-feature-flag, delete-feature-flag (administrador; la eliminación destructiva está marcada a nivel de protocolo)
• Despliegues
  • redeploy
  • accept-deploy: confirma los cambios preparados y despliega (destructivo; los clientes solicitan confirmación)
• Agente
  • railway-agent: entrega una solicitud en lenguaje natural al agente de IA de Railway para operaciones de varios pasos como análisis de registros, depuración y configuración de servicios

Ejecutar el servidor localmente

La CLI también incluye un servidor MCP en proceso para máquinas que no pueden alcanzar mcp.railway.com, por ejemplo en redes con restricciones de salida. Inícialo con railway mcp local, o escribe la configuración para editores compatibles con railway mcp install --local. Se comunica directamente con la API de Railway usando tus credenciales de CLI, marca las herramientas destructivas con indicaciones a nivel de protocolo y devuelve una vista previa antes de requerir confirm: true.

El servidor local expone un conjunto de herramientas diferente al de mcp.railway.com:

• Cuenta: whoami
• Proyectos y servicios: 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 y scale_service
• Entornos y despliegues: create_environment, link_environment, environment_status, list_deployments y deploy
• Variables: list_variables, set_variables y add_reference_variable
• Dominios: generate_domain, list_domains, domain_status, update_domain, delete_domain y retry_domain_certificate
• Redes: list_tcp_proxies, get_tcp_proxy, create_tcp_proxy, remove_tcp_proxy, private_network_status y private_network_update
• Plantillas: search_templates y deploy_template
• Almacenamiento: create_bucket, remove_bucket, create_volume, update_volume y remove_volume
• Observabilidad: get_logs, service_metrics, http_requests, http_error_rate y http_response_time
• Documentación: docs_search y docs_fetch

Consideraciones de seguridad

El Railway MCP Server invoca las API de Railway en tu nombre. Ten en cuenta estos puntos:

• Autenticación CLI. El comando railway mcp lee y actualiza tus credenciales de railway login. La configuración del editor no contiene una credencial de Railway de larga duración.
• Alcance de OAuth. Con OAuth, eliges qué espacios de trabajo y proyectos puede acceder el cliente. Los tokens son de corta duración y se pueden revocar desde la configuración de tu cuenta de Railway.
• Acciones destructivas están marcadas a nivel de protocolo. Los clientes que respetan estas indicaciones solicitarán confirmación.
• Los tokens de proyecto no se aceptan. El servidor requiere una identidad de usuario para facturación y pistas de auditoría.

Aun así, debes:

• Revisar las acciones solicitadas por el LLM antes de aprobarlas, especialmente las destructivas (redeploy, accept-deploy, railway-agent y las del servidor local remove_service, delete_domain, remove_tcp_proxy, remove_bucket y remove_volume).
• Restringir el acceso para asegurar que solo usuarios de confianza puedan invocar el servidor MCP.
• Evitar riesgos de producción limitando el uso a entornos no críticos cuando sea posible.

Solicitudes de funciones

Comparte solicitudes de funciones en la publicación de Railway MCP Server Central Station.