Railway MCP

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

Railway는 두 가지 MCP 서버를 제공합니다:

• 로컬 MCP는 사용자 머신의 Railway CLI를 통해 실행되며 로컬 CLI 컨텍스트를 사용합니다.
• 원격 MCP는 mcp.railway.com에서 실행됩니다. OAuth를 사용하여 직접 연결하거나, railway mcp proxy를 실행하여 railway login 세션의 자격 증명을 재사용할 수 있습니다.

빠른 시작

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

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

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

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

편집기별 구성

편집기를 수동으로 구성하거나 railway mcp install가 작성하는 내용을 확인하려면 선택기를 사용하여 로컬 stdio, CLI 프록시를 통한 원격 MCP, OAuth를 사용한 원격 MCP 간에 전환하세요:

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

MCP 이해하기

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

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

로컬 MCP 서버는 자연어 요청을 Railway CLI로 구동되는 CLI 워크플로로 변환합니다. 원격 MCP는 Railway의 인프라에서 실행되며 OAuth를 지원합니다. CLI 프록시는 railway login 세션의 자격 증명을 원격 MCP에 전달하여 또 다른 연결 경로를 제공합니다.

사전 요구 사항

서버와 인증 방법에 따라 필요한 로컬 도구와 자격 증명이 결정됩니다.

• 로컬 MCP는 설치 및 인증된 Railway CLI가 필요합니다.
• 원격 MCP는 Railway 계정이 필요합니다. 직접 OAuth는 CLI가 필요하지 않습니다. CLI 프록시는 설치된 CLI와 railway login 세션이 필요하므로 해당 자격 증명을 재사용할 수 있습니다.

사용 예시

에이전트가 생성하기를 원하는 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 어시스턴트는 요청에 따라 도구를 선택합니다.

로컬 MCP

로컬 MCP는 Railway CLI를 통해 실행되며 다음 도구를 노출합니다:

• 계정: 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

원격 MCP

원격 MCP는 다음 도구를 노출합니다. 다단계 작업에는 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 에이전트에 전달합니다

보안 고려 사항

Railway MCP 서버는 사용자를 대신하여 CLI 명령을 실행하거나 Railway API를 호출합니다. 로컬 MCP는 파괴적 도구를 프로토콜 수준 힌트로 표시하고 confirm: true을 요구하기 전에 미리 보기를 반환합니다. 그래도 다음 사항을 준수해야 합니다:

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

원격 MCP의 경우:

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

기능 요청

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