← 목록으로

MCP 연결 실전

외부 도구를 MCP로 연결하는 실전 예제 여섯 가지. 연결 경로와 복사용 주소까지 이 페이지에서 바로 따라 합니다

에이전트의 도구 MCP 연결 실전

먼저, MCP가 뭔가요

3분개념

MCP(Model Context Protocol)는 AI 앱이 외부 도구에 접속하는 공용 규격입니다. 노트북에 USB-C 단자 하나만 있으면 충전기도 모니터도 꽂히듯, AI 앱은 MCP 하나로 여러 도구를 붙입니다.

MCP
AI에 끼우는 USB-C
Model Context Protocol
2024년 11월 Anthropic이 공개한 개방형 연결 규격. AI 앱과 외부 도구를 한 가지 방식으로 잇습니다.
AI 앱Claude · ChatGPT
꽂으면 바로 연결
MCP
하나의 공용 규격
Google
카카오톡
DART 공시
한국 법령
텔레그램
Higgsfield
예제 여섯 개모두 MCP
어느 앱으로 따라 할까요
구글 지메일, 캘린더, 드라이브 연결하기
10분입문
▼

Gmail, Google Calendar, Google Drive 세 커넥터를 Claude에 붙여, 받은편지함의 메일, 캘린더의 일정, 드라이브의 문서·스프레드시트·PDF를 Claude가 직접 찾아 읽습니다.

  • ① 사용자 지정 열기
    Claude Desktop을 열고 왼쪽 사이드바에서 사용자 지정(Customize)을 누릅니다.
  • ② 커넥터 탭에서 탐색 누르기
    위쪽 탭에서 커넥터를 고르고, 옆의 탐색을 누릅니다. 아래 인기 커넥터에 Google Drive, Gmail, Google Calendar가 보입니다. 안 보이면 오른쪽 검색창에 이름을 입력합니다.
    ② 커넥터 → 탐색을 고르고, ③ 세 카드의 +를 누릅니다
  • ④ Google 계정 로그인과 권한 동의
    열린 창에서 Google 계정으로 로그인하고 접근 권한에 동의합니다. 세 커넥터 모두 같은 계정으로 로그인합니다. 회사 구글 계정이면 관리자가 커넥터를 열어두어야 이 화면이 끝까지 넘어갑니다.
  • ⑤ 연결 확인
    오늘 내 구글 캘린더 일정을 알려주고, 일정마다 관련된 최근 Gmail 메일과 구글 드라이브 문서를 찾아 한 줄씩 정리해줘. 새 대화에서 위 질문을 그대로 보냅니다. 일정, 메일, 문서가 함께 나오면 세 커넥터가 모두 연결된 것입니다.
  • ① 왼쪽 네 번째 버튼 누르기
    Codex 앱 왼쪽 세로 버튼 줄의 네 번째 버튼을 누르면 맞춤 설정이 열립니다.
    ① 왼쪽 네 번째 버튼을 누르고 ② 플러그인을 고릅니다. 설치한 플러그인은 설치됨 아래에 보입니다
  • ② 플러그인 고르기
    맞춤 설정 맨 위의 플러그인을 누릅니다. 플러그인 화면이 열립니다.
  • ③ Gmail, Google Drive, Google Calendar 추가
    인기 목록의 Gmail과 Google Drive 오른쪽 +를 누릅니다. Google Calendar는 플러그인 검색에 입력해 찾아 같은 방법으로 추가합니다.
    ③ Gmail과 Google Drive의 +를 누르고, Google Calendar는 검색창에 입력해 찾습니다
  • ④ Google 계정 로그인과 권한 동의
    열린 창에서 Google 계정으로 로그인하고 접근 권한에 동의합니다. 세 플러그인 모두 같은 계정으로 로그인합니다.
  • ⑤ 연결 확인
    오늘 내 구글 캘린더 일정을 알려주고, 일정마다 관련된 최근 Gmail 메일과 구글 드라이브 문서를 찾아 한 줄씩 정리해줘. Codex 앱에서 새 스레드를 열고 위 질문을 보냅니다. 일정, 메일, 문서가 함께 나오면 세 플러그인이 모두 연결된 것입니다.
카카오톡 PlayMCP 연결하기
12분중급
▼

먼저 playmcp.kakao.com에서 회원가입하고 도구함에 쓸 도구를 담은 다음, Claude Desktop에 PlayMCP 커넥터를 붙입니다.

  • ① PlayMCP에 카카오 계정으로 로그인
    playmcp.kakao.com에 접속해 카카오 계정으로 로그인합니다. 카카오톡을 쓰는 계정이면 회원가입 없이 바로 들어갑니다.
  • ② 도구함에 쓸 도구 담기
    로그인하면 도구함이 보입니다. 여기에 쓸 도구를 먼저 담아 둡니다. 아래 카카오톡 나챗방은 반드시 담습니다.
  • ③ 사용자 지정 열기
    Claude Desktop을 열고 왼쪽 사이드바에서 사용자 지정(Customize)을 누릅니다.
  • ④ 커넥터에서 playmcp 검색해 추가
    위쪽 탭에서 커넥터를 고르고, 오른쪽 검색창에 playmcp를 입력합니다. 나온 PlayMCP 카드의 +를 누르고 연결을 누릅니다.
    ④ 커넥터를 고르고 검색창에 playmcp를 입력한 뒤, 카드의 +를 누릅니다
  • ⑤ 카카오 계정 로그인과 권한 동의
    연결 창에서 카카오 계정으로 로그인하고 권한에 모두 동의합니다. 이러면 준비가 끝납니다.
  • ⑥ 연결 확인
    카톡으로 "MCP 연결 완료"라고 보내줘. 새 대화에서 위 메시지를 보냅니다. 카카오톡 나와의 채팅방에 그대로 도착하면 연결된 것입니다.
기업 공시 데이터 분석
12분중급
▼

GitHub에서 DART 공시 분석 스킬을 내려받아 Claude Code에 설치하면, /dart 종목명 한 줄로 그 기업의 재무와 공시를 분석한 HTML 리포트를 받습니다. 13인 투자자 페르소나 평가까지 담깁니다.

dart 스킬 · github.com/airoasting/dart ›
이 예제는 터미널에서 claude로 켠 Claude Code 안에서 진행합니다. 설치는 자연어로 부탁하면 Claude가 알아서 받아 설치합니다.
  • ① DART 스킬 설치
    https://github.com/airoasting/dart 다운로드 받은 다음, 클로드 스킬로 설치해주세요. Claude Code에 위 문장을 그대로 입력합니다. GitHub 주소를 받아 Claude가 알아서 내려받고 설치합니다.
  • ② OpenDART API 키 받아 Claude에 알려주기
    opendart.fss.or.kr에 접속해 인증키 신청/관리 메뉴에서 인증키 신청을 눌러 신청합니다. 발급되면 오픈API 이용현황을 눌러 40자 키 값을 복사합니다.
    1 인증키 신청으로 신청하고, 2 오픈API 이용현황에서 키 값을 복사합니다
    이건 opendart API 값이야. 복사한_키_붙여넣기 Claude Code 채팅 창에 위 문장을 넣고, 복사한_키_붙여넣기 자리에 방금 복사한 키 값을 붙여 보냅니다. Claude가 키를 받아 프로젝트 .env에 저장합니다.
  • ③ 리포트 생성
    /dart 카카오 Claude Code에서 /dart 종목명을 실행하면 output/ 폴더에 HTML 리포트가 만들어집니다.

GitHub에서 DART 공시 분석 스킬을 내려받아 Codex에 설치하면, $dart 종목명 한 줄로 그 기업의 재무와 공시를 분석한 HTML 리포트를 받습니다. 13인 투자자 페르소나 평가까지 담깁니다.

dart 스킬 · github.com/airoasting/dart ›
이 예제는 Codex 앱에서 진행합니다. 설치는 자연어로 부탁하면 Codex가 알아서 받아 설치합니다.
  • ① DART 스킬 설치
    https://github.com/airoasting/dart 다운로드 받은 다음, Codex 스킬로 설치해주세요. Codex 앱 새 스레드에 위 문장을 그대로 입력합니다. GitHub 주소를 받아 Codex가 알아서 내려받고 설치합니다. 승인 요청이 뜨면 허용합니다.
  • ② OpenDART API 키 받아 Codex에 알려주기
    opendart.fss.or.kr에 접속해 인증키 신청/관리 메뉴에서 인증키 신청을 눌러 신청합니다. 발급되면 오픈API 이용현황을 눌러 40자 키 값을 복사합니다.
    1 인증키 신청으로 신청하고, 2 오픈API 이용현황에서 키 값을 복사합니다
    이건 opendart API 값이야. 복사한_키_붙여넣기 Codex 채팅 창에 위 문장을 넣고, 복사한_키_붙여넣기 자리에 방금 복사한 키 값을 붙여 보냅니다. Codex가 키를 받아 프로젝트 .env에 저장합니다.
  • ③ 리포트 생성
    $dart 카카오 Codex에서 $dart 종목명을 입력하면 output/ 폴더에 HTML 리포트가 만들어집니다.
한국 법령 MCP 연결하기
15분중급
▼

korean-law 스킬과 MCP 서버를 내 컴퓨터에 설치해, AI가 쓴 계약서 검토 메모나 의견서의 조문·판례 인용을 법제처 원문과 대조합니다. 인용마다 실제로 있는지, 지금도 시행 중인지, 제목과 선고일이 맞는지 확인해 법률 근거 검증표와 통과·반려 판정을 냅니다. 법령과 판례를 찾아 읽는 도구도 함께 들어 있습니다.

korean-law 스킬·MCP · github.com/airoasting/korean-law ›
내 컴퓨터에 Node.js 20.19 이상과 Python 3.9 이상이 있어야 합니다.
  • ① 법제처 OC 키 발급
    open.law.go.kr에 접속해 회원가입한 뒤 활용 신청을 하고, 마이페이지에서 OC 키를 확인합니다. OC 키는 사용자가 직접 입력한 값입니다. open.law.go.kr → OPEN API → 활용 신청 → 마이페이지
  • ② Claude Desktop의 Code 탭 열기
    Claude Desktop → Code 탭 → 작업 폴더 선택
  • ③ 설치 부탁하기
    https://github.com/airoasting/korean-law 를 설치해줘. 위 문장을 그대로 보냅니다. Claude가 저장소를 받고, 서버를 빌드하고, claude mcp add로 등록합니다. 명령 실행 허락을 물으면 허용합니다. 이건 법제처 OC 값이야. 복사한_키_붙여넣기 이어서 위 문장의 복사한_키_붙여넣기 자리에 ①에서 확인한 OC 키를 넣어 보냅니다. Claude가 키를 mcp/.env에 저장합니다.
  • ④ 새 세션에서 연결 확인
    korean-law MCP 도구 목록을 보여줘. 등록한 서버는 새 세션부터 붙습니다. Code 탭에서 새 세션을 열고 위 질문을 보냅니다. find_law, read_law, find_decision, read_decision, check_precedent 같은 도구가 나오면 연결된 것입니다.
  • ⑤ 첫 검증 테스트
    korean-law 스킬로 아래 두 문장의 법률 인용을 검증해줘. 1. 근로기준법 제60조(연차 유급휴가)에 따라 1년간 80퍼센트 이상 출근한 근로자에게 15일의 유급휴가를 주어야 한다. 2. 민사소송법 제272조(준비서면)에 따라 준비서면을 제출한다. 2번 인용이 조문 제목 불일치로 걸려 판정이 FAIL(반려)로 나오면 제대로 작동하는 것입니다. 민사소송법 제272조의 실제 제목은 '변론의 집중과 준비'입니다.
  • ① 법제처 OC 키 발급
    open.law.go.kr에 접속해 회원가입한 뒤 활용 신청을 하고, 마이페이지에서 OC 키를 확인합니다. OC 키는 사용자가 직접 입력한 값입니다. open.law.go.kr → OPEN API → 활용 신청 → 마이페이지
  • ② Codex 앱에서 새 스레드 열기
    Codex 앱 → 작업 폴더 선택 → 새 스레드 Codex 데스크탑 앱을 열고 아무 작업 폴더나 고른 뒤 새 스레드를 엽니다.
  • ③ 설치 부탁하기
    https://github.com/airoasting/korean-law 를 설치해줘. 위 문장을 그대로 보냅니다. Codex가 저장소를 받고, 서버를 빌드하고, ~/.codex/config.toml에 서버를 등록합니다. 승인 요청이 뜨면 허용합니다. 이건 법제처 OC 값이야. 복사한_키_붙여넣기 이어서 위 문장의 복사한_키_붙여넣기 자리에 ①에서 확인한 OC 키를 넣어 보냅니다. Codex가 키를 mcp/.env에 저장합니다. Codex 앱은 Codex CLI와 같은 설정 파일을 읽습니다. 그래서 여기서 등록한 서버가 앱에도 그대로 적용됩니다.
  • ④ 앱을 다시 열고 연결 확인
    설정(Settings) → MCP servers → korean_law 켜짐 확인 Codex 앱을 완전히 종료했다가 다시 엽니다. 설정의 MCP servers 목록에 korean_law가 켜져 있으면 연결된 것입니다.
  • ⑤ 첫 검증 테스트
    korean-law 스킬로 아래 두 문장의 법률 인용을 검증해줘. 1. 근로기준법 제60조(연차 유급휴가)에 따라 1년간 80퍼센트 이상 출근한 근로자에게 15일의 유급휴가를 주어야 한다. 2. 민사소송법 제272조(준비서면)에 따라 준비서면을 제출한다. 새 스레드에서 위 문장을 보냅니다. 2번 인용이 조문 제목 불일치로 걸려 판정이 FAIL(반려)로 나오면 제대로 작동하는 것입니다. 민사소송법 제272조의 실제 제목은 '변론의 집중과 준비'입니다.
Higgsfield 연결하기
8분입문
▼

Higgsfield의 원격 MCP 서버를 붙여, 대화창에서 바로 이미지와 영상을 만듭니다. 생성 말고도 업스케일과 배경 제거를 같은 계정으로 부릅니다. API 키 없이 Higgsfield 계정 로그인으로 인증합니다.

Higgsfield MCP 연결 페이지 · higgsfield.ai/mcp ›
Higgsfield 유료 구독이 있어야 연결되고, 이미지나 영상을 만들 때마다 Higgsfield 크레딧이 차감됩니다.
  • ① Higgsfield 상단 메뉴에서 MCP 누르기
    higgsfield.ai에 접속해 맨 위 메뉴에서 MCP를 누릅니다.
  • ② Claude 탭에서 Higgsfield 연결하기 누르기
    Claude 탭을 고르고 Higgsfield 연결하기(영어 화면은 Connect Higgsfield)를 누릅니다.
  • ③ 연결을 누르고 Higgsfield 로그인
    추가한 커넥터의 연결을 누르면 Higgsfield 로그인 창이 열립니다. Higgsfield 계정으로 로그인하고 접근을 허용합니다.
  • ④ 연결 확인
    내 Higgsfield 크레딧 잔액이 얼마야? Claude Desktop에서 새 대화를 열고 위 질문을 보냅니다. 잔액이 숫자로 나오면 연결된 것입니다. 이 확인에는 크레딧이 들지 않습니다.
  • ⑤ 첫 생성 테스트
    Higgsfield로 비 내리는 서울 골목의 작은 카페 이미지를 한 장 만들어줘. 만들기 전에 드는 크레딧을 먼저 알려주고 내 확인을 기다려. 크레딧 안내를 보고 확인하면 이미지가 만들어집니다. 비용을 먼저 알려 달라고 붙여 두면 크레딧이 모르는 사이에 빠지지 않습니다.
  • ① Higgsfield 상단 메뉴에서 MCP 누르기
    higgsfield.ai에 접속해 맨 위 메뉴에서 MCP를 누릅니다.
  • ② ChatGPT 플러그인 탭에서 플러그인 설치
    ChatGPT 플러그인(영어 화면은 ChatGPT Plugin) 탭을 고르고 Higgsfield 플러그인 설치하기를 누릅니다. 플러그인 화면이 열리면 설치하고, Higgsfield 계정으로 로그인해 접근을 허용합니다. Codex 앱은 ChatGPT 계정으로 로그인합니다. 같은 계정에 설치한 플러그인을 Codex에서 그대로 부릅니다.
  • ③ 연결 확인
    내 Higgsfield 크레딧 잔액이 얼마야? Codex 앱에서 새 스레드를 열고 위 질문을 보냅니다. 잔액이 숫자로 나오면 연결된 것입니다. 이 확인에는 크레딧이 들지 않습니다.
  • ④ 첫 생성 테스트
    Higgsfield로 비 내리는 서울 골목의 작은 카페 이미지를 한 장 만들어줘. 만들기 전에 드는 크레딧을 먼저 알려주고 내 확인을 기다려. 크레딧 안내를 보고 확인하면 이미지가 만들어집니다. 비용을 먼저 알려 달라고 붙여 두면 크레딧이 모르는 사이에 빠지지 않습니다.
텔레그램으로 메시지 주고 받기
15분중급터미널 전용
▼

자리를 비운 사이에도 휴대폰 텔레그램으로 지시를 보내고 결과를 받습니다. 일은 내 컴퓨터의 Claude Code가 하고, 텔레그램 봇은 그 사이를 오가는 창구 역할만 합니다. 그래서 컴퓨터를 켜 두고 Claude Code를 실행해 둔 동안에만 작동합니다.

⚠️ 이 예제만 Claude Desktop 앱이 아니라 터미널에서 합니다
  • ① Claude Code 설치 확인
    터미널을 열어 claude를 입력했을 때 명령을 찾을 수 없다고 나오면 아직 설치되지 않은 것입니다. 체크리스트 1단계에서 Node.js와 Claude Code를 설치하고 돌아옵니다. 체크리스트 1단계 · Claude Code 설치하기 ›
  • ② Bun 설치
    Bun은 Claude Code를 설치할 때 쓴 npm 대신 자체 설치 명령을 씁니다. 그 명령이 맥과 윈도우에서 다르므로, 아래에서 내 컴퓨터에 맞는 쪽을 골라 씁니다. 이 명령은 Claude Code 안이 아니라 터미널에 바로 넣습니다. 1번에서 claude를 켜 두었다면 /exit로 나오거나 새 창을 엽니다. 윈도우 · 시작 메뉴에서 Windows PowerShell을 열고 아래 명령어를 붙여넣습니다 irm bun.sh/install.ps1 | iex 맥 · 터미널을 열고 아래 명령어를 붙여넣습니다 curl -fsSL https://bun.sh/install | bash 설치가 끝나면 창을 껐다 켜고 bun --version을 입력해 봅니다. 버전 숫자가 나오면 성공입니다. 윈도우에서 붙여넣기가 Ctrl+V로 안 되면 마우스 우클릭을 쓰세요.
  • ③ BotFather로 봇 만들고 토큰 받기
    텔레그램 앱에서 @BotFather를 찾아 대화를 엽니다. /newbot을 보내고 안내에 따라 봇 이름과 봇 아이디(my_assistant_bot처럼 bot으로 끝나야 합니다)를 정하면, 숫자로 시작하는 긴 문자열을 줍니다. 이것이 토큰, 즉 내 컴퓨터가 이 봇을 움직일 때 쓰는 비밀번호입니다. 통째로 복사해 둡니다. 텔레그램에서 BotFather로 검색하면 이름이 비슷한 가짜 봇이 여럿 나옵니다. 이름 옆에 파란 인증 마크가 붙은 계정을 골라야 합니다. @BotFather 열기 ›
  • ④ 텔레그램 플러그인 설치 (최초 1회)
    /plugin install telegram@claude-plugins-official 터미널에서 claude를 입력해 Claude Code를 켭니다. 그 안에서 위 명령으로 텔레그램 플러그인을 설치합니다. 이 설치는 한 번만 하면 됩니다. 설치가 끝나면 Claude Code를 한 번 껐다 켭니다. 그래야 Claude Code가 다음 단계의 /telegram: 명령과 --channels 옵션을 알아봅니다.
    회사 계정이면 이 설치가 막혀 있을 수 있습니다. 팀 요금제나 엔터프라이즈 요금제는 관리자가 설치 가능한 플러그인 목록을 미리 정해 둘 수 있습니다. 그러면 위 명령을 실행해도 설치가 거부되거나, /plugin 목록에 텔레그램이 아예 보이지 않습니다. 회사 노트북에 IT가 배포한 설정이 걸려 있는 경우도 같습니다.

    이 경우, 사내 IT나 Claude 관리자에게 telegram 플러그인 허용을 요청하거나, 회사 자산이 아닌 개인 계정과 개인 컴퓨터에서 사용합니다.
  • ⑤ 토큰을 Claude Code에 등록
    /telegram:configure <토큰> Claude Code를 켜고 위 명령을 붙여넣습니다. <토큰> 부분을 지우고 그 자리에 3번에서 복사해 둔 토큰을 붙여 실행합니다. 제대로 된 토큰은 숫자로 시작해 콜론(:)이 하나 있고, 그 뒤로 영문과 숫자가 길게 이어집니다.
    봇 토큰은 비밀번호와 같습니다. 공개된 곳에 올리지 않습니다. 토큰은 내 컴퓨터의 ~/.claude/ 안에만 저장됩니다. 혹시 노출되면 BotFather에서 /revoke로 새 토큰을 다시 받습니다.
  • ⑥ 텔레그램과 연결한 상태로 Claude Code 실행
    claude --channels plugin:telegram@claude-plugins-official 터미널을 새로 열고 위 명령으로 Claude Code를 켭니다. 뒤에 붙은 --channels가 텔레그램과 이어 주는 통로를 함께 엽니다. 텔레그램을 쓰려면 Claude Code를 켤 때마다 이 명령으로 실행합니다. claude만 입력하면 텔레그램과 연결되지 않습니다.
  • ⑦ 봇에게 메시지를 보내 확인 코드 받기
    내 텔레그램에서 방금 만든 봇을 찾아 아무 메시지나 보냅니다. 봇은 아직 내가 주인인지 모르기 때문에 메시지를 Claude Code로 넘기지 않고, 6자리 확인 코드부터 보내 줍니다. 숫자와 a부터 f까지의 영문이 섞인 코드입니다.봇은 다음 단계에 붙여 넣을 명령까지 통째로 적어 답장합니다. 그대로 복사해 쓰면 됩니다. 코드는 1시간 뒤 만료되고, 지났으면 메시지를 다시 보내 새로 받습니다.
  • ⑧ 내가 주인이라고 알려 주기
    /telegram:access pair <확인코드> Claude Code 화면으로 돌아와 위 명령을 붙여넣고, <확인코드> 자리에 방금 받은 6자리 코드를 넣어 실행합니다. 이제 봇이 내 메시지를 Claude Code로 넘겨 줍니다. 이 코드를 넣은 사람만 봇을 쓸 수 있습니다. 다른 사람이 봇 주소를 알아내 말을 걸어도 내 Claude Code에는 닿지 않습니다.
  • ⑨ 봇 대화창에서 연결 확인하기
    테스트 텔레그램 봇 대화창에 위 메시지를 보냅니다. Claude Code 화면에 그 메시지가 그대로 도착하면 연결에 성공한 것입니다.
    메시지가 도착하지 않는다면6번 명령(--channels)으로 Claude Code를 켰는지, 8번 확인 코드를 제대로 넣었는지 확인해 봅니다. 그래도 안 되면 터미널에서 bun --version을 입력해서 Bun이 설치되었는지 확인합니다.
  • ⑩ 모르는 사람에게 코드가 나가지 않게 막기
    /telegram:access policy allowlist 지금까지의 설정에서는 낯선 사람이 봇에게 말을 걸면 봇이 그 사람에게도 확인 코드를 보내 줍니다. 7번에서 내가 받은 것과 같은 코드입니다. 내 연결은 9번에서 이미 확인했으니 더는 필요 없습니다. 위 명령을 실행하면 코드 발급이 멈추고, 등록해 둔 나만 봇을 쓰게 됩니다.
주의 사항

각 도구의 화면 구성과 메뉴 이름은 업데이트에 따라 바뀔 수 있습니다. 외부로 메시지나 데이터를 보내는 연결은 되돌리기 어려우니, 민감한 정보를 다룰 때는 사람이 한 번 확인하는 절차를 두고 사내 보안 정책을 함께 확인하시기 바랍니다.

하나만 골라 작게 시작해 보세요

여섯 예제 모두 10~15분이면 첫 연결을 만들 수 있습니다. 지금 가장 끌리는 카드를 펼쳐 그 자리에서 따라가면 됩니다.

가장 쉬운 구글 연결부터 →