Railway MCP

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

Railway MCP 서버는 Model Context Protocol (MCP)을 구현합니다. 이를 통해 AI 어시스턴트가 프로젝트 생성, 템플릿 배포, 환경 관리, 변수 가져오기, 서비스 재배포를 수행할 수 있습니다.

서버는 mcp.railway.com에서 실행됩니다. 다음 두 가지 방법 중 하나로 연결할 수 있습니다:

• CLI를 통한 연결 (기본값). railway mcp 명령은 Railway CLI를 통해 에디터를 mcp.railway.com에 연결하며, railway login 자격 증명을 재사용하므로 별도의 인증이 필요하지 않습니다.
• OAuth를 통한 연결. OAuth를 지원하는 에디터는 CLI 없이 https://mcp.railway.com에 직접 연결합니다.

참고: CLI를 통한 연결에는 CLI 버전 5.44.0 이상이 필요합니다.

빠른 시작

Railway CLI를 설치하고 에이전트 스킬, MCP, 인증을 한 번의 명령으로 구성하세요. 설정 명령을 생성하려면 옵션을 선택하세요:

CLI가 이미 설치된 경우 부트스트랩을 건너뛰고 다음을 실행하세요:

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

에디터별 수동 구성, 사용 가능한 도구 목록, 보안 고려 사항은 아래를 계속 읽어보세요.

에디터별 구성

에디터를 수동으로 구성하거나 railway mcp install이 작성하는 내용을 확인하려면 선택기를 사용하여 CLI 연결, OAuth, 로컬 서버 실행 사이를 전환하세요:

railway mcp install은 다른 MCP 서버를 제거하지 않고 Railway 서버 항목을 기존 구성에 병합합니다. 업데이트가 필요할 때마다 다시 실행하세요.

MCP 이해하기

Model Context Protocol (MCP) 는 AI 애플리케이션(호스트)이 클라이언트-서버 아키텍처를 통해 외부 도구 및 데이터 소스와 상호작용할 수 있는 방법에 대한 표준을 정의합니다.

• 호스트: Cursor, VS Code, Claude Code, Windsurf 등 MCP 서버에 연결하는 애플리케이션.
• 클라이언트: 호스트 내에서 개별 MCP 서버와 일대일 연결을 유지하는 계층.
• 서버: 외부 시스템 관리를 위한 도구와 워크플로우를 노출하는 독립 프로그램(예: Railway MCP 서버).

Railway MCP 서버는 Railway 인프라에서 실행됩니다. railway mcp 명령은 stdio를 통해 서버에 연결하고 각 요청에 railway login 세션의 자격 증명을 첨부합니다. OAuth를 지원하는 에디터는 대신 직접 연결합니다.

사전 요구 사항

Railway MCP 서버에 연결하려면 Railway 계정이 필요합니다. 기본 CLI 연결에는 설치된 Railway CLI와 railway login 세션도 필요하므로 해당 자격 증명을 재사용할 수 있습니다. OAuth는 CLI가 필요하지 않습니다.

사용 예시

에이전트가 생성하길 원하는 Railway 결과를 설명하는 프롬프트를 사용하세요.

• 새 앱 생성 및 배포

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

• 템플릿에서 배포

  Deploy a Postgres database
  

• 환경 변수 가져오기

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

• 실패한 배포 디버깅 (railway-agent 도구 사용)

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

• 서비스 재배포

  Redeploy my api service in the production environment
  

• 기능 플래그 관리

  List feature flags for project <projectId>
  

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

사용 가능한 MCP 도구

Railway MCP 서버는 다음 도구를 노출합니다. AI 어시스턴트는 요청에 따라 도구를 선택합니다. 다단계 작업에는 railway-agent을 사용하세요.

• 계정
  • whoami
• 프로젝트
  • list-projects, create-project, list-services
• 기능 플래그
  • list-feature-flags, get-feature-flag
  • set-feature-flag, delete-feature-flag (관리자 전용, 파괴적 삭제는 프로토콜 수준에서 표시됨)
• 배포
  • redeploy
  • accept-deploy: 스테이징된 변경 사항을 커밋하고 배포 (파괴적, 클라이언트가 확인을 요청함)
• 에이전트
  • railway-agent: 로그 분석, 디버깅, 서비스 구성과 같은 다단계 작업을 위해 자연어 요청을 Railway AI 에이전트에 전달

로컬에서 서버 실행

CLI는 mcp.railway.com에 도달할 수 없는 머신(예: 이그레스 제한 네트워크)을 위해 인프로세스 MCP 서버도 제공합니다. railway mcp local으로 시작하거나 railway mcp install --local으로 지원되는 에디터의 구성을 작성하세요. CLI 자격 증명을 사용하여 Railway API와 직접 통신하고, 파괴적 도구를 프로토콜 수준 힌트로 표시하며, confirm: true을 요구하기 전에 미리보기를 반환합니다.

로컬 서버는 mcp.railway.com과 다른 도구 세트를 노출합니다:

• 계정: whoami
• 프로젝트 및 서비스: 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, 및 scale_service
• 환경 및 배포: create_environment, link_environment, environment_status, list_deployments, 및 deploy
• 변수: list_variables, set_variables, 및 add_reference_variable
• 도메인: generate_domain, list_domains, domain_status, update_domain, delete_domain, 및 retry_domain_certificate
• 네트워킹: list_tcp_proxies, get_tcp_proxy, create_tcp_proxy, remove_tcp_proxy, private_network_status, 및 private_network_update
• 템플릿: search_templates 및 deploy_template
• 스토리지: create_bucket, remove_bucket, create_volume, update_volume, 및 remove_volume
• 관측 가능성: get_logs, service_metrics, http_requests, http_error_rate, 및 http_response_time
• 문서: docs_search 및 docs_fetch

보안 고려 사항

Railway MCP 서버는 사용자를 대신하여 Railway API를 호출합니다. 다음 사항을 유의하세요:

• CLI 인증. railway mcp 명령은 railway login 자격 증명을 읽고 새로 고칩니다. 에디터 구성에는 장기 Railway 자격 증명이 포함되지 않습니다.
• OAuth 범위 지정. OAuth를 사용하면 클라이언트가 액세스할 수 있는 워크스페이스와 프로젝트를 선택할 수 있습니다. 토큰은 수명이 짧으며 Railway 계정 설정에서 취소할 수 있습니다.
• 파괴적 작업은 프로토콜 수준에서 표시됩니다. 이러한 힌트를 존중하는 클라이언트는 확인을 요청합니다.
• 프로젝트 토큰은 허용되지 않습니다. 서버는 청구 및 감사 추적을 위해 사용자 ID가 필요합니다.

또한 다음을 수행해야 합니다:

• 작업 검토 — 승인 전에 LLM이 요청한 작업, 특히 파괴적 작업(redeploy, accept-deploy, railway-agent, 및 로컬 서버의 remove_service, delete_domain, remove_tcp_proxy, remove_bucket, remove_volume)을 검토하세요.
• 액세스 제한 — 신뢰할 수 있는 사용자만 MCP 서버를 호출할 수 있도록 하세요.
• 프로덕션 위험 방지 — 가능하면 중요하지 않은 환경으로 사용을 제한하세요.

기능 요청

Railway MCP Server Central Station 게시물에서 기능 요청을 공유하세요.