[Claude Code 입문 E32] MCP 개념과 설치: 외부 도구·DB·API를 Claude Code 안으로 끌어들이는 표준

이 채널의 번역 음성 트랙 상당수는 HeyGen으로 제작됩니다. AI 영상 번역, 더빙, 다국어 콘텐츠 제작에 관심이 있다면 HeyGen을 여기서 사용해 보세요: https://bit.ly/4o4bn9P 이 링크를 통해 가입하시면 채널에 도움이 됩니다 — 감사합니다! 28~31차시에서 Claude Code *내부*의 제어 흐름을 다듬는 Hooks를 봤다면, 32차시부터는 섹션 7 *MCP 서버 연동*입니다. 방향이 정반대 — Sentry·JIRA·PostgreSQL·Figma 같은 외부 시스템을 Claude Code 안으로 끌어들이는 오픈 표준 MCP(Model Context Protocol)를 정리합니다. 📌 다루는 내용 - MCP 핵심: Anthropic이 시작한 오픈 표준. 사용자가 데이터를 *복사해 붙여 넣는* 흐름과 Claude가 외부 시스템에 *직접 접근*하는 흐름의 차이 - 3자 아키텍처: host(Claude Code) / client(서버마다 하나, 1:1 매핑) / server(외부 시스템). 로컬·원격 모두 명세상 같은 server - 2단 레이어 분리: 데이터 레이어(JSON-RPC 2.0, lifecycle·capabilities) / 전송 레이어(stdio·HTTP). 같은 메시지가 다른 전송으로 흐른다 - 세 primitives와 제어권: Tools(모델이 호출) / Resources(앱이 @로 가져옴, Direct·Template 두 종류) / Prompts(사용자가 /mcp__서버__이름으로 호출) - 세 전송 비교: Streamable HTTP(권장, SaaS) / SSE(deprecated) / stdio(로컬 자식 프로세스). type 필드는 http와 streamable-http를 같은 것으로 본다 - claude mcp add 옵션 순서: --transport·--env·--scope·--header는 모두 name 앞에, stdio는 -- 뒤에 실제 명령. HTTP는 --header로 Bearer 토큰, OAuth는 /mcp로 마무리 - 스코프 셋: local(기본, 나만) / project(.mcp.json 팀 공유, 첫 사용 시 승인 필요) / user(내 모든 프로젝트). 우선순위 local 〉 project 〉 user - 신뢰의 문제: Anthropic Directory는 심사지 보안 감사가 아님, prompt injection 위험, 첫 연결 시 trust verification - 출력 한도와 타임아웃: 경고 10K·상한 25K 토큰, MAX_MCP_OUTPUT_TOKENS·MCP_TIMEOUT·서버별 timeout - claude mcp serve로 Claude Code를 거꾸로 MCP 서버로 노출 (Claude Desktop에서 호출) 📌 환경 정보 - Claude Code 최신 버전 (MCP 클라이언트 내장) - claude mcp add / list / get / remove / add-json / add-from-claude-desktop / serve 서브커맨드 - /mcp 슬래시 커맨드 (인증·재시도·도구 개수 확인) - .mcp.json (프로젝트 루트, git 커밋 대상), ~/.claude.json (local·user 스코프) - 환경 변수: MAX_MCP_OUTPUT_TOKENS, MCP_TIMEOUT, CLAUDE_CODE_MCP_ALLOWLIST_ENV 📌 챕터 0:00 들어가며 — Hook(내부)에서 MCP(외부)로 0:57 MCP란 — AI를 위한 USB-C 포트, 오픈 표준의 의미 1:51 MCP 없을 때 AI가 일하는 세 경로의 한계 2:59 host / client / server — 3자 아키텍처와 1:1 매핑 4:13 데이터 레이어(JSON-RPC 2.0) / 전송 레이어 분리 6:49 세 primitives — Tools / Resources / Prompts 제어권 차이 10:19 세 전송 방식 — HTTP / SSE / stdio 선택 기준 10:49 claude mcp add — HTTP·stdio 등록, 옵션 순서, 인증 13:05 스코프 셋 — local · project · user와 .mcp.json 17:43 신뢰의 문제 — Directory·prompt injection·trust verification 19:16 출력 한도·타임아웃·claude mcp serve 20:51 흔한 함정과 정리 📌 참고 링크 - 블로그: https://neosarchizo.github.io/posts/claude-code-32-mcp-concept-installation - Claude Code MCP 공식 문서: https://code.claude.com/docs/en/mcp - Model Context Protocol 공식 사이트: https://modelcontextprotocol.io/ - MCP 아키텍처 (host·client·server): https://modelcontextprotocol.io/docs/learn/architecture - MCP 서버 개념 (Tools·Resources·Prompts): https://modelcontextprotocol.io/docs/learn/server-concepts - Claude Code 보안 (MCP 위험 모델): https://code.claude.com/docs/en/security - Managed MCP (조직 차원 제한): https://code.claude.com/docs/en/managed-mcp - 환경 변수 (MCP_TIMEOUT·MAX_MCP_OUTPUT_TOKENS): https://code.claude.com/docs/en/env-vars - MCP 레퍼런스 서버 모음: https://github.com/modelcontextprotocol/servers - JSON-RPC 2.0 명세: https://www.jsonrpc.org/ #ClaudeCode #MCP #AI개발