활용 사례 · Claude Code
모든 MCP 서버를 하나의 엔드포인트로 Claude Code에.
서버를 하나씩 연결하는 대신 Claude Code를 단일 onemcp 포털로 향하게 하세요. `claude mcp add` 한 번이면 전체 도구 세트를 쓸 수 있습니다 — 수백 개의 도구 정의를 매 프롬프트에 채워 넣지 않고도.
세 단계로 Claude Code 연결
- 1
포털 만들기
원하는 MCP 서버를 하나의 onemcp 포털로 모으고 각각 한 번씩 인증합니다.
- 2
명령 하나 추가
포털 URL로 `claude mcp add`를 한 번 실행 — Claude Code에서 서버별 설정이 필요 없습니다.
- 3
에이전트가 스크립트로
Claude Code는 필요할 때 도구를 찾아 Code Mode로 한 번의 왕복에 호출합니다.
터미널에서 실행:
onemcp
claude mcp add onemcp --transport http https://portal.onemcp.dev/mcp
Claude Code를 onemcp로 연결하는 이유
하나의 엔드포인트, 모든 도구
업스트림 서버를 포털에서 교체·추가하세요. Claude Code는 다시 설정할 필요가 없습니다.
자격 증명은 호스트 측에
네이티브 업스트림 OAuth와 토큰은 포털에 있고, Claude Code 설정에는 들어가지 않습니다.
더 가벼운 컨텍스트 창
세 개의 메타 도구가 수백 개의 정의를 대체해, Claude Code가 컨텍스트를 작업에 씁니다.