Claude 가이드 #21: MCP 커넥터 — Claude를 외부 도구에 직접 연결하기

MCP(Model Context Protocol, 모델 문맥 규약)는 AI와 외부 서비스를 연결하는 공용 콘센트라고 생각하시면 됩니다. 우리집 전기 콘센트 규격이 통일되어 있어서 어떤 전자제품이든 꽂으면 작동하는 것처럼, MCP도 “AI가 외부 도구와 대화하는 방식"을 표준으로 정해둔 약속입니다.

그리고 이 글의 주인공인 MCP 커넥터는, 그 표준 콘센트에 Claude를 한 줄 코드로 꽂아주는 기능입니다.

지금까지 Claude를 캘린더나 노션 같은 외부 서비스에 연결하려면, 둘 사이를 통역해주는 “중간 프로그램(클라이언트)“을 따로 만들어야 했습니다. MCP 커넥터를 쓰면 그 중간 단계가 사라집니다. Claude API 요청 안에 “이 서버에 연결해줘"라고 한 줄 적어주면 끝입니다.

핵심 수치 하나: 한 번의 요청에 여러 개의 외부 서버를 동시에 연결할 수 있습니다. 캘린더와 노션을 같이 보면서 “이번 주 회의 내용을 노션에 정리해줘"라고 부탁하는 게 가능해진다는 뜻입니다.

3. 이런 상황에서 써요
#

상황 1: 학생 — 강의 노트와 일정을 함께 보기
#

기말고사 기간, 시험 일정은 구글 캘린더에, 강의 정리는 노션에 따로 적어두셨다고 해볼게요. “다음 주 화요일 시험 범위에 해당하는 노션 페이지 다 찾아줘"라고 부탁하고 싶은 순간이 있죠. 일정 앱과 정리 앱을 번갈아 보며 머릿속에서 짜맞추는 대신, Claude가 양쪽을 동시에 들여다보고 답해줍니다.

상황 2: 직장인 — 사내 매뉴얼 챗봇
#

회사에서 “휴가 규정이 어떻게 되더라?”, “출장비 처리 방식이 뭐였지?” 같은 질문이 매일 반복된다고 해볼게요. 회사 매뉴얼이 사내 시스템에 MCP 서버로 올라와 있다면, Claude에게 그 서버를 연결해두고 직원들이 자연어로 물어볼 수 있게 됩니다. “지난주에 들어온 신규 직원 휴가는 며칠이지?” 같은 질문이 한 번에 해결됩니다.

상황 3: 일반인 — 가계부와 일정 한 번에 보기
#

가계부 앱과 캘린더를 따로 쓰시는 분이 많으시죠. 가계부에 MCP 서버가 있다면, “이번 달 외식비가 얼마였고, 외식한 날 캘린더에 적힌 약속은 누구랑이었는지” 같은 질문을 던질 수 있습니다. 두 서비스를 일일이 열어보며 비교하지 않아도, Claude가 양쪽을 한 번에 훑고 정리해줍니다.

4. 가볍게 시작하기
#

💻 개발 경험이 있으신가요? 아래 코드는 Python 기준 가장 짧은 예시입니다. 비개발자라면 “아, 이렇게 한 줄로 외부 서버를 붙이는구나” 정도로 보고 넘어가셔도 충분합니다.

import anthropic

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=1000,
    messages=[{
        "role": "user",
        "content": "내가 등록한 도구 목록을 보여줘"
    }],
    # 연결할 외부 MCP 서버 정보 (주소와 인증 토큰)
    mcp_servers=[{
        "type": "url",
        "url": "https://example-server.modelcontextprotocol.io/sse",
        "name": "example-mcp",
        "authorization_token": "내_토큰_값"
    }],
    # 이 서버의 도구를 모두 사용하겠다는 한 줄
    tools=[{"type": "mcp_toolset", "mcp_server_name": "example-mcp"}],
    betas=["mcp-client-2025-11-20"]
)
print(response)

핵심은 두 군데입니다. mcp_servers에서 “어디에 연결할지"를 적고, tools에서 “그 서버의 도구를 쓰겠다"고 선언합니다. 이 둘이 name(여기서는 example-mcp)으로 짝지어집니다. authorization_token은 외부 서비스에 로그인하기 위한 열쇠라고 보시면 됩니다 — 미리 한 번 발급받아서 넣어두면 됩니다.

5. 흔한 오해와 함정
#

⚠️ 함정 1: “내 컴퓨터에 설치한 도구도 그냥 연결되겠지?”
#

아쉽게도 그렇지 않습니다. MCP 커넥터는 인터넷에 공개된 주소(https://로 시작하는) 서버에만 연결할 수 있습니다. 내 컴퓨터에서만 돌아가는 로컬 도구(STDIO 방식)는 직접 붙일 수 없어요. 회사 내부망에 있는 서버라면 외부에서 접근 가능한 주소를 따로 마련해야 합니다.

⚠️ 함정 2: “도구 하나만 쓰고 싶은데 다 켜져서 시끄러워요”
#

서버를 연결하면 기본적으로 그 서버의 모든 도구가 켜집니다. 캘린더 서버에 “일정 만들기, 일정 지우기, 캘린더 공유” 같은 도구가 다 들어 있다면 위험하기도 하죠. 이럴 땐 default_config에서 enabled: false를 기본값으로 두고, configs에서 쓰고 싶은 도구만 콕 집어 켜두시면 됩니다(허용 목록 방식). 반대로 “지우기"처럼 위험한 것만 꺼둘 수도 있습니다(차단 목록 방식).

⚠️ 함정 3: “예전 코드 그대로 썼는데 안 돼요”
#

2025년 11월 20일에 베타 버전이 새로 나오면서 설정 방식이 바뀌었습니다. 예전 방식(mcp-client-2025-04-04)은 곧 사라지니, 새 헤더(mcp-client-2025-11-20)와 새 구조로 옮겨야 합니다. 핵심은 “도구 설정"이 mcp_servers 안이 아니라 tools 배열로 자리를 옮겼다는 점입니다.

6. 한 단계 더 (관심 있는 분만)
#

🎯 여기까지 오신 분 환영합니다. 본문만 읽으셔도 충분하지만, 도구를 더 세밀하게 다루고 싶은 분을 위한 보너스입니다.

도구가 많은 서버를 통째로 연결하면, Claude가 매번 “이 도구는 뭐고 저 도구는 뭐고…” 설명을 다 읽느라 답이 느려질 수 있습니다. 이럴 때 허용 목록 + 미리 읽지 않기(defer_loading) 조합이 유용합니다.

tools = [{
    "type": "mcp_toolset",
    "mcp_server_name": "google-calendar-mcp",
    # 기본은 다 끄고, 처음엔 설명도 안 읽기
    "default_config": {"enabled": False, "defer_loading": True},
    "configs": {
        # 검색 도구만 켜고, 설명도 미리 읽어두기
        "search_events": {"enabled": True, "defer_loading": False},
        # 일정 보기도 켜되, 필요할 때만 설명 읽기
        "list_events": {"enabled": True}
    }
}]

search_events처럼 자주 쓰는 도구는 Claude가 미리 알고 있다가 바로 쓰고, list_events처럼 가끔 쓰는 도구는 “필요할 때 찾아서” 쓰는 방식입니다. 도구가 수십 개로 늘어나도 Claude가 헤매지 않게 도와줍니다.

사용 패턴	추천 설정	어울리는 상황
다 켜기	설정 안 함	도구가 5개 미만, 간단한 챗봇
허용 목록	`enabled: false` + 골라서 켜기	위험한 도구가 섞여 있을 때
차단 목록	다 켜고 일부만 끄기	“삭제” 같은 도구만 막고 싶을 때

7. 한 마디
#

MCP 커넥터는 “AI가 우리가 쓰는 도구들과 친해지는 첫 단추"입니다. 처음 들으면 어려워 보이지만, 결국은 주소 한 줄과 도구 목록 한 줄만 알면 됩니다. 막히는 부분이 있다면 보통 함정 1~3 중 하나 — 로컬 서버를 붙이려 했거나, 도구가 너무 많이 켜졌거나, 예전 버전 헤더를 쓰셨거나 — 입니다.

다음 글에서는 #22 MCP Tunnels — 내 컴퓨터의 서버도 Claude에게 연결하는 법을 함께 살펴보겠습니다. 오늘 못 풀었던 “내 컴퓨터의 도구도 연결되나요?“라는 함정을 풀어드릴게요.

Claude API 공식 문서를 한국어로 풀어쓴 시리즈입니다. 원문 정확성이 가장 우선, 의역과 친근함은 그 위에서.