Railway MCP Server

El Railway MCP Server es un servidor del Protocolo de Contexto de Modelo (MCP) que permite la interacción en lenguaje natural con tus proyectos e infraestructura de Railway. Pide a tu IDE o asistente de IA que cree proyectos, despliegue plantillas, administre entornos, obtenga variables, redespliegue servicios y más.

Railway ofrece dos formas de conexión:

• MCP Local — se ejecuta a través de la CLI de Railway en tu máquina. Recomendado para la mayoría de flujos de trabajo con agentes de codificación, ya que comparte la autenticación y el contexto del proyecto de la CLI.
• MCP Remoto — un endpoint alojado en mcp.railway.com. No requiere instalación local ni CLI; los clientes se autentican mediante OAuth en el navegador.

Inicio rápido

Instala la CLI de Railway y configura el soporte para agentes — habilidades, MCP y autenticación — en un solo comando. Alterna las opciones para adaptar el comando a lo que deseas configurar:

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

railway setup agent          # local MCP
railway setup agent --remote # remote MCP

Sigue leyendo para la configuración manual por editor, la lista de herramientas disponibles y consideraciones de seguridad.

Configuración por editor

Si prefieres conectar un editor manualmente — o quieres ver exactamente lo que escribe railway mcp install — usa el interruptor para alternar entre la configuración local stdio y la configuración remota HTTP:

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 Protocolo de Contexto de Modelo (MCP) define un estándar sobre cómo las aplicaciones de IA (hosts) pueden 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 administrar sistemas externos.

El Railway MCP Server local traduce solicitudes en lenguaje natural a flujos de trabajo de CLI impulsados por la CLI de Railway. El servidor MCP remoto se ejecuta en la infraestructura de Railway y se autentica mediante OAuth.

Requisitos previos

• MCP Local — instala y autentica la CLI de Railway.
• MCP Remoto — una cuenta de Railway. No requiere instalación local.

Ejemplos de uso

• Crear y desplegar una nueva app

  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 (herramienta railway-agent solo remota)

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

• Redesplegar un servicio

  Redeploy my api service in the production environment
  

Herramientas MCP disponibles

El Railway MCP Server proporciona un conjunto seleccionado de herramientas. Tu asistente de IA las llama automáticamente según el contexto de tu solicitud.

MCP Local

El servidor local se ejecuta a través de la CLI de Railway y expone un conjunto más amplio de herramientas CRUD:

• Estado
  • check-railway-status — verificar la instalación y autenticación de la CLI
• Proyectos y servicios
  • list-projects, create-project-and-link
  • list-services, link-service
  • deploy — desplegar un servicio
  • deploy-template — desplegar desde la Biblioteca de Plantillas de Railway
• Entornos
  • create-environment, link-environment
• Configuración
  • list-variables, set-variables
  • generate-domain
• Observabilidad
  • get-logs

MCP Remoto

El servidor remoto expone un conjunto enfocado de herramientas más un potente punto de entrada de agente. Para cualquier cosa compleja, delega en railway-agent.

• Cuenta
  • whoami
• Proyectos
  • list-projects, create-project, list-services
• Despliegues
  • redeploy
  • accept-deploy — confirmar cambios preparados y desplegar (destructivo; los clientes solicitan confirmación)
• Agente
  • railway-agent — entregar 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 CLI o invoca las API de Railway en tu nombre. Las operaciones destructivas se excluyen intencionalmente de la lista de herramientas del servidor local, pero aún así deberías:

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

Para el servidor remoto específicamente:

• Alcance de OAuth. Al dar tu consentimiento, eliges a 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.
• Las acciones destructivas están marcadas a nivel de protocolo. Los clientes que respeten estas indicaciones solicitarán confirmación.
• No se aceptan tokens de proyecto. El servidor MCP remoto requiere una identidad de usuario para fines de facturación y pistas de auditoría.

Solicitudes de funciones

El Railway MCP Server es un trabajo en progreso. Estamos agregando activamente más herramientas y funciones. Si tienes una solicitud de función, deja tus comentarios en esta publicación de Central Station.