카카오 PlayMCP 사용법: 로그인 한 번으로 AI 에이전트에 카카오 도구 연동하기

카카오 PlayMCP는 카카오가 운영하는 MCP(Model Context Protocol) 기반 도구 플랫폼입니다. 카카오 로그인 한 번으로 카카오맵, 톡캘린더 같은 카카오 서비스를 Claude Desktop·Cursor 같은 AI 클라이언트에 연결할 수 있습니다. 핵심은 별도의 API 키 발급이나 OAuth 콜백 설정이 아니라, PlayMCP가 발급하는 개인 MCP 엔드포인트 URL 하나를 클라이언트 설정에 등록하는 방식이라는 점입니다.

이 가이드는 PlayMCP 로그인부터 도구함 설정, 엔드포인트 URL 복사, Claude Desktop·Cursor 등록, 첫 명령 실행, 그리고 연결이 안 될 때의 점검 순서까지를 단계별로 다룹니다.

PlayMCP가 기존 카카오 API 연동과 다른 점

기존 방식으로 카카오 API를 AI에 붙이려면 개발자 콘솔에서 앱을 만들고, REST API 키를 발급받고, OAuth 리다이렉트 URI를 등록하고, 토큰을 직접 갱신·관리해야 했습니다. 일반 사용자에게는 진입 장벽이 높고, 개발자에게도 키 만료와 정책 변경을 계속 따라가야 하는 부담이 있었습니다.

PlayMCP는 이 인증·권한 관리를 플랫폼이 대신 처리합니다. 사용자는 카카오 계정으로 로그인하고, 어떤 카카오 도구를 AI에 노출할지 도구함에서 켜기만 하면 됩니다. 발급된 엔드포인트 URL을 클라이언트에 등록하는 순간 해당 도구들이 AI 채팅에서 호출 가능한 도구로 나타납니다.

사용자 요청
    │
    ▼
Claude Desktop / Cursor (MCP 클라이언트)
    │  MCP 프로토콜 (개인 엔드포인트 URL)
    ▼
PlayMCP 서버  ── 카카오 로그인·OAuth·권한 관리 대행
    │
    ├── 카카오맵 API   → 장소 검색·길 찾기
    └── 톡캘린더 API   → 일정 조회·등록 등
    │
    ▼
실제 데이터·액션 결과 (동일 경로로 역방향 전달)
    │
    ▼
Claude 답변

호스팅형 원격 서버이므로, 등록하는 도구가 내 계정·일정 등 개인 데이터에 접근한다는 점을 전제로 다룹니다. 어떤 도구를 켜는지, 로그인 동의 화면에서 어떤 권한에 동의하는지 직접 확인하세요.

준비물

항목	설명
카카오 계정	PlayMCP 로그인에 사용. 별도 API 키 발급은 불필요
MCP 지원 클라이언트	Claude Desktop, Cursor 등 MCP를 지원하는 AI 클라이언트
텍스트 에디터	클라이언트 설정 파일(JSON) 편집용

PlayMCP의 기본 도구는 카카오 로그인만으로 동작하도록 설계돼 있어, 카카오 개발자 콘솔에서 앱을 만들고 REST API 키를 발급하는 단계가 필요 없습니다. (카카오 API를 직접 코드로 호출하려는 경우에는 별도 앱 등록과 키 발급이 필요하지만, 그것은 PlayMCP를 거치지 않는 다른 방식입니다.)

단계별 설정 방법

1단계: PlayMCP 접속 및 카카오 로그인

playmcp.kakao.com에 접속해 카카오로 로그인으로 인증합니다. 로그인 시 PlayMCP가 어떤 데이터에 접근하는지 동의 화면에 표시되므로, 필요한 권한 범위(scope)를 확인하고 동의합니다.

2단계: 도구함에서 사용할 서비스 활성화

로그인 후 도구함(Tool Library) 에서 연동할 카카오 서비스(예: 카카오맵, 톡캘린더 등)를 찾아 사용 설정을 켭니다. 도구함에 노출되는 서비스 목록과 각 도구가 요구하는 권한은 PlayMCP 화면에서 직접 확인하세요. 여기서 켠 도구만 이후 AI 클라이언트의 도구 목록에 나타납니다.

최소 권한 원칙: 당장 쓸 도구만 켜는 편이 안전합니다. 일정·메시지처럼 민감한 데이터에 접근하는 도구는 실제로 필요할 때만 활성화하세요.

3단계: 개인 MCP 엔드포인트 URL 복사

내 설정 페이지에서 발급된 개인화된 MCP 엔드포인트 URL을 복사합니다. 이 URL은 내 계정·활성화한 도구에 연결되는 자격 증명에 해당하므로, API 키와 동일하게 취급해 외부에 노출하지 마세요.

4단계: AI 클라이언트에 MCP 서버 등록

복사한 URL을 클라이언트 설정 파일의 mcpServers 항목에 추가합니다. Claude Desktop 설정 파일 위치는 운영체제에 따라 다릅니다.

운영체제	파일 경로
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

YOUR_PLAYMCP_URL 자리에 3단계에서 복사한 URL을 붙여넣습니다.

{
  "mcpServers": {
    "playmcp": {
      "url": "YOUR_PLAYMCP_URL",
      "transport": "sse"
    }
  }
}

Cursor를 사용한다면 프로젝트 루트의 .cursor/mcp.json에 동일한 형식으로 추가합니다. 그 외 MCP를 지원하는 클라이언트도 같은 방식으로 URL 기반 서버 블록을 등록하면 됩니다. 단, 클라이언트별로 원격 서버 전송 방식(transport) 키 이름이나 지원 여부가 다를 수 있으므로, 동작하지 않으면 해당 클라이언트의 MCP 설정 문서를 함께 확인하세요.

5단계: 클라이언트 재시작 및 도구 확인

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 실행합니다. 정상 연결되면 채팅창 하단의 도구 아이콘(망치 모양)을 눌렀을 때 PlayMCP에서 켠 카카오 도구들이 목록에 나타납니다. 도구가 보이지 않으면 흔한 오류와 해결을 참고하세요.

6단계: AI 에이전트로 카카오 서비스 호출

연결이 끝나면 대화하듯 요청하면 Claude가 적절한 도구를 골라 실행합니다.

• “서울 강남역 주변 카페를 카카오맵으로 검색해줘”
• “이번 주 톡캘린더 일정 정리해줘”

도구가 개인 데이터를 읽거나 변경하는 경우, 클라이언트는 보통 실행 전 사용자 확인을 요청합니다. 어떤 도구가 어떤 동작을 하는지 확인한 뒤 승인하세요.

흔한 오류와 해결

JSON 문법 오류로 클라이언트가 서버를 읽지 못하는 경우

설정 파일은 JSON 문법을 엄격히 따릅니다. 가장 흔한 원인은 마지막 항목 뒤의 불필요한 쉼표, 그리고 따옴표 짝이 맞지 않는 경우입니다.

{
  "mcpServers": {
    "playmcp": {
      "url": "YOUR_PLAYMCP_URL",
      "transport": "sse"
    }
  }
}

항목 사이에만 쉼표를 넣고 마지막 항목 뒤에는 넣지 마세요. 저장 후에는 반드시 클라이언트를 완전히 종료했다가 다시 실행해야 변경이 적용됩니다.

도구 목록에 PlayMCP가 나타나지 않는 경우

1. URL을 정확히 복사했는지, 앞뒤 공백이나 줄바꿈이 섞이지 않았는지 확인합니다.
2. 클라이언트를 완전히 종료 후 재시작했는지 확인합니다.
3. 사용 중인 클라이언트가 원격(URL 기반) MCP 서버를 지원하는지, transport 키 표기가 맞는지 클라이언트 문서로 확인합니다.

인증·권한 오류가 나는 경우

도구 호출이 권한 문제로 실패한다면, PlayMCP 도구함에서 해당 도구가 켜져 있는지와 로그인 시 필요한 권한에 동의했는지를 먼저 확인하세요. 동의 범위를 바꾼 경우 PlayMCP에서 다시 로그인·동의가 필요할 수 있습니다. 그래도 해결되지 않으면 PlayMCP에서 엔드포인트 URL을 다시 확인해 설정 파일의 값과 일치시키세요.

카카오 서비스와 함께 쓰면 좋은 한국어 MCP 서버

PlayMCP로 카카오 도구를 붙였다면, 아래 한국어 MCP 서버를 함께 등록해 워크플로를 넓힐 수 있습니다.

한국어 맞춤법 검사 MCP 는 네이버 맞춤법 검사기를 활용해 메시지·문서의 철자·문법을 교정합니다. API 키 없이 바로 사용할 수 있습니다.

npx -y @winterjung/mcp-korean-spell

네이웍스 MCP 서버 는 LINE WORKS(NAVER WORKS) 전용 서버로, 메시지·캘린더·드라이브·메일을 포함한 26개 도구를 제공합니다. 기업용 협업 도구까지 함께 다룰 때 유용합니다.

npx nworks mcp

에이전트웹서치 MCP 는 API 키 없이 Chrome CDP로 네이버·구글·Brave를 병렬 검색합니다. 카카오 로컬 검색 결과와 교차 검증할 때 쓸 수 있습니다.

카카오·네이버 생태계의 MCP 서버를 더 찾으려면 카카오/네이버 카테고리를 확인하세요.

보안 주의사항

PlayMCP 엔드포인트 URL은 내 계정과 활성화한 도구에 연결되는 자격 증명입니다.

• 엔드포인트 URL이 담긴 설정 파일(claude_desktop_config.json, .cursor/mcp.json)을 Git에 커밋하지 마세요. .gitignore에 추가하거나 별도로 분리해 보관하세요.
• URL이 유출됐다고 판단되면 PlayMCP에서 엔드포인트를 재발급/회수하고, 설정 파일의 값도 새 값으로 교체하세요.
• 도구함에서는 최소 권한 원칙을 따르세요. 쓰지 않는 도구는 꺼 두고, 일정·메시지처럼 민감한 동작을 하는 도구는 실행 전 확인 단계를 건너뛰지 마세요.
• 카카오 계정 자체의 보안을 위해 2단계 인증을 켜 두는 것을 권장합니다.

자주 묻는 질문

카카오 PlayMCP는 API 키를 발급받아야 하나요?

아닙니다. PlayMCP는 카카오 로그인만으로 도구함의 기본 도구를 사용하도록 설계돼 있어, 개발자 콘솔에서 앱을 만들고 REST API 키를 발급·관리하는 과정이 필요 없습니다. 사용자는 도구를 켜고, 발급된 엔드포인트 URL을 클라이언트에 등록하기만 하면 됩니다.

Claude Desktop 외에 Cursor나 다른 클라이언트에서도 쓸 수 있나요?

MCP를 지원하는 클라이언트라면 동일하게 연결할 수 있습니다. Cursor는 .cursor/mcp.json에 같은 형식으로 URL 기반 서버를 추가합니다. 다만 원격 서버 지원 여부와 transport 표기는 클라이언트마다 다를 수 있으니 각 클라이언트의 MCP 설정 문서를 함께 확인하세요.

엔드포인트 URL이 유출되면 어떻게 하나요?

URL은 API 키와 동일하게 다뤄야 하는 민감 정보입니다. 유출이 의심되면 PlayMCP에서 엔드포인트를 재발급하거나 회수하고, 설정 파일에 저장된 값을 새 값으로 교체하세요. 커밋 이력에 URL이 남지 않았는지도 확인합니다.

연결 후 Claude가 카카오 도구를 인식하지 못하면 어떻게 하나요?

첫째, Claude Desktop을 완전히 종료한 뒤 재시작하세요. 둘째, 설정 파일의 JSON 문법(쉼표·따옴표)과 URL 값에 공백·줄바꿈이 섞이지 않았는지 확인하세요. 셋째, 사용 중인 클라이언트가 원격(URL 기반) MCP 서버를 지원하는지, PlayMCP 도구함에서 도구가 켜져 있는지 확인하세요.

도구가 내 일정 같은 개인 데이터에 접근하나요?

PlayMCP는 로그인 시 동의한 권한 범위(scope) 안에서만 데이터에 접근합니다. 어떤 도구를 켜는지, 동의 화면에서 어떤 권한에 동의하는지 직접 확인할 수 있으며, 필요 없는 도구는 도구함에서 꺼 두면 됩니다.

다음 단계

카카오 PlayMCP 연동을 마쳤다면 더 많은 한국 서비스 MCP 서버를 탐색해 보세요. MCP 서버 전체 목록에서 공공데이터·금융·지도 등 다양한 한국 API 기반 서버를 찾을 수 있고, 직접 만든 서버를 등록하려면 서버 제출 페이지를 이용하세요.