Model Context Protocol을 사용하여 Claude Code를 도구에 연결하는 방법을 알아보세요.
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
claude mcp add --transport http socket https://mcp.socket.dev/
claude mcp add --transport http hugging-face https://huggingface.co/mcp
claude mcp add --transport http jam https://mcp.jam.dev/mcp
claude mcp add --transport sse asana https://mcp.asana.com/sse
claude mcp add --transport sse atlassian https://mcp.atlassian.com/v1/sse
claude mcp add clickup --env CLICKUP_API_KEY=YOUR_KEY --env CLICKUP_TEAM_ID=YOUR_ID -- npx -y @hauptsache.net/clickup-mcp
claude mcp add --transport http intercom https://mcp.intercom.com/mcp
claude mcp add --transport sse linear https://mcp.linear.app/sse
claude mcp add --transport http notion https://mcp.notion.com/mcp
claude mcp add --transport http box https://mcp.box.com/
claude mcp add --transport http fireflies https://api.fireflies.ai/mcp
claude mcp add --transport sse monday https://mcp.monday.com/sse
claude mcp add airtable --env AIRTABLE_API_KEY=YOUR_KEY -- npx -y airtable-mcp-server
claude mcp add --transport http daloopa https://mcp.daloopa.com/server/mcp
claude mcp add --transport http hubspot https://mcp.hubspot.com/anthropic
claude mcp add --transport http paypal https://mcp.paypal.com/mcp
claude mcp add --transport sse plaid https://api.dashboard.plaid.com/mcp/sse
claude mcp add --transport sse square https://mcp.squareup.com/sse
claude mcp add --transport http stripe https://mcp.stripe.com
claude mcp add --transport http figma-dev-mode-mcp-server http://127.0.0.1:3845/mcp
claude mcp add --transport sse invideo https://mcp.invideo.io/sse
claude mcp add --transport http canva https://mcp.canva.com/mcp
claude mcp add --transport http netlify https://netlify-mcp.netlify.app/mcp
claude mcp add --transport http stytch http://mcp.stytch.dev/mcp
claude mcp add --transport http vercel https://mcp.vercel.com/
--
(이중 대시)는 Claude의 CLI 플래그와 MCP 서버로 전달되는 명령 및 인수를 구분합니다. --
앞의 모든 것은 Claude의 옵션(--env
, --scope
등)이고, --
뒤의 모든 것은 MCP 서버를 실행하는 실제 명령입니다.예를 들어:claude mcp add myserver -- npx server
→ npx server
실행claude mcp add myserver --env KEY=value -- python server.py --port 8080
→ 환경에 KEY=value
를 설정하고 python server.py --port 8080
실행--scope
플래그를 사용하여 구성이 저장되는 위치를 지정하세요:
local
(기본값): 현재 프로젝트에서 본인만 사용 가능 (이전 버전에서는 project
라고 불림)project
: .mcp.json
파일을 통해 프로젝트의 모든 사람과 공유user
: 모든 프로젝트에서 본인이 사용 가능 (이전 버전에서는 global
이라고 불림)--env
플래그로 환경 변수 설정 (예: --env KEY=value
)MCP_TIMEOUT=10000 claude
는 10초 타임아웃 설정)MAX_MCP_OUTPUT_TOKENS
환경 변수를 설정하세요 (예: MAX_MCP_OUTPUT_TOKENS=50000
)/mcp
를 사용하세요npx
를 사용하는 로컬 MCP 서버는 적절한 실행을 보장하기 위해 cmd /c
래퍼가 필요합니다.cmd /c
래퍼 없이는 Windows가 npx
를 직접 실행할 수 없어 “Connection closed” 오류가 발생합니다. (--
매개변수에 대한 설명은 위의 참고사항을 참조하세요.).mcp.json
파일에 구성을 저장하여 팀 협업을 가능하게 합니다. 이 파일은 버전 관리에 체크인되도록 설계되어 모든 팀 구성원이 동일한 MCP 도구와 서비스에 액세스할 수 있도록 보장합니다. project 범위 서버를 추가하면 Claude Code가 자동으로 이 파일을 적절한 구성 구조로 생성하거나 업데이트합니다.
.mcp.json
파일은 표준화된 형식을 따릅니다:
.mcp.json
파일의 project 범위 서버를 사용하기 전에 승인을 요청합니다. 이러한 승인 선택을 재설정해야 하는 경우 claude mcp reset-project-choices
명령을 사용하세요.
.mcp.json
에서 환경 변수 확장.mcp.json
파일에서 환경 변수 확장을 지원하여 팀이 머신별 경로와 API 키와 같은 민감한 값에 대한 유연성을 유지하면서 구성을 공유할 수 있게 합니다.
지원되는 구문:
${VAR}
- 환경 변수 VAR
의 값으로 확장${VAR:-default}
- VAR
가 설정되어 있으면 VAR
로, 그렇지 않으면 default
를 사용command
- 서버 실행 파일 경로args
- 명령줄 인수env
- 서버로 전달되는 환경 변수url
- SSE/HTTP 서버 유형용headers
- SSE/HTTP 서버 인증용인증이 필요한 서버 추가
Claude Code 내에서 /mcp 명령 사용
/mcp
메뉴에서 “Clear authentication”을 사용하여 액세스를 취소하세요JSON에서 MCP 서버 추가
서버가 추가되었는지 확인
--scope user
를 사용할 수 있습니다Claude Desktop에서 서버 가져오기
가져올 서버 선택
서버가 가져와졌는지 확인
--scope user
플래그를 사용하세요server_1
)MAX_MCP_OUTPUT_TOKENS
환경 변수를 사용하여 허용되는 최대 MCP 출력 토큰을 조정할 수 있습니다사용 가능한 리소스 나열
@
를 입력하여 연결된 모든 MCP 서버의 사용 가능한 리소스를 확인하세요. 리소스는 자동완성 메뉴에서 파일과 함께 나타납니다.특정 리소스 참조
@server:protocol://resource/path
형식을 사용하여 리소스를 참조하세요:여러 리소스 참조
사용 가능한 프롬프트 발견
/
를 입력하여 MCP 서버의 명령을 포함한 모든 사용 가능한 명령을 확인하세요. MCP 프롬프트는 /mcp__servername__promptname
형식으로 나타납니다.인수 없이 프롬프트 실행
인수와 함께 프롬프트 실행