꾸비데브

MCP 연결 방법 2026 — 클로드 코드에 외부 도구 붙이는 법

AI에게 내 문서를 봐달라고 했는데 못 본다는 답을 받았다면, 외부 도구를 연결하는 표준인 MCP의 구조와 연결 방법을 정리했습니다.

AI에게 "내 문서를 봐줘"라고 했는데 못 본다는 답을 받아본 적 있다면 이 글을 읽어야 합니다. 그 벽을 넘는 표준이 MCP(Model Context Protocol)입니다. 무엇이고 어떻게 붙이는지 공식 문서 기준으로 정리했습니다.

01

MCP란 무엇인가

MCP는 AI 애플리케이션을 외부 도구·데이터에 연결하는 오픈소스 표준입니다. 공식 문서는 이것을 "AI 애플리케이션의 USB-C 포트"에 비유합니다. 기기마다 다른 케이블을 쓰지 않아도 되듯, 도구마다 다른 연결 방식을 새로 배우지 않아도 된다는 뜻입니다.

AI는 대화창에 붙여 넣은 것만 압니다. MCP 서버 하나를 연결해 두면 그 뒤로는 AI가 그 도구를 직접 쓸 수 있습니다.

MCP 구조 세 덩어리

02

구조는 세 덩어리

공식 문서에 따르면 MCP는 클라이언트-서버 구조를 따르고, AI 앱(호스트)이 서버마다 클라이언트를 하나씩 만들어 연결합니다.

호스트는 클로드 코드나 클로드 데스크톱 앱처럼 사용자가 쓰는 AI 앱입니다. 클라이언트는 호스트가 서버마다 하나씩 만드는 연결 창구로, 직접 만질 일은 없습니다. 서버는 실제로 도구와 데이터를 제공하는 쪽이며, 사용자가 "붙인다"고 말하는 대상이 바로 이것입니다.

서버는 실행 가능한 기능인 도구, 맥락이 되는 자료, 미리 만들어 둔 프롬프트, 이렇게 세 가지를 제공합니다.

로컬 서버와 원격 서버

03

붙이는 방법

연결 방식은 로컬 서버와 원격 서버 두 갈래입니다. 로컬 서버는 컴퓨터에서 프로그램으로 돌아가고 보통 클라이언트 하나만 상대합니다. 원격 서버는 인터넷 너머에 있고 여러 클라이언트를 동시에 상대할 수 있습니다. 공식 문서는 원격 연결에 HTTP 방식을 권장하며, 예전에 쓰이던 SSE 방식은 더 이상 권장되지 않는다고 명시합니다.

클로드 코드 기준으로 원격 서버는 claude mcp add --transport http (이름) (주소), 로컬 서버는 claude mcp add (이름) -- (실행 명령)으로 붙입니다. 로그인이 필요하면 대화 안에서 /mcp를 실행하면 브라우저 로그인 창으로 이어집니다. 목록 확인은 claude mcp list, 삭제는 claude mcp remove (이름)입니다.

같은 서버도 범위를 나눌 수 있습니다. 기본값은 나만 쓰는 로컬 범위이고, 팀과 공유하려면 프로젝트 범위, 모든 프로젝트에서 쓰려면 사용자 범위로 지정합니다. 프로젝트 범위로 공유된 서버는 안전장치가 하나 더 있는데, 대화형 세션에서 그 서버를 처음 쓸 때 승인을 한 번 묻습니다.

클로드 앱(claude.ai)에서는 이름이 다릅니다. 여기서는 이것을 커넥터(Connectors)라고 부르고, 사이드바의 설정 메뉴에서 서비스별로 연결 버튼을 누르면 됩니다. 공식 문서는 커넥터를 MCP로 구동된다고 설명합니다. 즉 명칭만 다를 뿐 뒤에서 움직이는 표준은 같습니다.

04

연결 전에 확인할 점

공식 문서의 경고는 분명합니다. 연결하기 전에 각 서버를 신뢰할 수 있는지 확인하라고 안내하며, 외부 콘텐츠를 가져오는 서버는 프롬프트 인젝션 위험에 노출될 수 있다고 밝힙니다. 프롬프트 인젝션은 외부에서 읽어 온 글 안에 지시가 숨어 있고, AI가 그것을 사용자 지시로 착각하는 문제입니다.

Anthropic은 디렉터리에 올리기 전 등재 기준으로 검토하지만, 공식 문서에는 어떤 MCP 서버도 보안 감사하거나 관리하지 않는다고 적혀 있습니다. 목록에 있다는 것이 안전을 보장하지는 않습니다.

05

운영자 한마디

MCP는 연결하면 끝이라고 오해하기 쉽지만, 실제로는 서버를 고르는 기준이 붙이는 방법보다 중요합니다. 공식 문서가 신뢰할 수 있는 서버인지부터 확인하라고 경고하는 이유도 여기 있습니다. 특히 외부 콘텐츠를 읽어 오는 서버는 프롬프트 인젝션 경로가 될 수 있다는 점을 가볍게 넘기지 않아야 합니다. 처음 MCP를 접하면 유명한 서버부터 여러 개를 한꺼번에 붙이고 싶어지는데, 안 쓰는 서버는 그 자체로 관리 대상이 늘어나는 것과 같습니다. 필요한 것만 골라 붙이고, 붙인 뒤에도 그 서버가 무엇을 할 수 있는지 다시 한번 확인하는 편이 안전합니다.

06

자주 묻는 질문

MCP를 붙이면 토큰이 절약되나요?

아닙니다. 오히려 관리 대상입니다. 다만 도구 정의는 기본적으로 지연 로딩이라, 실제로 그 도구를 쓸 때까지는 이름 정도만 컨텍스트에 올라갑니다.

모든 서버에 로그인이 필요한가요?

아닙니다. 공식 사양에서 인증은 선택 사항이고 HTTP 방식에서 권장됩니다. 로컬 서버는 환경 변수로 자격 증명을 받는 것이 원칙입니다.

MCP는 특정 회사 전용인가요?

아닙니다. 공식 정의부터 오픈소스 표준입니다. 서버는 누구나 만들 수 있고, 그래서 신뢰 확인이 사용자 몫으로 남습니다.

07

정리

MCP는 AI에 외부 도구를 붙이는 표준 규격입니다. 붙이는 방법보다 중요한 것은 어떤 서버를 신뢰하고 붙일지 고르는 기준입니다. 정확한 명령어와 최신 옵션은 공식 문서에서 확인하는 것이 가장 안전합니다.

08

참고 자료

← BLOG 전체 보기무료자료 보기 →