---
title: "Claude Code를 모든 MCP 서버에 연결 — onemcp"
description: "하나의 엔드포인트로 Claude Code에 모든 MCP 도구를. 명령 하나로 모든 서버를 추가하고, 자격 증명은 호스트 측에, 컨텍스트도 넘치지 않게."
url: "https://onemcp.dev/ko/use-cases/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로 한 번의 왕복에 호출합니다.

터미널에서 실행:

```
claude mcp add onemcp --transport http https://portal.onemcp.dev/mcp
```

## Claude Code를 onemcp로 연결하는 이유

- **하나의 엔드포인트, 모든 도구** — 업스트림 서버를 포털에서 교체·추가하세요. Claude Code는 다시 설정할 필요가 없습니다.
- **자격 증명은 호스트 측에** — 네이티브 업스트림 OAuth와 토큰은 포털에 있고, Claude Code 설정에는 들어가지 않습니다.
- **더 가벼운 컨텍스트 창** — 세 개의 메타 도구가 수백 개의 정의를 대체해, Claude Code가 컨텍스트를 작업에 씁니다.

## 한 줄로 Claude Code에 도구를 주세요.

포털을 띄우고 명령 하나를 실행하면, 나머지는 Claude Code가 합니다.