Claude Code MCP 서버 추천: 무엇을 연결하고 어떻게 설정할까

Claude Code에 어떤 MCP 서버를 연결해야 할지 고민이라면, 정답은 특정 상품명이 아니라 "평소 다른 도구에서 복사해 채팅창에 붙여넣는 정보가 무엇인지" 살펴보는 것입니다. MCP(Model Context Protocol) — Claude 같은 AI가 외부 도구·데이터에 연결하는 공개 규약 를 쓰면 이슈 트래커, 모니터링 도구, 데이터베이스 등을 Claude Code가 직접 읽고 조작할 수 있습니다. 이 글에서는 공식 문서를 기준으로 무엇을 연결하면 좋은지, 실제로 어떻게 추가하는지, 자주 막히는 지점은 무엇인지 15~20분 안에 따라 할 수 있도록 정리했습니다.

시작 전 준비물

다음이 준비돼 있어야 이 글의 단계를 그대로 따라 할 수 있습니다.

• Claude Code CLI가 설치되어 있고 로그인된 상태
• 터미널(명령창)을 열고 명령어를 입력할 수 있는 환경
• 연결하려는 외부 서비스 계정(예: 이슈 트래커, 데이터베이스, 모니터링 도구 등)
• 일부 서비스는 연결 과정에서 브라우저 로그인(OAuth 인증)이 필요하므로 로그인 가능한 브라우저

용어 빠른 풀이

• MCP(Model Context Protocol) — AI가 외부 도구·데이터에 접근하도록 만든 공개 표준 연결 규약
• MCP 서버 — 이 규약을 따라 특정 도구(깃허브, 데이터베이스 등)와 Claude Code 사이를 이어주는 중개 프로그램
• 원격 서버(remote server) — 인터넷 너머 클라우드에서 실행되는 MCP 서버. 별도 설치 없이 주소만으로 연결
• 로컬 stdio 서버 — 내 컴퓨터에서 직접 실행되는 MCP 서버
• 전송 방식(transport) — Claude Code와 MCP 서버가 통신하는 방법(HTTP, SSE 등 여러 종류가 있음)
• 스코프(scope) — 추가한 MCP 서버 설정을 로컬/프로젝트/사용자 단위 중 어디에 저장할지 정하는 범위

어떤 카테고리의 MCP 서버부터 연결하면 좋을까요?

가장 효과가 큰 선택은 평소 반복적으로 다른 화면에서 정보를 복사해 Claude Code에 붙여넣는 작업을 그대로 대체하는 카테고리입니다. 공식 문서는 아래와 같은 활용 사례를 예로 듭니다.

이 중에서도 공식 문서는 클라우드 기반 서비스라면 원격 HTTP 서버 연결을 가장 폭넓게 지원되는 방식으로 권장합니다. 먼저 하나만 골라 연결해보고, 익숙해지면 다른 카테고리로 넓혀가는 방식을 추천합니다.

Claude Code에 MCP 서버를 추가하는 단계

1. 연결할 도구 하나를 정합니다. 위 카테고리 표를 참고해 가장 자주 쓰는 도구 하나를 먼저 고릅니다.

2. Anthropic Directory(공식 커넥터 목록)에서 검증된 서버를 찾습니다. Directory에 등록된 서버는 Claude Code와 동일한 MCP 인프라를 쓰므로 claude mcp add 명령으로 바로 추가할 수 있습니다. 주의: 연결하기 전에 반드시 해당 서버를 신뢰할 수 있는지 확인하세요. 외부 콘텐츠를 가져오는 서버는 프롬프트 인젝션 — 악성 콘텐츠에 숨겨진 지시문이 AI를 속여 의도치 않은 동작을 하게 만드는 공격 위험에 노출될 수 있습니다.

3. 터미널에서 추가 명령을 실행합니다. 원격 HTTP 서버는 공식 문서 기준으로 가장 폭넓게 지원되는 방식이며 기본 문법은 다음과 같습니다.

   claude mcp add --transport http <서버이름> <서버주소>

   SSE, 로컬 stdio, WebSocket 방식도 지원되지만 정확한 옵션 문법은 연결하려는 서버마다 다를 수 있으니, 해당 서버의 안내(공식 문서 또는 Directory 등록 정보)에 나온 정확한 명령을 그대로 사용하세요.

4. 필요하면 인증을 완료합니다. 다수의 원격 서버는 OAuth 인증 — 비밀번호 대신 권한만 위임하는 로그인 방식 절차가 필요합니다. 명령 실행 후 화면에 나오는 안내를 따라 인증을 마치세요. 성공하면 이후 대화에서 Claude Code가 해당 도구의 정보를 직접 읽고 조작할 수 있게 됩니다. 정확한 연결 확인 메뉴명은 실행 중인 Claude Code 화면에서 확인하세요.

자주 막히는 지점과 해결

예전에 봤던 @modelcontextprotocol/server-github, @modelcontextprotocol/server-postgres 같은 패키지 안내를 따라했는데 잘 안 됩니다. 이 패키지들은 현재 보관(deprecated) 상태로, 새로 연결할 때는 권장되지 않습니다. 대신 Anthropic Directory에서 현재 유지보수되는 원격 서버를 찾아 claude mcp add로 연결하는 방식을 사용하세요.

아무 MCP 서버나 연결해도 안전한가요? 아닙니다. 외부 콘텐츠를 가져오는 서버는 프롬프트 인젝션 위험이 있으므로, 연결 전 항상 서버 제공처와 신뢰도를 확인해야 합니다. 출처가 불분명한 서버는 연결하지 않는 것이 안전합니다.

실무 프로젝트에서는 권한을 어떻게 좁히나요? 두 가지 습관이 유효합니다. 첫째, 권한 최소화 — 데이터베이스 계열 서버(PostgreSQL 등)는 읽기 전용 계정으로 연결하고, 파일시스템 서버는 허용 디렉터리를 명시적으로 좁혀 두는 것이 안전합니다. 둘째, 프로젝트 스코프 분리 — 전역 설정 대신 프로젝트 단위 설정(.mcp.json)으로 각 프로젝트에 필요한 서버만 켜 두면, 프로젝트 간 권한 격리가 자연스럽게 이루어집니다.

인증이 계속 실패합니다. 브라우저 로그인 창이 제대로 뜨는지, 회사 네트워크나 방화벽이 인증 요청을 막고 있지 않은지 확인하세요. 공식 문서는 명령줄에서 인증하는 방법, 고정 포트를 쓰는 방법 등 여러 대안을 안내하고 있으니 상황에 맞는 방법을 문서에서 확인하세요.

응용: 나만의 MCP 서버 만들기

연결하려는 도구가 Directory에 없다면, Claude Code가 서버 제작을 도와주는 공식 플러그인을 쓸 수 있습니다.

1. 플러그인 설치: /plugin install mcp-server-dev@claude-plugins-official 실행. "Marketplace not found" 메시지가 뜨면 /plugin marketplace add anthropics/claude-plugins-official로 먼저 마켓플레이스를 추가하고, 그래도 플러그인을 못 찾으면 /plugin marketplace update claude-plugins-official로 갱신 후 다시 시도하세요.
2. 세션에 반영: 설치 후 /reload-plugins로 현재 세션에 활성화합니다.
3. 제작 시작: /mcp-server-dev:build-mcp-server를 실행하면 Claude가 용도를 물어보고 원격 HTTP 서버 또는 로컬 stdio 서버 뼈대를 만들어 줍니다.

자주 묻는 질문

Q. MCP 서버는 꼭 Directory에 있는 것만 써야 하나요?
아니요. Directory 등록 여부와 무관하게 연결은 가능하지만, 검증되지 않은 서버는 프롬프트 인젝션 위험이 있으므로 신뢰도를 직접 확인해야 합니다. 처음 시작한다면 Directory에 등록된 서버부터 쓰는 편이 안전합니다.

Q. @modelcontextprotocol/server-github 같은 예전 npm 패키지를 지금도 써도 되나요?
권장하지 않습니다. 해당 패키지들은 보관(deprecated) 상태이므로, Directory에서 현재 유지보수되는 원격 서버를 찾아 연결하는 방식을 쓰는 것이 좋습니다.

Q. 로컬 서버와 원격 서버 중 무엇을 골라야 하나요?
클라우드 기반 서비스를 연결할 때는 원격 HTTP 서버가 가장 폭넓게 지원되는 방식으로 공식 문서에서 권장됩니다. 내 컴퓨터에서만 접근 가능한 도구라면 로컬 stdio 서버가 필요할 수 있습니다.

Q. 여러 프로젝트에서 같은 MCP 서버를 반복해서 추가해야 하나요?
아닙니다. 로컬/프로젝트/사용자 단위의 스코프 설정으로 적용 범위를 나눌 수 있습니다. 정확한 설정 방법은 사용 중인 Claude Code 문서의 스코프 안내를 확인하세요.

다른 커넥터도 찾고 있다면 커넥터 디렉토리에서 자주 쓰는 커넥터를 용도별로 검색·필터해볼 수 있습니다.

관련 글

• Claude Code MCP 커넥터 추천 — 깃허브·센트리부터 데이터베이스까지 연결하는 법
• Claude Code 설정 파일(settings.json) 완전 정리 — 권한·환경변수·도구 설정
• PostgreSQL MCP 서버 — 클로드에 데이터베이스 연결하기 (2026)
• MCP 서버 직접 만들기 — 파이썬으로 첫 서버부터 Claude 연결까지 (2026)
• Playwright MCP 서버 설정 — 클로드로 브라우저 자동화 (2026)
• Claude Code MCP 설정: claude mcp add·스코프·전송 방식 완전 정리

이미지·영상 생성을 Claude에서 다루고 싶다면 ComfyUI를 Claude로 쓰는 법(Comfy MCP)도 함께 보세요. 설치 없이 클라우드로 붙이는 방법과 비용 조건을 정리했습니다.