Railway MCP

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

Railway ofrece dos servidores MCP:

• MCP Local se ejecuta a través de la Railway CLI en tu máquina y utiliza el contexto local de la CLI.
• MCP Remoto se ejecuta en mcp.railway.com. Conéctate directamente usando OAuth, o ejecuta railway mcp proxy para reutilizar las credenciales de tu sesión de railway login.

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 bootstrap y ejecuta:

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

Sigue 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 qué escribe railway mcp install, usa el selector para cambiar entre stdio local, MCP Remoto a través del proxy de la CLI y MCP Remoto con OAuth:

railway mcp install fusiona la entrada del servidor de 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 cómo las aplicaciones de IA (anfitriones) pueden interactuar con herramientas externas y fuentes de datos a través de una arquitectura cliente-servidor.

• Anfitriones: Aplicaciones como Cursor, VS Code, Claude Code o Windsurf que se conectan a servidores MCP.
• Clientes: La capa dentro de los anfitriones 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 servidor MCP Local traduce solicitudes en lenguaje natural a flujos de trabajo de la CLI impulsados por la Railway CLI. El MCP Remoto se ejecuta en la infraestructura de Railway y es compatible con OAuth. El proxy de la CLI proporciona otra ruta de conexión al pasar las credenciales de tu sesión de railway login al MCP Remoto.

Requisitos previos

El servidor y el método de autenticación determinan qué herramientas locales y credenciales necesitas.

• MCP Local requiere una Railway CLI instalada y autenticada.
• MCP Remoto requiere una cuenta de Railway. El OAuth directo no requiere la CLI. El proxy de la CLI requiere una CLI instalada y una sesión de railway login para poder reutilizar esas credenciales.

Ejemplos de uso

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

• Crear e implementar una nueva aplicación

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

• Implementar desde una plantilla

  Deploy a Postgres database
  

• Extraer variables de entorno

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

• Depurar una implementación fallida (herramienta railway-agent solo remota)

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

• Volver a implementar un servicio

  Redeploy my api service in the production environment
  

• Gestionar indicadores de funcionalidad

  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.

MCP Local

El MCP Local se ejecuta a través de la Railway CLI y expone estas herramientas:

• 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 e implementaciones: 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

MCP Remoto

El MCP Remoto expone las siguientes herramientas. Usa railway-agent para operaciones de varios pasos.

• Cuenta
  • whoami
• Proyectos
  • list-projects, create-project, list-services
• Indicadores de funcionalidad
  • list-feature-flags, get-feature-flag
  • set-feature-flag, delete-feature-flag (administración; la eliminación destructiva está marcada a nivel de protocolo)
• Implementaciones
  • redeploy
  • accept-deploy: confirma los cambios en etapa 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

Consideraciones de seguridad

El Railway MCP Server ejecuta comandos de la CLI o invoca las API de Railway en tu nombre. El MCP Local marca las herramientas destructivas con sugerencias a nivel de protocolo y devuelve una vista previa antes de requerir confirm: true. Aun así, debes:

• Revisar las acciones solicitadas por el LLM antes de aprobarlas, especialmente las destructivas (remove_service, delete_domain, remove_tcp_proxy, remove_bucket, remove_volume, redeploy, accept-deploy y railway-agent).
• 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.

Para MCP Remoto:

• Autenticación del proxy de la CLI. El proxy lee y actualiza tus credenciales de railway login. La configuración del editor no contiene una credencial de Railway de larga duración.
• Ámbito de OAuth. Con OAuth directo, eliges a qué espacios de trabajo y proyectos puede acceder el cliente. Los tokens tienen una vida útil corta 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 sugerencias solicitarán confirmación.
• Los tokens de proyecto no son aceptados. El MCP Remoto requiere una identidad de usuario para la facturación y las pistas de auditoría.

Solicitudes de funcionalidades

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