본문으로 건너뛰기

[OT 사례] palyMCP로 지역 아파트 실거래가 순위 정보 받기

신혜지

2026.05.25

소개

OT에서 카카오의 PlayMCP에서 제공하는 mcp-gateway 서버를 Claude Code에 연결하고,
부동산 실거래 데이터를 조회한 뒤 카카오톡으로 자동 전송하는 흐름을 직접 테스트해봤습니다.

아직 많이 부족해서 실습한 내용을 조금 변형하여 다시 따라해 보았습니다.


진행 방법

사용한 도구

  • Claude Code

  • PlayMCP

  • MCP Gateway

  • KakaoTalk MCP Tool

  • AptInfo MCP Tool

  • Bash / curl


1. PlayMCP 연결 가이드 확인

먼저 PlayMCP에서 제공하는 연결 가이드를 확인했습니다.

https://playmcp.kakao.com/llms.txt
https://playmcp.kakao.com/llms/mcp-connection-guide.md

📌 여기서 중요한 포인트는:

  • oneTimeToken을 accessToken으로 교환해야 함

  • Claude Code는 claude mcp add 명령으로 MCP 서버 등록 가능

  • Authorization Bearer Header 필요


2. oneTimeToken → accessToken 교환

아래 curl 명령으로 토큰을 교환했습니다.

curl -s -X POST "https://playmcp.kakao.com/api/v1/auths/otts:exchange" \
-H "Content-Type: application/json" \
-d "{\"tokenValue\":\"YOUR_ONE_TIME_TOKEN\"}"

응답으로:

  • accessToken

  • refreshToken

  • expiresAt

정보를 받을 수 있었습니다.


3. Claude Code에 MCP Gateway 연결

다음으로 Claude MCP 서버를 등록했습니다.

claude mcp add --transport http mcp-gateway \
https://playmcp.kakao.com/mcp \
--header "Authorization: Bearer ACCESS_TOKEN"

연결 확인:

claude mcp get mcp-gateway

정상적으로 아래 상태가 확인되었습니다.

Status: ✓ Connected

4. MCP 서버 목록 확인

claude mcp list

결과:

mcp-gateway: https://playmcp.kakao.com/mcp (HTTP) - ✓ Connected

여기서 실제로 MCP Tool이 살아있는지 확인할 수 있었습니다.


5. 부동산 MCP Tool 테스트

먼저 송파구 지역코드를 조회했습니다.

사용 프롬프트

송파구 지역코드 조회

호출된 MCP Tool:

AptInfo-get_region_code

응답 예시:

{
  "fullName": "서울특별시 송파구",
  "regionCode": "1171000000"
}

6. 송파구 실거래가 TOP10 조회

사용 프롬프트 전문

송파구 아파트 실거래가 TOP10을 카톡으로 보내주세요.

Claude가 자동으로 아래 흐름을 수행했습니다.

  1. 지역코드 조회

  2. 실거래 데이터 조회

  3. 가격 기준 정렬

  4. 카카오톡 전송

호출된 MCP Tool:

AptInfo-get_apt_price

응답 데이터 일부:

{
  "apartmentName": "잠실엘스",
  "transactionPrice": "27억원",
  "district": "잠실동"
}

7. 카카오톡 자동 전송

마지막으로 카카오톡 나에게 보내기 기능까지 자동 수행되었습니다.

호출된 Tool:

KakaotalkChat-MemoChat

전송된 메시지 예시:

🏢 송파구 아파트 실거래가 TOP10 (2026.04)

1위 잠실엘스 - 27억
2위 파크하비오 - 19.8억
3위 현대1 - 18.4억
...

📸 캡처 추천 위치

아래 화면들을 꼭 첨부하면 좋습니다 😊

  • MCP 연결 성공 화면

  • claude mcp get mcp-gateway

  • 실거래 데이터 JSON 응답

  • 카카오톡 전송 결과

  • Claude Code 터미널 로그


결과와 배운 점

이번 실습에서 인상 깊었던 부분은
“LLM이 단순 채팅이 아니라 실제 액션을 수행하는 Agent 역할을 한다”는 점이었습니다.

특히:

  • MCP 연결

  • 외부 데이터 조회

  • 데이터 가공

  • 카카오톡 발송

이 흐름이 자연스럽게 이어지는 경험이 매우 강력했습니다.


배운 점 💡

1. MCP는 AI Agent 생태계의 핵심 같다

기존 Function Calling보다 훨씬 범용적이고
“도구 연결 표준” 느낌이 강했습니다.


2. Claude Code CLI 조합이 매우 강력함

claude mcp add

한 줄로 외부 Tool 연결이 가능하다는 점이 인상적이었습니다.


3. AI가 실제 업무 자동화를 수행할 수 있음

이번 실습은 단순 조회가 아니라:

  • 부동산 데이터 분석

  • 정렬

  • 메시지 생성

  • 카톡 전송

까지 이어졌기 때문에 실무 활용 가능성이 크게 느껴졌습니다.


시행착오 😅

settings.json 직접 수정 실패

처음에는:

~/.claude/settings.json

에 직접 MCP 설정을 넣으려 했는데 실패했습니다.

결국:

claude mcp add

CLI 방식으로 해결했습니다.


토큰 만료 이슈

oneTimeToken 기반이라
accessToken이 만료되면 재발급이 필요했습니다.

실습 중 새 토큰으로 다시 연결하는 과정도 경험했습니다.


나만의 꿀팁 🍯

MCP 연결 상태는 꼭 확인하기

claude mcp list
claude mcp get mcp-gateway

를 먼저 실행하면 문제 원인 파악이 빨랐습니다.


Tool 이름 흐름을 관찰하면 Agent 구조 이해에 도움됨

예를 들어:

AptInfo-get_region_code
AptInfo-get_apt_price
KakaotalkChat-MemoChat

이런 Tool 호출 흐름을 보면
Agent가 어떤 계획으로 행동하는지 이해할 수 있었습니다.


앞으로의 계획 🚀

다음에는:

  • 실거래가 자동 리포트

  • 매일 아침 카카오톡 브리핑

  • 관심 지역 가격 변동 추적

  • Slack / Discord 연동

  • MCP + RAG 조합

등 더 다양하게 실습해보고 싶습니다.



1

함께 이야기해요 1

로그인하고 댓글을 남겨 주세요

윤스케어 프로필 이미지
윤스케어2026.05.27

처음 지피터스 오신 후 처음 사례 ㅎ 어떠신가요?

"OT 실습을 변형해서 다시 따라해 봤다"는 자세가 좋으세요. 앞으로도 열심히 공부해보아요~

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기