MCP 입문 — 클로드에 내 도구·데이터 연결하기 (개념부터)

MCP 입문 — 클로드에 내 도구·데이터 연결하기 (개념부터)

클로드를 더 강력하게 쓰는 핵심이 바로 MCP입니다. 이 글은 MCP 사용법을 개념부터 첫 연결까지 입문자용으로 정리합니다. MCP(Model Context Protocol)는 클로드에 내 파일·도구·데이터를 연결하는 표준 규격이라고 생각하면 됩니다. 연결해두면 클로드가 내 환경의 자료를 읽고 작업까지 할 수 있습니다.

1. MCP가 뭐고 왜 필요한가

기본 상태의 클로드는 내 컴퓨터나 외부 서비스의 데이터를 알지 못합니다. MCP는 이 경계를 넓혀주는 ‘표준 콘센트’입니다. MCP 규격을 따르는 ‘MCP 서버’를 연결하면, 클로드가 그 서비스의 데이터를 읽고 정해진 작업을 수행할 수 있습니다. 예를 들어 파일시스템·깃허브·DB·검색 도구 등을 붙일 수 있습니다.

2. 첫 MCP 서버 연결하기 (Claude Code 기준)

Claude Code에서는 claude mcp add 명령으로 연결합니다. 기본 형태는 이렇습니다:

claude mcp add <서버이름> -- <실행명령> [인자...]

가장 흔한 예로, 로컬 파일을 다루는 파일시스템 서버를 연결해봅시다:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/projects

원격(HTTP) 서버는 --transport 옵션으로 붙입니다(클로드 코드용 플래그는 -- 앞에 옵니다):

claude mcp add --transport http context7 https://mcp.context7.com/mcp

연결 범위(scope)도 정할 수 있습니다. local(기본, 나만/이 프로젝트, ~/.claude.json, Git 미포함)과 project(.mcp.json, 팀 공유·Git 포함)가 대표적입니다. 개인 토큰이 들어가는 서버는 local로 두세요.

3. 연결 후 할 수 있는 일

  • 내 파일 다루기 — 폴더 내용을 읽고 정리·수정.
  • 외부 서비스 연동 — 깃허브 이슈, 데이터베이스 조회, 문서 검색 등(서버에 따라 다름).
  • 반복 작업 자동화 — 연결된 도구를 클로드가 필요할 때 알아서 호출.

현재 연결 상태는 claude mcp list로 확인할 수 있습니다.

4. 보안·권한 주의 (중요)

  • 신뢰할 수 있는 서버만 연결하세요. MCP 서버는 내 데이터에 접근할 수 있으므로 출처가 불분명한 서버는 피합니다.
  • 토큰·키 관리 — 개인 토큰이 필요한 서버는 local scope로 두고, Git에 올라가는 .mcp.json에는 비밀값을 넣지 마세요.
  • 권한 확인 — 클로드가 MCP 도구로 작업할 때도 변경 작업은 확인하고 진행하세요.

5. 안 될 때 점검

  • claude mcp list로 서버가 등록·연결됐는지 확인.
  • 명령 형식(특히 -- 위치)과 경로가 맞는지 확인.
  • 클로드 코드를 재시작하거나, 원격 서버는 주소·인증을 점검.
  • 자세한 옵션은 공식 문서를 참고하세요.

다음 단계

개념과 첫 연결을 익혔다면, 다음은 개발자가 실제로 유용하게 쓰는 MCP·스킬·플러그인을 골라보는 글로 이어집니다(순차 발행). 전체 로드맵은 개발자를 위한 클로드 활용법에서 볼 수 있습니다. (Claude Code 기본기는 워크플로우 글 참고.)

본 글은 정보 제공을 목적으로 하며, 명령·옵션은 버전에 따라 바뀔 수 있습니다. 최신 내용은 공식 문서를 확인하세요. 최종 확인일: 2026-05-22.

출처

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다

Back to top