도구

설정 경로

서버 설정

Claude Desktop

Windows %APPDATA%\Claude\claude_desktop_config.jsonmacOS ~/Library/Application Support/Claude/claude_desktop_config.json

{ "mcpServers": { "inavi-maps-api": { "command": "npx", "args": ["-y", "@inavi-maps/api-mcp-server"], "env": { "INAVI_APPKEY": "발급받은_API_Key" } } }}

Claude Code

~/.claude.json

{ "mcpServers": { "inavi-maps-api": { "command": "npx", "args": ["-y", "@inavi-maps/api-mcp-server"], "env": { "INAVI_APPKEY": "발급받은_API_Key" } } }}

Cursor

~/.cursor/mcp.json

{ "mcpServers": { "inavi-maps-api": { "command": "npx", "args": ["-y", "@inavi-maps/api-mcp-server"], "env": { "INAVI_APPKEY": "발급받은_API_Key" } } }}

VS Code

사용자 프로필

{ "servers": { "inavi-maps-api": { "command": "npx", "args": ["-y", "@inavi-maps/api-mcp-server"], "env": { "INAVI_APPKEY": "발급받은_API_Key" } } }}

도구

설명

search_places

상호명·건물명·업종·주소·전화번호로 장소와 주소를 검색합니다. 한국어·영어·일본어·중국어를 지원합니다

search_nearby_category

한 지점 주변(반경·사각 영역)에서 같은 분류의 장소를 모두 찾습니다 — 편의점·주차장·충전소처럼 이름이 제각각인 것

geocode_address

주소를 좌표로 바꿉니다

reverse_geocode

좌표를 주소·행정구역 코드·가장 가까운 건물 이름으로 바꿉니다

find_entry_points

경로 탐색 전에 좌표를 차량 진입로·택시 승하차 지점으로 보정합니다

get_admin_boundary

시도·시군구·읍면동·리의 행정구역 경계를 가져옵니다

find_route

경유지 최대 5개의 자동차 경로. 실시간 또는 출발·도착 시각 기준 예측입니다

find_walking_route

도보·킥보드(PM) 경로. 계단·엘리베이터 같은 시설 정보를 담습니다

optimize_waypoint_order

경유지 최대 10곳의 최적 방문 순서를 구합니다

get_distance_matrix

여러 지점 사이의 거리·시간 행렬을 구합니다

lookup_category_code

분류 이름으로 분류 코드를 찾습니다 (API를 호출하지 않습니다)

결과

지도에서 하는 일

장소 검색

언어 바꾸기 · 페이지 넘기기 · 현재 지도에서 재검색 · 경로 만들기 프롬프트 생성

주변 분류 검색

페이지 넘기기 · 경로 만들기 프롬프트 생성

지오코딩

페이지 넘기기

자동차 경로

탐색 기준 변경(추천·무료 도로·고속도로) · 차종 변경

도보 경로

이동 수단 변경(도보·킥보드) · 탐색 기준 변경

거리·시간 행렬

실시간 교통 반영

변수

필수

설명

INAVI_APPKEY

필수

INAVI Maps API Key

증상

확인할 것

인증 실패(300)

INAVI_APPKEY 값이 맞는지

지도 대신 "지도 표시 없이 조회한 결과입니다."만 뜬다

정상입니다. 요청에 "지도에 보여줘"를 붙이세요

지도가 빈 화면

imaps.inavi.com에 접근할 수 있는지(사내망 방화벽)

MCP Inspector에서 지도 배경이 안 보인다

Inspector는 지도 SDK가 쓰는 워커를 막습니다. 도구 호출 확인용으로 쓰고, 지도는 Claude Desktop에서 확인하세요