Claude는 MCP 서버를 실행하기 위해 다음과 같은 JSON 구조의 명령을 실행
{
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"run",
"notion-api-mcp",
"--config", "{...}"
]
}이 JSON은 다음과 같은 쉘 명령과 동일한 동작을 합니다:
npx -y @smithery/cli run notion-api-mcp --config '{...}'npx란?
npx는 Node.js에 포함된 CLI 도구로, npm 패키지를 전역 설치 없이 즉시 실행할 수 있도록 해주는 명령어입니다.
예시
npx cowsay "Hello"→ cowsay 패키지를 설치하지 않고도 바로 실행 가능
@smithery/cli란?
@smithery/cli는 smithery.ai에서 제공하는 CLI 도구로, Claude에서 사용할 수 있는 MCP 서버를 실행해주는 역할을 담당합니다.
주요 기능
- Notion, GitHub, SQLite 등 외부 도구를 MCP 서버로 실행
- 실행된 MCP 서버는 JSON-RPC 형식으로 Claude와 통신
- 각 도구를 Claude의 도구 목록(tool)으로 등록 가능
단계별 실행 흐름
| 단계 | 설명 |
|---|---|
npx | CLI 툴을 설치 없이 즉시 실행 |
@smithery/cli | MCP 서버 실행을 위한 명령 프레임워크 |
run notion-api-mcp | 특정 기능을 가진 MCP 서버 실행 |
--config | Notion API 키, 데이터베이스 ID 등 설정 값 전달 |
Claude MCP 연결 구조
Claude는 MCP 서버 실행 후, 아래와 같은 구조로 통신합니다:
claude_desktop_config.json
↓
npx @smithery/cli run [mcp-server]
↓
[MCP 서버 - JSON-RPC 로컬 서버]
↓
Claude 내부 MCP 클라이언트가 연결 및 사용이 구조의 장점
- MCP 서버를 설치 없이 빠르게 실행 가능
- 다양한 외부 서비스와 유연하게 통합 가능
- API 키 등 민감 정보는 로컬에만 존재하여 보안 유지 가능
요약 정리
| 항목 | 의미 |
|---|---|
npx | npm 패키지를 설치 없이 실행하는 명령어 |
@smithery/cli | MCP 서버 실행용 CLI 도구 |
| Claude에서의 역할 | JSON 명령을 통해 외부 도구를 MCP 서버로 실행하고 JSON-RPC로 연결함 |
