Claude Code에 MCP 서버 연결하기 — 등록·확인·범위
Claude Code는 claude mcp add 한 줄로 외부 도구를 붙일 수 있어요. 인터넷 서버와 내 컴퓨터에서 도는 서버를 붙이는 법, 연결 상태를 읽는 법, 이 프로젝트에만 쓸지 모든 프로젝트에 쓸지(범위)까지 공식 문서 순서대로 익혀요.
따라 하기
1단계
인터넷 서버 하나 등록해 보기
- ›일반 터미널(claude 대화 밖)에서 아래 명령을 실행합니다.
- 공식 문서(2026-09-15 확인)가 연습용으로 쓰는, 로그인 없이 되는 Claude Code 문서 검색 서버예요.
- --transport http는 인터넷 주소로 접속하는 서버라는 뜻이고, claude-code-docs는 내가 붙이는 이름입니다.
claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp
Terminal
➜ ~ node -v
v20.11.0
➜ ~ npm -v
10.2.4
# 버전이 표시되면 설치 완료
막히면 볼 것
자주 하는 실수 3가지
- claude 대화 안에서 claude mcp add를 입력함 — 대화를 시작하기 전 일반 터미널에서 실행하는 명령이에요(대화 안에서는 /mcp로 관리)
- Claude 데스크톱 앱의 claude_desktop_config.json을 고치고 Claude Code에 반영되길 기다림 — 둘은 다른 앱이에요. 옮기려면 claude mcp add-from-claude-desktop(macOS·WSL)
- 서버를 잔뜩 연결해 둠 — 연결한 서버마다 도구 설명이 매 대화의 맥락을 차지해요. 안 쓰는 서버는 claude mcp remove로 지우세요(공식 문서)