MCP로 외부 도구 연결하기

Claude Code는 기본적으로 파일과 셸을 다룹니다. 하지만 실무에서는 데이터베이스, 이슈 트래커, 디자인 도구 같은 외부 시스템과 함께 일하게 됩니다. 이를 연결해 주는 표준이 **MCP(Model Context Protocol)**입니다.

학습 목표

• MCP가 무엇이고 왜 필요한지 이해한다.
• MCP 서버를 연결하는 흐름을 안다.
• 어떤 작업에서 유용한지 감을 잡는다.

MCP란

MCP는 AI 도구와 외부 시스템을 잇는 공통 규약입니다. 각 외부 시스템은 "MCP 서버"로 자신의 기능(도구·데이터)을 노출하고, Claude Code는 클라이언트로서 그 기능을 호출합니다.

Claude Code ──(MCP)── DB 서버
            ──(MCP)── 이슈 트래커 서버
            ──(MCP)── 문서 서버

이 표준 덕분에 시스템마다 따로 통합 코드를 만들지 않아도 됩니다.

무엇을 할 수 있나

• 데이터베이스 스키마를 읽고 쿼리 작성을 돕기
• 이슈·티켓을 조회해 작업 맥락 파악
• 디자인 파일에서 스펙을 가져와 UI 구현
• 사내 문서나 위키 검색

연결 흐름

MCP 서버는 설정으로 등록합니다. 명령으로 추가하는 방식이 일반적이며, 연결 방식(transport)에 따라 형식이 조금 다릅니다.

# 로컬 프로세스(stdio) 서버
claude mcp add --transport stdio <이름> -- <서버 실행 명령>

# 원격(HTTP) 서버
claude mcp add --transport http <이름> <URL>

등록하면 해당 서버가 제공하는 도구를 Claude Code가 작업 중에 사용할 수 있게 됩니다. 어떤 서버가 연결돼 있는지는 목록 명령으로 확인합니다.

claude mcp list

보안 유의점

MCP 서버는 외부 시스템에 접근하는 통로이므로, 신뢰할 수 있는 서버만 연결해야 합니다. 자격 증명(토큰·키)은 환경 변수나 안전한 설정으로 관리하고, 불필요한 권한은 부여하지 않습니다.

요약

MCP는 Claude Code와 외부 시스템을 잇는 표준 규약입니다. DB·이슈 트래커·문서 같은 시스템을 MCP 서버로 연결하면 파일·셸을 넘어선 작업이 가능해지며, 연결 대상은 신뢰할 수 있는 것으로 한정해야 합니다.