Railway MCP Server

Railway MCP 서버는 모델 컨텍스트 프로토콜(MCP) 서버로, Railway 프로젝트 및 인프라와 자연어로 상호작용할 수 있게 해줍니다. IDE나 AI 어시스턴트에게 프로젝트 생성, 템플릿 배포, 환경 관리, 변수 가져오기, 서비스 재배포 등을 요청할 수 있습니다.

Railway는 두 가지 연결 방식을 제공합니다:

• 로컬 MCP — 사용자 머신에서 Railway CLI를 통해 실행됩니다. CLI의 인증 및 프로젝트 컨텍스트를 공유하므로 대부분의 코딩 에이전트 워크플로에 권장됩니다.
• 원격 MCP — mcp.railway.com에서 호스팅되는 엔드포인트입니다. 로컬 설치나 CLI가 필요 없으며, 클라이언트는 브라우저에서 OAuth를 통해 인증합니다.

빠른 시작

Railway CLI를 설치하고 에이전트 지원(스킬, MCP, 인증)을 하나의 명령으로 구성하세요. 옵션을 토글하여 원하는 설정에 맞게 명령을 조정할 수 있습니다:

CLI가 이미 설치되어 있다면 부트스트랩을 건너뛰고 다음을 실행하세요:

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

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

편집기별 구성

편집기를 직접 연결하거나 railway mcp install가 정확히 무엇을 작성하는지 확인하고 싶다면, 토글을 사용하여 로컬 stdio 구성과 원격 HTTP 구성 사이를 전환하세요:

railway mcp install는 기존 구성에 Railway 서버 항목을 병합하며 다른 MCP 서버를 제거하지 않습니다. 언제든지 다시 실행하여 업데이트할 수 있습니다.

MCP 이해하기

**모델 컨텍스트 프로토콜(MCP)**은 AI 애플리케이션(호스트)이 클라이언트-서버 아키텍처를 통해 외부 도구 및 데이터 소스와 상호작용하는 방식을 정의하는 표준입니다.

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

로컬 Railway MCP 서버는 자연어 요청을 Railway CLI 기반의 CLI 워크플로로 변환합니다. 원격 MCP 서버는 Railway 인프라에서 실행되며 OAuth를 통해 인증합니다.

사전 요구 사항

• 로컬 MCP — Railway CLI를 설치하고 인증하세요.
• 원격 MCP — 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
  

사용 가능한 MCP 도구

Railway MCP 서버는 엄선된 도구 세트를 제공합니다. AI 어시스턴트는 요청 컨텍스트에 따라 이를 자동으로 호출합니다.

로컬 MCP

로컬 서버는 Railway CLI를 통해 실행되며 더 광범위한 CRUD 도구를 노출합니다:

• 상태
  • check-railway-status — CLI 설치 및 인증 확인
• 프로젝트 및 서비스
  • list-projects, create-project-and-link
  • list-services, link-service
  • deploy — 서비스 배포
  • deploy-template — Railway 템플릿 라이브러리에서 배포
• 환경
  • create-environment, link-environment
• 구성
  • list-variables, set-variables
  • generate-domain
• 관측 가능성
  • get-logs

원격 MCP

원격 서버는 집중된 도구 세트와 강력한 에이전트 진입점을 노출합니다. 복잡한 작업은 railway-agent에 위임하세요.

• 계정
  • whoami
• 프로젝트
  • list-projects, create-project, list-services
• 배포
  • redeploy
  • accept-deploy — 스테이징된 변경 사항을 커밋하고 배포 (파괴적 작업; 클라이언트가 확인 요청)
• 에이전트
  • railway-agent — 로그 분석, 디버깅, 서비스 구성과 같은 다단계 작업을 위해 자연어 요청을 Railway의 AI 에이전트에 전달

보안 고려 사항

Railway MCP 서버는 사용자를 대신하여 CLI 명령을 실행하거나 Railway API를 호출합니다. 파괴적 작업은 로컬 서버의 도구 목록에서 의도적으로 제외되었지만, 다음 사항을 준수해야 합니다:

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

원격 서버의 경우 특히:

• OAuth 범위 지정. 동의 시 클라이언트가 접근할 수 있는 워크스페이스와 프로젝트를 선택합니다. 토큰은 수명이 짧으며 Railway 계정 설정에서 취소할 수 있습니다.
• 파괴적 작업은 프로토콜 수준에서 표시됩니다. 이러한 힌트를 존중하는 클라이언트는 확인을 요청합니다.
• 프로젝트 토큰은 허용되지 않습니다. 원격 MCP 서버는 청구 및 감사 추적을 위해 사용자 ID를 요구합니다.

기능 요청

Railway MCP 서버는 진행 중인 작업입니다. 더 많은 도구와 기능을 적극적으로 추가하고 있습니다. 기능 요청이 있다면 이 Central Station 게시물에 피드백을 남겨주세요.