Claude Code에 MCP 연결하기: claude mcp add부터 팀 공유까지

핵심 요약: Claude Code의 MCP 연결은 터미널 명령 한 줄(`claude mcp add`)이면 됩니다. 설정 범위는 세 가지 — 개인 전역, 프로젝트 개인, 그리고 팀 공유용 .mcp.json(저장소에 커밋). Cursor에서 쓰던 MCP 서버를 그대로 재사용할 수 있으므로, 이미 Cursor에 MCP를 연결해봤다면 새로 배울 것은 명령어 문법뿐입니다.

이 글에서 다루는 내용: 연결 방법(명령어/설정 파일), 범위(scope) 구분, 활용 예시, 관리 명령어, 보안 주의점.

방법 1: claude mcp add (가장 빠름)

claude mcp add github -- npx -y @modelcontextprotocol/server-github

형식은 `claude mcp add 이름 -- 실행명령` 입니다. 환경 변수(토큰 등)는 -e 옵션으로 전달합니다. 등록된 서버 목록은 `claude mcp list`, 제거는 `claude mcp remove 이름`으로 관리합니다.

방법 2: .mcp.json (팀 공유용, 권장)

프로젝트 루트에 .mcp.json을 만들어 커밋하면 팀 전체가 같은 서버 구성을 공유합니다. 형식은 Cursor의 mcp.json과 사실상 같습니다:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" }
    }
  }
}

토큰은 위처럼 환경 변수 참조로 넣어야 커밋해도 안전합니다. 범위 우선순위는 프로젝트 > 개인이며, 원격(HTTP) 서버도 URL 방식으로 등록할 수 있습니다.

Claude Code에서 MCP가 특히 빛나는 순간

이슈 → 구현 → PR 원스톱. GitHub 서버를 연결하면 "이슈 #42 읽고 구현한 다음 PR 만들어줘"가 한 번의 지시로 끝납니다. 에이전트가 작업 전체를 완주하는 Claude Code의 특성상, 도구가 연결될수록 위임 범위가 커집니다. DB 스키마 인지 작업. DB 서버를 붙이면 실제 스키마를 확인하며 마이그레이션·쿼리 코드를 작성합니다. Slack 보고. 긴 작업 완료 시 자동 알림 같은 워크플로도 가능합니다.

Cursor와 공유해서 쓰기

MCP는 표준이라 같은 서버를 Cursor와 Claude Code 양쪽에 등록해 쓸 수 있습니다. 저는 서버 정의를 한 번 만들어 두 도구의 설정에 복사해두고, 프로젝트에는 .mcp.json과 Cursor의 .cursor/mcp.json을 함께 커밋합니다. 서버 자체(프로세스)는 각 도구가 독립적으로 띄우므로 충돌 걱정은 없습니다.

보안: Cursor 때와 같은 원칙

토큰은 최소 권한으로, 출처 불명 서버는 설치 전 코드 확인, 시크릿은 환경 변수 참조로. 한 가지 더 — Claude Code는 에이전트가 도구를 자율적으로 쓰는 시간이 길므로, 파괴적 작업이 가능한 서버(DB 쓰기, 배포 등)는 읽기 전용 토큰으로 시작하는 것을 권합니다.

자주 묻는 질문 (FAQ)

Q. 서버를 추가했는데 인식이 안 돼요.

A. 세션을 재시작하고(`claude` 재실행), `claude mcp list`로 등록 상태를 확인하세요. 프로젝트 .mcp.json은 처음 사용 시 승인 확인을 요구할 수 있습니다.

Q. MCP 도구 사용도 사용량(한도)을 소모하나요?

A. 도구 호출 결과가 컨텍스트에 들어가므로 간접적으로 소모합니다. 대량 데이터를 반환하는 도구(큰 쿼리 결과 등)는 한도를 빠르게 먹으니 범위를 좁혀 쓰세요.

Q. 어떤 서버부터 붙이는 게 좋나요?

A. GitHub(또는 사용하는 저장소 서비스)가 체감이 가장 큽니다. 이슈-구현-PR 흐름이 달라집니다. 그다음은 프로젝트에서 매일 쓰는 서비스 순서입니다.

한눈에 보는 요약

개인은 `claude mcp add` 한 줄, 팀은 .mcp.json 커밋. 토큰은 환경 변수로, 파괴적 도구는 읽기 전용부터. Cursor와 서버를 공유할 수 있으니 이미 구축한 MCP 자산이 있다면 그대로 가져오면 됩니다.

함께 보면 좋은 글

Cursor에 MCP 서버 연결하는 방법 (개념 설명 포함)
Claude Code 완전 정리 (2026년 기준)
CLAUDE.md 작성법

참고 자료

Claude Code 공식 문서 - MCP
MCP 공식 사이트