Railway MCP

O Railway MCP Server implementa o Model Context Protocol (MCP). Ele permite que assistentes de IA criem projetos, implantem templates, gerenciem ambientes, puxem variáveis e reimplementem serviços.

O Railway oferece dois servidores MCP:

• MCP Local roda através do Railway CLI na sua máquina e usa o contexto local do CLI.
• MCP Remoto roda em mcp.railway.com. Conecte diretamente usando OAuth, ou execute railway mcp proxy para reutilizar credenciais da sua sessão railway login.

Início rápido

Instale o Railway CLI e configure as habilidades do agente, MCP e autenticação em um único comando. Selecione as opções para gerar o comando de configuração:

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

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

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

Configuração por editor

Se você preferir configurar um editor manualmente, ou quiser inspecionar o que railway mcp install escreve, use o seletor para alternar entre stdio local, MCP Remoto através do proxy do CLI e MCP Remoto com OAuth:

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

Entendendo o MCP

O Model Context Protocol (MCP) define um padrão para 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-a-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 servidor MCP Local traduz solicitações em linguagem natural em fluxos de trabalho do CLI alimentados pelo Railway CLI. O MCP Remoto roda na infraestrutura do Railway e suporta OAuth. O proxy do CLI fornece outro caminho de conexão ao passar credenciais da sua sessão railway login para o MCP Remoto.

Pré-requisitos

O servidor e o método de autenticação determinam quais ferramentas locais e credenciais você precisa.

• MCP Local requer um Railway CLI instalado e autenticado.
• MCP Remoto requer uma conta Railway. OAuth direto não requer o CLI. O proxy do CLI requer um CLI instalado e uma sessão railway login para que possa reutilizar essas credenciais.

Exemplos de uso

Use prompts que descrevam o resultado Railway que você deseja que o agente produza.

• 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
  

• Puxar 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
  

• Reimplementar um serviço

  Redeploy my api service in the production environment
  

• Gerenciar feature flags

  List feature flags for project <projectId>
  

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

Ferramentas MCP disponíveis

O Railway MCP Server expõe as seguintes ferramentas. Seu assistente de IA seleciona ferramentas com base na sua solicitação.

MCP Local

O MCP Local roda através do Railway CLI e expõe estas ferramentas:

• Conta: whoami
• Projetos e serviços: 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 e scale_service
• Ambientes e implantações: create_environment, link_environment, environment_status, list_deployments e deploy
• Variáveis: list_variables, set_variables e add_reference_variable
• Domínios: generate_domain, list_domains, domain_status, update_domain, delete_domain e retry_domain_certificate
• Rede: list_tcp_proxies, get_tcp_proxy, create_tcp_proxy, remove_tcp_proxy, private_network_status e private_network_update
• Templates: search_templates e deploy_template
• Armazenamento: create_bucket, remove_bucket, create_volume, update_volume e remove_volume
• Observabilidade: get_logs, service_metrics, http_requests, http_error_rate e http_response_time
• Documentação: docs_search e docs_fetch

MCP Remoto

O MCP Remoto expõe as seguintes ferramentas. Use railway-agent para operações de múltiplas etapas.

• Conta
  • whoami
• Projetos
  • list-projects, create-project, list-services
• Feature flags
  • list-feature-flags, get-feature-flag
  • set-feature-flag, delete-feature-flag (admin; exclusão destrutiva é marcada no nível do protocolo)
• Implantações
  • redeploy
  • accept-deploy: faz commit das alterações preparadas e implanta (destrutivo; os clientes solicitam confirmação)
• Agente
  • railway-agent: entrega uma solicitação em linguagem natural ao agente de IA do Railway para operações de múltiplas 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 do CLI ou invoca APIs do Railway em seu nome. O MCP Local marca ferramentas destrutivas com dicas no nível do protocolo e retorna uma prévia antes de exigir confirm: true. Você ainda deve:

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

Para MCP Remoto:

• Autenticação do proxy do CLI. O proxy lê e renova suas credenciais railway login. A configuração do editor não contém uma credencial Railway de longa duração.
• Escopo do OAuth. Com OAuth direto, você escolhe quais workspaces e projetos o cliente pode acessar. Os tokens são de curta duração 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 MCP Remoto requer uma identidade de usuário para cobrança e trilhas de auditoria.

Solicitações de recursos

Compartilhe solicitações de recursos na postagem do Railway MCP Server Central Station.