Railway MCP Server

O Railway MCP Server é um servidor Model Context Protocol (MCP) que permite a interação em linguagem natural com seus projetos e infraestrutura do Railway. Peça à sua IDE ou assistente de IA para criar projetos, implantar templates, gerenciar ambientes, extrair variáveis, reimplantar serviços e muito mais.

O Railway oferece duas formas de conexão:

• MCP Local — executado através da Railway CLI na sua máquina. Recomendado para a maioria dos fluxos de trabalho com agentes de codificação, pois compartilha a autenticação e o contexto do projeto da CLI.
• MCP Remoto — um endpoint hospedado em mcp.railway.com. Não requer instalação local nem CLI; os clientes se autenticam via OAuth no navegador.

Início rápido

Instale a Railway CLI e configure o suporte ao agente — skills, MCP e autenticação — em um único comando. Alterne as opções para adaptar o comando ao que você deseja configurar:

Se a CLI já estiver instalada, pule o bootstrap e execute:

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

Continue lendo para a configuração manual por editor, a lista de ferramentas disponíveis e considerações de segurança.

Configuração por editor

Se preferir configurar um editor manualmente — ou quiser ver exatamente o que railway mcp install escreve — use o seletor para alternar entre a configuração stdio local e a configuração HTTP remota:

railway mcp install mescla a entrada do servidor Railway nas configurações existentes sem remover outros servidores MCP. Execute-o novamente a qualquer momento para atualizar.

Entendendo o MCP

O Model Context Protocol (MCP) define um padrão de como aplicações de IA (hosts) podem interagir com ferramentas externas e fontes de dados através de uma arquitetura cliente-servidor.

• Hosts: Aplicações como Cursor, VS Code, Claude Code ou Windsurf que se conectam a servidores MCP.
• Clientes: A camada dentro dos hosts que mantém conexões um-para-um com servidores MCP individuais.
• Servidores: Programas independentes (como o Railway MCP Server) que expõem ferramentas e fluxos de trabalho para gerenciar sistemas externos.

O Railway MCP Server local traduz solicitações em linguagem natural em fluxos de trabalho da CLI com base na Railway CLI. O servidor MCP remoto é executado na infraestrutura do Railway e autentica via OAuth.

Pré-requisitos

• MCP Local — instale e autentique a Railway CLI.
• MCP Remoto — uma conta Railway. Não requer instalação local.

Exemplos de uso

• Criar e implantar um novo app

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

• Implantar a partir de um template

  Deploy a Postgres database
  

• Extrair variáveis de ambiente

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

• Depurar uma implantação com falha (ferramenta railway-agent somente remota)

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

• Reimplantar um serviço

  Redeploy my api service in the production environment
  

Ferramentas MCP disponíveis

O Railway MCP Server fornece um conjunto selecionado de ferramentas. Seu assistente de IA as chama automaticamente com base no contexto da sua solicitação.

MCP Local

O servidor local é executado através da Railway CLI e expõe um conjunto mais amplo de ferramentas CRUD:

• Status
  • check-railway-status — verificar a instalação e autenticação da CLI
• Projetos e serviços
  • list-projects, create-project-and-link
  • list-services, link-service
  • deploy — implantar um serviço
  • deploy-template — implantar a partir da Biblioteca de Templates do Railway
• Ambientes
  • create-environment, link-environment
• Configuração
  • list-variables, set-variables
  • generate-domain
• Observabilidade
  • get-logs

MCP Remoto

O servidor remoto expõe um conjunto focado de ferramentas, além de um poderoso ponto de entrada de agente. Para qualquer coisa complexa, delegue ao railway-agent.

• Conta
  • whoami
• Projetos
  • list-projects, create-project, list-services
• Implantações
  • redeploy
  • accept-deploy — commitar mudanças preparadas e implantar (destrutivo; clientes solicitam confirmação)
• Agente
  • railway-agent — encaminhar uma solicitação em linguagem natural ao agente de IA do Railway para operações de várias etapas, como análise de logs, depuração e configuração de serviços

Considerações de segurança

O Railway MCP Server executa comandos da CLI ou invoca APIs do Railway em seu nome. Operações destrutivas são intencionalmente excluídas da lista de ferramentas do servidor local, mas você ainda deve:

• Revisar as ações solicitadas pelo LLM antes de aprová-las, especialmente as destrutivas (redeploy, accept-deploy, railway-agent).
• Restringir o acesso para garantir que apenas usuários confiáveis possam invocar o servidor MCP.
• Evitar riscos em produção limitando o uso a ambientes não críticos sempre que possível.

Para o servidor remoto especificamente:

• Escopo do OAuth. Ao consentir, você escolhe quais workspaces e projetos o cliente pode acessar. Os tokens têm vida curta e podem ser revogados nas configurações da sua conta Railway.
• Ações destrutivas são marcadas no nível do protocolo. Clientes que respeitam essas dicas solicitarão confirmação.
• Tokens de projeto não são aceitos. O servidor MCP remoto requer uma identidade de usuário para fins de cobrança e trilhas de auditoria.

Solicitações de funcionalidades

O Railway MCP Server é um trabalho em andamento. Estamos adicionando ativamente mais ferramentas e funcionalidades. Se você tiver uma solicitação de funcionalidade, deixe seu feedback neste post do Central Station.