클로드 코드 MCP 서버 연결 방법: 외부 도구를 붙이는 기본

클로드 코드는 기본적으로 내 프로젝트 파일과 터미널 명령을 다룹니다. 그런데 작업하다 보면 그 밖의 것이 필요해집니다. "DB에서 실제 데이터를 조회해서 확인해 줘", "이슈 트래커에서 이 티켓 내용 읽어 줘", "브라우저로 페이지 열어서 확인해 줘". 이럴 때 쓰는 것이 MCP입니다.

MCP란?

MCP(Model Context Protocol)는 AI가 외부 도구와 데이터에 접근하는 방식을 표준화한 프로토콜입니다. USB 포트에 비유하면 이해가 쉽습니다. 장치마다 전용 케이블이 필요하던 시절에서, USB 하나로 키보드·마우스·저장장치를 연결하게 된 것처럼, MCP 하나로 다양한 도구를 같은 방식으로 연결합니다.

MCP 서버 추가하기

클로드 코드에서는 claude mcp add 명령으로 서버를 추가합니다. 연결 방식은 크게 두 가지입니다.

1. 원격(HTTP) 서버

서비스 회사가 제공하는 원격 MCP 서버를 연결할 때입니다.

claude mcp add --transport http 서버이름 https://example.com/mcp

2. 로컬(stdio) 서버

내 컴퓨터에서 프로그램으로 실행되는 서버입니다. -- 뒤에 실행 명령을 적습니다.

claude mcp add 서버이름 -- npx -y 패키지이름

환경 변수(API 키 등)가 필요하면 --env 옵션으로 전달할 수 있습니다.

추가한 서버 확인

claude mcp list

클로드 코드 세션 안에서는 /mcp 명령으로 연결 상태를 확인하고, 인증이 필요한 서버는 여기서 로그인합니다.

적용 범위(scope) 이해하기

MCP 서버를 어디에 등록하느냐에 따라 쓸 수 있는 범위가 다릅니다.

claude mcp add --scope project 서버이름 -- 실행명령

project 범위로 추가하면 .mcp.json 파일이 생기고, 팀원이 같은 저장소를 받으면 같은 MCP 서버를 쓸 수 있습니다. 이때 API 키 같은 비밀값은 파일에 직접 쓰지 말고 환경 변수로 참조하게 해야 합니다.

실무에서 유용했던 MCP 활용

• 브라우저 자동화 서버: 웹페이지를 열어 렌더링 결과를 확인하게 하고, 수정 후 다시 확인하는 반복을 맡겼습니다.
• 데이터베이스 서버: "이 쿼리 결과가 예상과 맞는지 실제 데이터로 확인해 줘" 같은 검증에 유용했습니다. 단, 읽기 전용 계정으로만 연결합니다.
• 문서·이슈 트래커 서버: 티켓 내용을 읽고 그에 맞춰 작업하게 하면 복사·붙여넣기가 줄어듭니다.

보안 주의점

MCP는 강력한 만큼 주의가 필요합니다.

1. 신뢰할 수 있는 서버만 설치하세요. 로컬 MCP 서버는 내 컴퓨터에서 코드를 실행합니다.
2. 최소 권한으로 연결하세요. DB는 읽기 전용, API 토큰은 필요한 범위만.
3. 외부 콘텐츠를 가져오는 서버는 조심하세요. 웹페이지나 문서 내용에 AI를 속이려는 지시문(프롬프트 인젝션)이 숨어 있을 수 있습니다.
4. 쓰지 않는 서버는 제거하세요. claude mcp remove 서버이름으로 지울 수 있습니다.

많이 연결할수록 좋은 건 아니었습니다

MCP를 처음 알았을 때는 이것저것 다 연결했는데, 오히려 클로드가 엉뚱한 도구를 쓰려 하거나 컨텍스트가 무거워졌습니다. 지금은 프로젝트마다 꼭 필요한 서버 두세 개만 연결합니다. 그리고 DB나 사내 시스템을 연결할 때는 반드시 읽기 전용 권한부터 시작하세요. 편리함보다 안전이 먼저입니다.

마무리

1. MCP는 클로드 코드에 외부 도구·데이터를 연결하는 개방형 표준입니다.
2. claude mcp add로 원격(HTTP) 또는 로컬(stdio) 서버를 추가하고, /mcp로 상태를 확인합니다.
3. 범위(local·project·user)를 구분하고, 신뢰할 수 있는 서버를 최소 권한으로만 연결하세요.

더 알아보기

• Claude Code MCP 문서 (공식)
• Model Context Protocol 공식 사이트