Claude Code를 이용해 로컬 MCP 게이트웨이(Conduit)를 구축한 경험, 기능 및 배운 점

여기는 r/ClaudeAI 게시판이라 '무엇'만큼 '어떻게'가 유용할 수 있습니다. 저는 지난 48시간 동안 Claude Code를 사용해서 이것을 만들었습니다.

이것은 무엇인가요: 모든 MCP 서버들을 하나의 게이트웨이 뒤에 배치하는 로컬 데스크톱 앱입니다. 덕분에 이 서버들이 Claude Desktop, Claude Code, Cursor 및 기타 도구 전반에서 작동할 수 있습니다. 각 클라이언트마다 서버를 재설정할 필요 없이 한 번 설정하고 인증만 하면 됩니다. 무료이며 오픈 소스(MIT)이고, 현재 Windows용으로 제공되며 macOS/Linux도 곧 출시될 예정입니다.

왜 만들었나요: 저는 Claude Desktop + Claude Code와 몇 가지 다른 도구들을 사용하는데, 이 모든 곳에 걸쳐 MCP 서버를 관리하는 것이 매우 고통스러웠습니다. 같은 서버들이 각 앱마다 설정되어 있었고, API 키는 평문(plaintext)으로 저장되었으며, 모든 에이전트가 수백 개의 도구 정의 아래 파묻혀 있었습니다.

무엇을 하는가:

• 지연 발견 (Lazy discovery): 에이전트가 400개가 아닌 3개의 메타-도구만 보고 필요할 때 검색/호출하므로, 컨텍스트(context)를 작게 유지합니다.
• 키는 설정 파일이 아닌 OS 키체인에 저장됩니다.
• 에이전트별 프로필, 감사 로그(audit log), 그리고 내장 도구 플레이그라운드가 있습니다.

Claude가 어떻게 도움이 되었나 (흥미로운 부분): 이것은 Tauri 앱이며, Rust 게이트웨이와 React 프론트엔드로 구성되어 있는데, 저는 Rust 개발자가 아닙니다. Claude Code가 게이트웨이의 대부분, MCP 프로토콜 처리, OAuth 2.1 플로우, 그리고 키체인 통합을 작성해 주었습니다. 가장 어려웠던 부분은 Windows 전용 버그들이었고, Symptom(증상)별로 각각 진단했습니다:

• MSIX 경로 가상화 (Claude Desktop과 같은 패키지 앱이 %APPDATA%를 사일런트하게 리디렉션하여, 앱이 잘못된 설정을 읽고 있었습니다)
• 읽기 시간 제한(read timeout)이 없는 stdio 서버가 전체 상태 확인(health check)을 데드락시키던 문제
• 빠르게 재인증할 때 발생하는 OAuth 콜백 포트 충돌

배운 점: 여러 MCP 서버를 한 곳으로 라우팅하는 경우,

그리고 진심으로 궁금합니다. 현재 여러분의 MCP 설정에서 가장 짜증 나는 부분은 무엇인가요?
submitted by /u/kydude
[link] [comments]