GETTING STARTED

Windows에
WSR을 연결하세요.

WSR은 Windows 개발환경에서 실행되며 ChatGPT와 로컬 환경을 연결합니다. 아래 순서대로 설정하면 됩니다.

01
ENVIRONMENT

환경 준비

Node.js가 필요합니다. 이미 설치되어 있다면 이 단계를 건너뛰어도 됩니다. WSR의 start.bat가 필요한 cloudflared와 Node.js 의존성을 준비합니다.

Node.js ↗
02
CONFIGURATION

.env 설정

.env.example을 .env로 복사한 뒤 각 값을 자신의 환경에 맞게 수정하세요. .env가 없거나 필요한 값이 설정되지 않으면 start.bat를 실행하지 마세요.

Windows Command Prompt
copy .env.example .env

아래 두 값은 다음 단계의 Cloudflare Tunnel 설정에서 입력합니다.

MCP_PUBLIC_URLCloudflare에서 연결할 공개 MCP 주소
CLOUDFLARE_TUNNEL_TOKENCloudflare Tunnel 생성 후 발급받은 토큰
MCP_PORT기본 MCP 포트. Cloudflare Service URL의 포트와 같아야 합니다.
MCP_HOST로컬 MCP 서버가 바인딩할 주소
MCP_GODOT_ENABLEDGodot MCP 사용 여부. 기본값은 false
MCP_GODOT_URL이미 준비된 Godot MCP 주소. 사용 시 enabled를 true로 변경
MCP_WORKSPACE_ROOTSalias:경로 형식으로 여러 워크스페이스를 등록합니다. 쉼표로 구분하세요. 예: ec:D:\Godot\ether-chronicle_v01, ether:D:\Godot\ether-chronicle, wsr:D:\project\windows-scoped-remote-mcp-server
ec:D:\\Godot\\ether-chronicle_v01, ether:D:\\Godot\\ether-chronicle, wsr:D:\\project\\windows-scoped-remote-mcp-server
MCP_WORKSPACE_ROOT접속 시 처음 사용할 기본 워크스페이스 경로입니다. 예: D:\Godot\ether-chronicle_v01
D:\\Godot\\ether-chronicle_v01
03
CLOUDFLARE TUNNEL

Cloudflare Tunnel 연결

별도의 cloudflared 설치는 필요하지 않습니다. start.bat가 필요한 cloudflared 실행 파일을 준비합니다. 아래 순서로 Cloudflare Tunnel을 만들고 공개 주소를 연결하세요.

1

Cloudflare Zero Trust로 이동

Cloudflare Dashboard에 로그인한 후 왼쪽 메뉴 하단의 Zero Trust 대시보드로 이동합니다. 처음이라 요금제를 선택해야 한다면 무료 플랜인 Free를 선택하세요.

Cloudflare Dashboard ↗
2

Tunnel 만들기

Zero Trust 좌측 메뉴에서 Networks → Tunnels로 이동합니다. Create a tunnel(또는 Add a tunnel)을 클릭하고 Cloudflared를 선택한 뒤 Next를 누릅니다. 터널 이름(예: wsr)을 입력하고 Save tunnel을 클릭합니다.

3

Tunnel 토큰을 .env에 입력

화면의 4 Run the following command 영역에 표시된 명령을 복사해 메모장에 붙여 넣으세요. 명령 안에 있는 긴 문자열이 실제 Tunnel 토큰입니다. 그 값을 .env의 CLOUDFLARE_TUNNEL_TOKEN에 넣은 후 Next를 클릭하세요.

Run the following command
cloudflared tunnel run --token <YOUR_TUNNEL_TOKEN>
4

공개 주소와 로컬 서비스 연결

다음 화면에서 공개 호스트 이름과 로컬 MCP 서버를 연결합니다. 완료 후 공개주소(예: https://wsr.example.com) 값을 .env의 MCP_PUBLIC_URL 값으로 입력하세요.

Subdomain원하는 서브도메인. 예: wsr
Domain소유하고 있는 도메인 선택
Typehttps
URLlocalhost:12000

Service의 URL 포트(12000)는 .env의 MCP_PORT 값과 동일해야 합니다. 마지막으로 Complete setup을 클릭하세요.

04
CHATGPT

ChatGPT에 WSR 연결

Cloudflare Tunnel 설정이 끝났다면 ChatGPT에서 WSR을 플러그인으로 연결하세요. 이 단계에서 ChatGPT가 WSR의 MCP 액션을 사용할 수 있도록 설정합니다.

1

ChatGPT 설정으로 이동

ChatGPT 사이트에 접속한 후 왼쪽 하단의 프로필을 클릭하고 설정으로 이동하세요.

2

개발자 모드 켜기

설정의 플러그인 탭에서 개발자 모드를 선택하고 개발자 모드가 ON인지 확인한 후 설정을 닫으세요.

3

플러그인 추가

왼쪽 메뉴에서 플러그인을 선택한 다음 + 버튼을 클릭하여 플러그인을 추가하세요.

4

WSR 플러그인 정보 입력

  • icon.png 파일을 플러그인 아이콘으로 등록하세요.
  • 이름을 입력하세요. 예: wsr
  • 연결 주소에 Cloudflare의 접속 주소를 입력하세요. .env의 MCP_PUBLIC_URL 값과 동일합니다.
  • 인증 방식은 OAuth를 선택하세요.
  • 입력을 완료한 후 만들기를 클릭하세요.
  • OAuth 인증 화면이 나오면 .env의 MCP_AUTH_TOKEN 값을 입력하세요.
  • 목록에 액션이 보이지 않으면 권한을 모든 액션 허용으로 선택하고 새로고침하세요.
05
START

WSR 실행

.env 설정과 Cloudflare Tunnel 연결을 모두 완료했다면 start.bat를 실행하세요. 배치 파일이 필요한 cloudflared를 준비하고 Node.js 패키지를 설치한 뒤 WSR을 실행합니다.

Windows
start.bat

.env 파일이 없으면 start.bat가 실행되지 않도록 구성되어 있습니다. 먼저 .env.example을 복사하고 필요한 값을 모두 설정하세요.

✓ WSR 실행
✓ Cloudflare Tunnel Connected
✓ HTTPS endpoint 확인
NEXT

설정이 끝났다면
WSR의 기능을 확인하세요.

기능 살펴보기 →