MCP EXTENSIBILITY

필요한 MCP를
연결하고 확장하세요.

WSR은 특정 MCP나 하나의 transport에 종속되지 않습니다. 지원되는 Remote MCP를 Provider로 연결하고 namespace를 적용해 하나의 Gateway 안에서 확장할 수 있습니다.

MCP 서버를 켜고 AI에게 연결을 부탁하세요.

WSR의 MCP 확장 구조와 등록 방법은 skills 문서로 정의되어 있습니다. 새 Provider를 코드/설정에 추가한 최초 1회는 WSR을 재시작하고 Tool 목록을 새로고침하세요. 그 이후 Provider 서버의 실행·종료·재연결과 Tool 목록 변경은 Scheduler가 자동 추적하며, 지원하는 modern 클라이언트에는 변경 알림도 전달합니다.

① MCP 서버 준비→② AI에게 연결 요청→③ WSR 반영/재시작→④ 이후 상태 자동 추적

01 · HOW IT WORKS

MCP를 직접 구현하지 않고 Provider로 연결합니다.

RemoteMcpProvider가 외부 MCP의 연결과 tool 호출을 담당하고 ProviderRegistry가 이를 WSR의 MCP Server에 노출합니다. 새로운 MCP마다 별도의 Gateway를 만들 필요가 없습니다.

Remote MCP→RemoteMcpProvider→WSR Gateway→ChatGPT

02 · ADD A PROVIDER

새 MCP를 연결하는 기본 흐름

실제 사용자는 연결 정보를 준비해 AI에게 작업을 요청하는 방식으로 확장할 수 있습니다. 개발자는 아래 구조만 이해하면 됩니다.

연결 정보를 확인

MCP의 endpoint, transport, 인증 방식, tools/list 지원 여부와 실행 방법을 확인합니다.

MCP endpoint
transport · auth
tools/list · JSON Schema

Provider로 등록

RemoteMcpProvider를 재사용해 id, namespace, URL을 등록합니다.

id: blender
namespace: blender
url: http://127.0.0.1:xxxx/mcp

Namespace 적용

원격 tool 이름 앞에 Provider namespace를 붙여 충돌을 방지합니다.

get_scene
↓
godot_get_scene

독립적으로 운영

Provider가 꺼져도 WSR Core와 다른 기능은 계속 동작합니다.

Core tools ✓
Playwright ✓
Provider unavailable

03 · EXAMPLE

이미 연결된 Godot MCP

Godot MCP는 이 구조를 사용하는 실제 예입니다. 같은 패턴으로 Blender나 다른 Remote MCP도 연결할 수 있습니다.

new RemoteMcpProvider({
  id: "godot",
  namespace: "godot",
  url: "http://127.0.0.1:8000/mcp",
})

04 · RESILIENCE

Provider 하나가 꺼져도 Gateway는 계속됩니다.

ProviderScheduler가 상태를 확인하고 연결이 끊긴 Provider는 다시 연결을 시도합니다. Tool 목록이 바뀌면 Registry snapshot을 갱신하고, 지원하는 modern MCP 클라이언트에는 tools/list_changed 알림을 전달합니다.

ProviderSchedulerhealth check · reconnect · tools/list · notify

10s연결된 Provider health check

5s연결되지 않은 Provider 재시도

✦

AI-FIRST WORKFLOW

사람보다 AI가 연결 작업을 수행할 수 있도록.

MCP 확장은 반복적인 설정 작업이 많은 영역입니다. WSR의 구조를 이해한 AI에게 원하는 MCP를 연결하도록 요청하는 방식도 자연스럽게 사용할 수 있습니다.

필요한 MCP를연결하고 확장하세요.