Claude 엔지니어 팀이 Claude Desktop SDK 브릿지와 supergateway HTTP 변환층을 조합해 Cowork VM 내에서 18개 이상의 MCP 서버를 동작시킴

Context

Claude Code의 Cowork 모드는 샌드박스 VM 내에서 실행되기 때문에 로컬 머신의 자식 프로세스로 실행되는 stdio MCP 서버와 연결할 수 없다. VM이 로컬 프로세스에 접근 권한이 없어 커뮤니티에서는 "Cowork에서 MCP를 지원하지 않는다"는 통념이 형성되었다.

Technical Solution

• Claude Desktop의 claude_desktop_config.json에 MCP 서버를 설정하면 Desktop SDK 레이어가 자동으로 stdio 서버들을 Cowork VM으로 프록시 전달 (type: sdk로 표시됨)
• supergateway를 사용해 stdio MCP 서버를 HTTP 엔드포인트로 변환 (각 서버마다 별도 포트 8001~800x 할당)
• npm으로 전역 설치한 supergateway와 각 MCP 서버를 실행하는 쉘 스크립트 작성 (alphabanana, mermaid, pandoc, antv-chart, un-markdown 등 포함)
• PM2로 프로세스 관리 및 자동 재시작 설정 (pm2 start, pm2 save, pm2 startup)
• 프로젝트의 .mcp.json에 type을 "streamable-http"로 지정하고 http://localhost:8001/mcp 형태의 URL 등록
• (선택사항) Tailscale 네트워크 구성 시 localhost 대신 Tailscale IP를 사용해 다른 기기에서도 MCP 서버 접근 가능

Impact

18개 이상의 MCP 서버가 Cowork 내에서 동시 활성화, PM2의 자동 재시작으로 다운타임 없음, 첫 시도에서 성공

Key Takeaway

Claude Desktop + Cowork 조합은 SDK 자동 프록시 레이어와 HTTP 브릿지 레이어의 이중 구조로 설계되어 있으며, 이 두 메커니즘을 통합하면 로컬 stdio 프로토콜의 제약을 넘어 팀 협업 플랫폼으로서의 실질적 가치를 확보할 수 있다.