KiMCP (코리아 통합 MCP) 설치·사용법 — 네이버·카카오·티맵 등 한국 주요 API를 Claude/Cursor에서 바로 쓰기

Q: Claude Desktop이 아닌 Cursor에서도 KiMCP를 쓸 수 있나요?

네. Cursor의 MCP 설정 파일(mcp.json)에 동일한 방식으로 KiMCP 항목을 추가하면 Cursor에서도 한국 API 도구를 사용할 수 있습니다.

Q: npx나 uvx 명령으로 바로 실행할 수 있나요?

현재 KiMCP는 npm 패키지로 배포되지 않아 npx 직접 실행을 지원하지 않습니다. GitHub 저장소를 클론한 뒤 로컬에서 실행하는 방식을 사용해야 합니다.

핵심 요약(TL;DR)

**KiMCP(코리아 통합 MCP)**는 네이버 검색, 다음(Daum) 검색, 카카오 지도, 티맵(TMAP) 등 한국 주요 서비스 API를 Claude·Cursor 같은 AI 클라이언트에서 바로 호출할 수 있게 해주는 오픈소스 MCP 서버입니다. GitHub 저장소를 클론해 로컬에서 실행하고, Claude Desktop 설정 파일에 항목을 추가하면 즉시 사용할 수 있습니다. API 키가 필요하지만 각 서비스의 개발자 콘솔에서 무료로 발급받을 수 있으므로 진입 장벽이 낮습니다.

KiMCP가 왜 필요한가

기존 Claude나 Cursor는 인터넷에 직접 접속하지 못합니다. 그래서 “지금 강남역 근처 맛집을 카카오 지도에서 찾아줘” 또는 “네이버 뉴스에서 오늘 AI 관련 기사 요약해줘” 같은 요청을 처리하려면 별도 도구 연동이 필요합니다.

MCP(Model Context Protocol)는 AI 클라이언트와 외부 도구 사이의 표준 통신 규약입니다. KiMCP는 이 규약을 따르는 서버로, 한국 개발자가 가장 많이 쓰는 API 서비스를 묶어 하나의 패키지로 제공합니다. 별도의 백엔드를 구축하거나 API를 직접 호출하는 코드를 짜지 않아도, Claude가 자연어 요청만으로 한국 데이터를 가져올 수 있게 됩니다.

KiMCP가 지원하는 한국 API

서비스	기능 예시	API 키 출처
Naver Search API	블로그·뉴스·쇼핑·이미지 검색	네이버 개발자 센터
Daum Search API	다음 웹 검색·카페·블로그 검색	카카오 개발자 콘솔
Kakao Map API	장소 검색·좌표 변환·경로 안내	카카오 개발자 콘솔
TMAP (SK Open API)	내비게이션·대중교통 경로	SK Open API 포털

데이터 흐름 구조

KiMCP가 실제로 어떻게 동작하는지 흐름으로 정리하면 다음과 같습니다.

사용자(자연어 질문)
        │
        ▼
  Claude Desktop / Cursor
  (MCP 클라이언트)
        │  MCP stdio 통신
        ▼
  KiMCP 서버 (로컬 실행)
  ├── Naver Search API 모듈
  ├── Daum Search API 모듈
  ├── Kakao Map API 모듈
  └── TMAP API 모듈
        │  HTTPS 요청
        ▼
  한국 외부 API 서버
  (네이버·카카오·SK 서버)
        │  JSON 응답
        ▼
  Claude가 결과를 정리해 답변

준비물

설치를 시작하기 전에 아래 항목을 미리 준비해 두세요.

Node.js 18 이상 — 터미널에서 node -v 로 버전 확인
Git — 저장소 클론에 필요
Claude Desktop 또는 Cursor — MCP 클라이언트
API 키 — 사용할 서비스에 따라 아래에서 발급

단계별 설치 방법

1단계: API 키 발급

사용하려는 서비스에 따라 필요한 키를 먼저 발급받습니다.

네이버 API 키 발급

네이버 개발자 센터에 접속해 로그인합니다.
‘애플리케이션 등록’을 클릭하고 애플리케이션 이름을 입력합니다.
사용 API 항목에서 ‘검색’을 선택합니다.
등록 완료 후 Client ID와 Client Secret을 메모해 둡니다.

카카오 API 키 발급

카카오 개발자 콘솔에 로그인합니다.
‘내 애플리케이션 → 애플리케이션 추가하기’를 선택합니다.
앱 이름과 회사명을 입력하고 저장합니다.
앱 설정 페이지에서 REST API 키를 확인합니다.

2단계: 저장소 클론 및 의존성 설치

터미널을 열고 아래 명령을 순서대로 실행합니다.

# 저장소 클론
git clone https://github.com/zeikar/kimcp

# 프로젝트 디렉터리로 이동
cd kimcp

# 의존성 설치
npm install

3단계: 환경 변수 파일 작성

프로젝트 루트에 .env 파일을 생성하고 발급받은 API 키를 입력합니다. 사용하지 않는 서비스의 항목은 비워두어도 됩니다.

# kimcp 폴더 안에서 실행
cp .env.example .env

이후 텍스트 편집기로 .env 파일을 열어 아래 형식으로 값을 채웁니다.

NAVER_CLIENT_ID=발급받은_네이버_클라이언트_ID
NAVER_CLIENT_SECRET=발급받은_네이버_클라이언트_시크릿
KAKAO_REST_API_KEY=발급받은_카카오_REST_API_키
TMAP_API_KEY=발급받은_티맵_API_키

4단계: Claude Desktop 설정 파일에 KiMCP 등록

Claude Desktop의 MCP 설정 파일 위치는 운영체제에 따라 다릅니다.

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

해당 파일을 열고 mcpServers 블록에 아래 내용을 추가합니다. [kimcp_절대경로] 부분은 실제 클론한 폴더의 절대 경로로 바꿔야 합니다.

{
  "mcpServers": {
    "kimcp": {
      "command": "node",
      "args": ["[kimcp_절대경로]/index.js"],
      "env": {
        "NAVER_CLIENT_ID": "발급받은_네이버_클라이언트_ID",
        "NAVER_CLIENT_SECRET": "발급받은_네이버_클라이언트_시크릿",
        "KAKAO_REST_API_KEY": "발급받은_카카오_REST_API_키",
        "TMAP_API_KEY": "발급받은_티맵_API_키"
      }
    }
  }
}

이미 다른 MCP 서버가 등록된 경우, mcpServers 객체 안에 "kimcp": ... 항목만 추가하면 됩니다.

5단계: Claude Desktop 재시작 및 동작 확인

Claude Desktop을 완전히 종료합니다(트레이 아이콘까지 확인).
다시 실행합니다.
채팅창에서 아래처럼 입력해 보세요.

“네이버에서 MCP 서버 관련 최신 뉴스 3개를 검색해서 요약해줘.”

Claude가 KiMCP 도구를 호출해 네이버 검색 결과를 가져와 답변한다면 설치가 완료된 것입니다.

흔한 오류와 해결 방법

오류 1: “Cannot find module ’./index.js’”

args 배열의 경로가 잘못된 경우입니다. 터미널에서 pwd 명령으로 kimcp 폴더의 절대 경로를 확인한 뒤 설정 파일에 정확히 입력하세요.

# kimcp 폴더로 이동 후 절대 경로 확인
cd kimcp && pwd
# 출력 예: /Users/yourname/dev/kimcp

오류 2: “401 Unauthorized” 또는 “403 Forbidden”

API 키가 올바르지 않거나 해당 API 서비스를 활성화하지 않은 경우입니다. 개발자 콘솔에서 API 키와 서비스 활성화 여부를 다시 확인하세요.

오류 3: Claude Desktop에 KiMCP 도구가 보이지 않음

설정 파일의 JSON 문법이 맞는지 확인합니다(쉼표 누락, 괄호 불일치 등).
Claude Desktop을 완전 종료 후 재시작합니다.
터미널에서 node [kimcp_절대경로]/index.js 를 직접 실행해 에러가 없는지 확인합니다.

Cursor에서 KiMCP 사용하기

Cursor도 MCP를 지원합니다. Cursor의 설정 파일은 프로젝트 루트의 .cursor/mcp.json 또는 글로벌 설정인 ~/.cursor/mcp.json 입니다.

{
  "mcpServers": {
    "kimcp": {
      "command": "node",
      "args": ["[kimcp_절대경로]/index.js"],
      "env": {
        "NAVER_CLIENT_ID": "발급받은_네이버_클라이언트_ID",
        "NAVER_CLIENT_SECRET": "발급받은_네이버_클라이언트_시크릿",
        "KAKAO_REST_API_KEY": "발급받은_카카오_REST_API_키"
      }
    }
  }
}

Cursor를 재시작하면 Agent 모드에서 KiMCP 도구를 자동 인식합니다.

함께 활용하면 좋은 한국형 MCP 서버

KiMCP와 함께 사용하면 시너지 효과를 낼 수 있는 서버들을 소개합니다.

한국어 맞춤법 검사 MCP — 네이버 맞춤법 검사기를 활용해 Claude가 작성한 한국어 문장의 철자·문법을 자동 교정합니다. API 키 없이 npx -y @winterjung/mcp-korean-spell 로 즉시 실행 가능합니다.
네이웍스 MCP 서버 — LINE WORKS(NAVER WORKS) 전용 서버로, 메시지·캘린더·드라이브·메일 등 26개 도구를 제공합니다.
카카오·네이버 카테고리의 다른 MCP 서버 보기
전체 한국 MCP 서버 목록 보기

자주 묻는 질문

API 키가 반드시 필요한가요?

네, 네이버·카카오·티맵 등 각 서비스의 API 키가 필요합니다. 사용하려는 서비스의 개발자 콘솔에서 무료로 발급받을 수 있습니다. 모든 API 키를 다 발급받지 않아도 되고, 사용할 서비스의 키만 입력하면 됩니다.

Claude Desktop이 아닌 Cursor에서도 KiMCP를 쓸 수 있나요?

네. Cursor의 MCP 설정 파일(mcp.json)에 동일한 방식으로 KiMCP 항목을 추가하면 Cursor에서도 한국 API 도구를 사용할 수 있습니다. 위 ‘Cursor에서 KiMCP 사용하기’ 섹션을 참고하세요.

npx나 uvx 명령으로 바로 실행할 수 있나요?

현재 KiMCP는 npm 패키지로 별도 배포되지 않아 npx 직접 실행을 지원하지 않습니다. GitHub 저장소를 클론한 뒤 로컬에서 node index.js 방식으로 실행해야 합니다.

네이버 검색과 다음 검색 중 어떤 결과가 더 좋은가요?

서비스 성격에 따라 다릅니다. 네이버 검색은 뉴스·블로그·쇼핑 등 네이버 생태계 데이터에 강하고, Daum 검색은 카카오 생태계와 연계된 콘텐츠에 강점이 있습니다. 용도에 맞게 선택하거나 두 결과를 비교해 사용하면 더욱 풍부한 정보를 얻을 수 있습니다.

티맵(TMAP) API 키는 어디서 발급하나요?

SK Open API 포털(https://openapi.sk.com)에서 회원가입 후 티맵 관련 API를 신청하면 키를 발급받을 수 있습니다.

MCP 서버가 Claude에서 인식되지 않을 때는 어떻게 하나요?

설정 파일 경로와 JSON 문법을 먼저 확인하세요. 이후 Claude Desktop을 완전히 종료하고 재실행하면 대부분 해결됩니다. 그래도 안 된다면 터미널에서 node [kimcp_절대경로]/index.js 명령으로 직접 서버를 실행해 오류 메시지를 확인하세요.

다음 단계

KiMCP 설치가 완료됐다면 아래 서버들도 함께 탐색해 보세요. 한국형 MCP 생태계를 더욱 풍부하게 활용할 수 있습니다.

한국어 맞춤법 검사 MCP — Claude가 쓴 한국어를 자동으로 교정
네이웍스 MCP 서버 — LINE WORKS 업무 자동화
가이드 전체 목록 보기 — 더 많은 한국 MCP 설치·활용 가이드