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로 복사하고 workspaces.example.json을 workspaces.local.json으로 복사한 뒤 자신의 환경에 맞게 수정하세요. 첫 번째 Workspace가 기본 활성 Workspace가 됩니다.

Windows Command Prompt
copy .env.example .env
copy workspaces.example.json workspaces.local.json

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

MCP_PUBLIC_URLCloudflare에 노출할 기본 공개 URL입니다. /mcp를 붙이지 마세요. 예: https://wsr.example.com
MCP_ENDPOINTChatGPT가 실제로 연결할 MCP 경로입니다. 기본값은 /mcp이며 최종 주소는 MCP_PUBLIC_URL + MCP_ENDPOINT입니다.
/mcp
CLOUDFLARE_TUNNEL_TOKENCloudflare Tunnel 생성 후 발급받은 토큰
MCP_PORT기본 MCP 포트. Cloudflare Service URL의 포트와 같아야 합니다.
MCP_HOST로컬 MCP 서버가 바인딩할 주소
MCP_GODOT_ENABLEDGodot AI MCP 사용 여부. 기본값은 false
MCP_GODOT_HTTP_PORT / MCP_GODOT_WS_PORTGodot AI v4.3의 attach 브리지가 사용할 HTTP/WS 포트. 기본값은 8001/8002
MCP_WORKSPACE_FILEworkspaces.example.json을 workspaces.local.json으로 복사해 한 항목씩 등록합니다. 첫 번째 항목이 자동으로 활성 워크스페이스가 됩니다.
workspaces.local.json
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에 입력하세요. 여기에는 /mcp를 붙이지 않습니다.

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

Service의 URL 포트(12000)는 .env의 MCP_PORT 값과 동일해야 합니다. ChatGPT에는 MCP_PUBLIC_URL + MCP_ENDPOINT, 예를 들어 https://wsr.example.com/mcp를 등록합니다.

04
START

WSR 실행

.env와 Workspace 설정, Cloudflare Tunnel 연결을 완료했다면 start.bat를 실행하세요. uvx가 없으면 자동 설치하고 cloudflared와 Node.js 패키지를 준비한 뒤 WSR을 실행합니다.

Windows
start.bat

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

✓ WSR 실행
✓ Cloudflare Tunnel Connected
✓ HTTPS endpoint 확인
05
CHATGPT

ChatGPT에 WSR MCP 앱 연결

WSR과 Cloudflare Tunnel이 실행 중이라면 ChatGPT에 WSR을 Custom MCP app으로 등록합니다. 최근 ChatGPT에서 Plugin과 MCP app은 별도 개념이며 WSR 자체 연결은 MCP app 생성 흐름을 사용합니다.

1

Apps 설정 열기

ChatGPT에서 Settings → Apps → Create로 이동하세요. 관리형 Workspace에서는 Workspace Settings → Apps → Create 경로를 사용할 수 있습니다.

2

Developer mode 확인

플랜 또는 Workspace 정책상 필요한 경우 Developer mode를 활성화하세요. 위치는 Settings → Apps → Advanced Settings 또는 Workspace 설정일 수 있습니다.

3

Custom MCP app 만들기

새 앱을 만들고 WSR의 MCP endpoint와 인증 방식을 설정합니다. MCP endpoint는 MCP_PUBLIC_URL 자체가 아니라 MCP_PUBLIC_URL + MCP_ENDPOINT입니다.

4

WSR 연결 정보와 Tool 스캔

  • 아이콘/로고는 필요하면 icon.png를 사용하세요.
  • 이름: wsr
  • MCP endpoint 예: https://wsr.example.com/mcp
  • 인증 방식: OAuth
  • 먼저 Scan Tools를 실행하세요.
  • WSR 승인 화면이 열리면 .env의 MCP_AUTH_TOKEN 값을 입력하고 승인하세요.
  • Tool scan이 끝나면 앱 생성을 완료합니다. Godot/Blender 등 Provider Tool이 바뀌면 Refresh / Scan Tools를 다시 실행하세요.
06
VERIFY

WSR 연결 확인

ChatGPT에서 WSR MCP app을 선택한 뒤 서버 상태, Workspace 목록, Provider 연결 상태를 확인하세요. Provider Tool이 바뀌었다면 먼저 Refresh / Scan Tools를 실행합니다.

MCP tools
wsr_status
list_workspaces
mcp_provider_status
✓ wsr_status로 Gateway 운영 상태 확인
✓ list_workspaces로 Workspace 목록 확인
✓ mcp_provider_status로 Godot/Blender 등 Provider 상태 확인
NEXT

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

기능 살펴보기 →