Model Context Protocol(MCP)은 LLM이 외부 도구 및 데이터 소스에 접근할 수 있도록 해주는 오픈 프로토콜입니다. 자세한 내용은 MCP 공식 문서를 참고하세요.
서드파티 MCP 서버는 신뢰할 수 있는 경우에만 사용하세요. 특히 인터넷과 통신하는 MCP 서버는 프롬프트 인젝션 위험이 있으니 각별히 주의해야 합니다.
MCP 서버 구성하기
언제 사용하나요?
Claude의 기능을 확장하기 위해 MCP를 통해 특화된 도구나 외부 서버를 연결하고 싶을 때 사용합니다.
1. MCP stdio 서버 추가
# 기본 문법
claude mcp add <이름> <명령어> [인자...]
# 예시: 로컬 서버 추가
claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg22. MCP SSE 서버 추가
# 기본 문법
claude mcp add --transport sse <이름> <url>
# 예시: SSE 서버 추가
claude mcp add --transport sse sse-server https://example.com/sse-endpoint3. MCP 서버 관리
# 등록된 서버 목록 확인
claude mcp list
# 특정 서버 상세 정보 확인
claude mcp get my-server
# 서버 삭제
claude mcp remove my-server팁:
-s또는--scope플래그로 설정 저장 위치를 지정할 수 있습니다.local(기본값): 현재 프로젝트에서만 사용(이전 버전의 project와 동일)project:.mcp.json파일을 통해 팀 전체와 공유user: 모든 프로젝트에서 사용(이전 버전의 global과 동일)
-e또는--env플래그로 환경 변수를 설정할 수 있습니다(예:-e KEY=value).- MCP 서버 시작 타임아웃은 MCP_TIMEOUT 환경 변수로 지정할 수 있습니다(예:
MCP_TIMEOUT=10000 claude는 10초 타임아웃). /mcp명령으로 언제든 서버 상태를 확인할 수 있습니다.- MCP는 클라이언트-서버 아키텍처로, Claude Code(클라이언트)가 여러 특화 서버에 연결할 수 있습니다.
MCP 서버 스코프 이해하기
언제 사용하나요?
MCP 서버의 스코프(범위)를 이해하고, 팀과 서버를 공유하고 싶을 때 사용합니다.
1. 로컬 스코프 MCP 서버
기본 스코프(local)는 프로젝트별 사용자 설정에 MCP 서버 구성을 저장합니다. 이 서버는 해당 프로젝트에서만 본인에게 보입니다.
# 로컬 스코프 서버 추가(기본값)
claude mcp add my-private-server /path/to/server
# 명시적으로 local 스코프 지정
claude mcp add my-private-server -s local /path/to/server2. 프로젝트 스코프 MCP 서버(.mcp.json)
프로젝트 스코프 서버는 프로젝트 루트의 .mcp.json 파일에 저장됩니다. 이 파일을 버전 관리에 포함해 팀과 공유할 수 있습니다.
# 프로젝트 스코프 서버 추가
claude mcp add shared-server -s project /path/to/server.mcp.json 파일 예시:
{
"mcpServers": {
"shared-server": {
"command": "/path/to/server",
"args": [],
"env": {}
}
}
}3. 사용자 스코프 MCP 서버
사용자 스코프 서버는 내 모든 프로젝트에서 사용 가능하며, 나만 볼 수 있습니다.
# 사용자 스코프 서버 추가
claude mcp add my-user-server -s user /path/to/server팁:
- 같은 이름의 서버가 여러 스코프에 있을 때, 우선순위는 local > project > user입니다.
.mcp.json의 프로젝트 스코프 서버는 사용 전 보안 프롬프트로 승인해야 합니다..mcp.json은 팀 전체가 동일 MCP 도구를 쓸 수 있도록 버전 관리에 포함하세요.- 프로젝트 스코프 서버 사용 여부를 초기화하려면
claude mcp reset-project-choices명령을 사용하세요.
Postgres MCP 서버 연결하기
언제 사용하나요?
Claude에게 PostgreSQL 데이터베이스에 대한 읽기 전용 접근 권한을 부여해 쿼리 및 스키마 분석을 하고 싶을 때 사용합니다.
1. Postgres MCP 서버 추가
claude mcp add postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"2. 데이터베이스 쿼리하기
Claude 세션에서 다음과 같이 데이터베이스에 대해 질문할 수 있습니다:
> describe the schema of our users table
> what are the most recent orders in the system?
> show me the relationship between customers and invoices팁:
- Postgres MCP 서버는 안전을 위해 읽기 전용입니다.
- Claude가 데이터베이스 구조를 탐색하고 분석 쿼리를 실행하는 데 도움을 줄 수 있습니다.
- 낯선 프로젝트의 데이터베이스 구조를 빠르게 파악할 때 유용합니다.
- 연결 문자열에는 최소 권한의 적절한 계정을 사용하세요.
JSON 구성으로 MCP 서버 추가하기
언제 사용하나요?
단일 MCP 서버에 대한 JSON 구성이 있을 때 Claude Code에 추가하고 싶을 때 사용합니다.
1. JSON으로 MCP 서버 추가
# 기본 문법
claude mcp add-json <이름> '<json>'
# 예시: stdio 서버를 JSON으로 추가
claude mcp add-json weather-api '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'2. 서버 추가 확인
claude mcp get weather-api팁:
- JSON은 셸에서 올바르게 이스케이프해야 합니다.
- JSON은 MCP 서버 구성 스키마를 따라야 합니다.
-s global로 글로벌 설정에 추가할 수도 있습니다.
Claude Desktop에서 MCP 서버 가져오기
언제 사용하나요?
Claude Desktop에서 이미 MCP 서버를 설정해두었고, 이를 Claude Code에서도 사용하고 싶을 때 사용합니다.
1. Claude Desktop에서 서버 가져오기
# 기본 문법
claude mcp add-from-claude-desktop2. 가져올 서버 선택
명령 실행 후, 가져올 서버를 선택할 수 있는 대화형 창이 나타납니다.
3. 서버 가져오기 확인
claude mcp list팁:
- 이 기능은 macOS와 Windows Subsystem for Linux(WSL)에서만 동작합니다.
- 표준 위치의 Claude Desktop 설정 파일을 읽어옵니다.
-s global로 글로벌 설정에 추가할 수 있습니다.- 동일 이름의 서버가 이미 있으면 숫자 접미사가 붙습니다(예:
server_1).
Claude Code를 MCP 서버로 사용하기
언제 사용하나요?
Claude Code 자체를 MCP 서버로 실행해, 다른 애플리케이션에서 Claude의 도구와 기능을 활용하고 싶을 때 사용합니다.
1. Claude를 MCP 서버로 시작
# 기본 문법
claude mcp serve2. 다른 애플리케이션에서 연결
Claude Code MCP 서버는 어떤 MCP 클라이언트에서도 연결할 수 있습니다. Claude Desktop을 사용하는 경우, 다음과 같이 MCP 서버를 추가할 수 있습니다:
{
"command": "claude",
"args": ["mcp", "serve"],
"env": {}
}팁:
- 이 서버는 View, Edit, LS 등 Claude의 도구에 접근할 수 있습니다.
- Claude Desktop에서 디렉터리 내 파일 읽기, 편집 등 다양한 작업을 시도해보세요.
- 이 MCP 서버는 Claude Code의 도구를 MCP 클라이언트에 노출할 뿐이므로, 각 클라이언트가 개별 도구 호출에 대한 사용자 승인을 구현해야 합니다.
