한국 관광공사 API MCP 서버 설치·사용법 — 한국관광공사(KTO) 공공데이터 API를 Claude·Cursor에 연결하기

Q: Claude Desktop 설정 파일은 어디에 있나요?

macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows는 %APPDATA%\Claude\claude_desktop_config.json 경로에 있습니다.

한국관광공사(KTO)가 제공하는 TourAPI를 Claude나 Cursor 같은 AI 도구에서 직접 쓸 수 있습니다. Korea Tourism API MCP Server를 설치하면 별도 코딩 없이도 AI 채팅 한 줄로 지역 관광지, 축제, 숙박 정보를 불러올 수 있습니다. data.go.kr에서 무료 API 키를 발급받고, Smithery CLI 명령 한 번으로 Claude Desktop에 연결하는 것이 전부입니다.

Korea Tourism API MCP 서버란 무엇인가요?

Korea Tourism API MCP Server는 한국관광공사(KTO)가 공공데이터포털(data.go.kr)을 통해 공개하는 TourAPI를 MCP(Model Context Protocol) 규격으로 래핑한 오픈소스 서버입니다. MCP는 AI 클라이언트와 외부 도구·데이터를 표준 방식으로 연결하는 프로토콜로, Claude Desktop·Cursor 등 MCP를 지원하는 클라이언트라면 어디서든 플러그인처럼 붙일 수 있습니다.

아래 흐름을 보면 구조를 한눈에 이해할 수 있습니다.

사용자(Claude/Cursor)
      │  자연어 질의
      ▼
Korea Tourism API MCP Server
      │  HTTP 요청 + API 키
      ▼
한국관광공사 TourAPI (data.go.kr)
      │  JSON 응답
      ▼
Korea Tourism API MCP Server
      │  파싱·정제
      ▼
Claude/Cursor → 자연어 답변

이 서버를 설치하면 “서울 근처 무장애 관광지 알려줘”나 “이번 주 부산 축제 일정 정리해 줘” 같은 요청을 AI가 실제 공공 데이터를 근거로 답변하게 됩니다.

준비물 한눈에 보기

항목	내용	비고
Node.js	v18 이상	`node -v`로 확인
Claude Desktop	최신 버전	claude.ai/download
data.go.kr 계정	무료 회원가입	본인 인증 필요
TourAPI 인증키	일반 인증키(Decoding)	발급 후 1~2시간 활성화

단계별 설치 방법

1단계 — data.go.kr에서 API 키 발급하기

data.go.kr에 접속해 회원가입·로그인합니다.
검색창에 **“한국관광공사_국문 관광정보 서비스”**를 입력합니다.
검색 결과에서 해당 항목을 클릭하고 “활용신청” 버튼을 누릅니다.
활용 목적을 간단히 입력하고 신청을 완료합니다.
마이페이지 > API 신청 목록에서 **일반 인증키(Decoding)**를 복사해 둡니다.

키 활성화에는 최대 2시간이 걸릴 수 있습니다. 키가 아직 활성화되지 않은 상태에서 API를 호출하면 인증 오류가 발생하므로, 여유 있게 미리 신청해 두는 것을 권장합니다.

2단계 — Smithery CLI로 MCP 서버 설치하기

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

npx -y @smithery/cli install @harimkang/mcp-korea-tourism-api --client claude

CLI가 실행되면 API 키를 입력하라는 프롬프트가 나타납니다. 1단계에서 복사한 **일반 인증키(Decoding)**를 붙여 넣고 엔터를 누릅니다. 설치가 완료되면 Claude Desktop 설정 파일이 자동으로 업데이트됩니다.

3단계 — 설정 파일 확인하기

설치 후 Claude Desktop 설정 파일을 열어 항목이 올바르게 추가됐는지 확인합니다.

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

파일을 열면 아래와 비슷한 블록이 추가돼 있어야 합니다.

{
  "mcpServers": {
    "mcp-korea-tourism-api": {
      "command": "npx",
      "args": ["-y", "@harimkang/mcp-korea-tourism-api"],
      "env": {
        "TOUR_API_KEY": "여기에_발급받은_인증키"
      }
    }
  }
}

TOUR_API_KEY 값이 실제 발급받은 인증키로 채워져 있는지 확인하세요. 다른 MCP 서버가 이미 등록돼 있다면 mcpServers 오브젝트 안에 새 항목만 추가하면 됩니다.

4단계 — Claude Desktop 재시작 및 동작 확인

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료(트레이 아이콘 우클릭 > 종료)하고 다시 시작합니다. 채팅 창에서 아래처럼 입력해 보세요.

“경주 근처 관광지 5곳을 TourAPI 데이터를 바탕으로 알려줘.”

MCP 서버가 정상 연결됐다면 Claude가 공공 데이터를 실제로 조회한 뒤 답변을 생성합니다. 화면 하단에 MCP 도구 호출 표시가 보이면 성공입니다.

5단계 — Cursor에 추가하기(선택)

Cursor에도 동일한 서버를 등록할 수 있습니다. Cursor의 MCP 설정 파일(~/.cursor/mcp.json 또는 프로젝트 루트 .cursor/mcp.json)을 열고 아래 블록을 추가합니다.

{
  "mcpServers": {
    "mcp-korea-tourism-api": {
      "command": "npx",
      "args": ["-y", "@harimkang/mcp-korea-tourism-api"],
      "env": {
        "TOUR_API_KEY": "여기에_발급받은_인증키"
      }
    }
  }
}

저장 후 Cursor를 재시작하면 에이전트 모드에서 관광 데이터를 활용할 수 있습니다.

흔한 오류와 해결 방법

증상	원인	해결 방법
”SERVICE_KEY_IS_NOT_REGISTERED_ERROR”	API 키 미활성화 또는 오타	data.go.kr에서 키 재확인, 활성화 대기
”command not found: npx”	Node.js 미설치	nodejs.org에서 LTS 설치 후 터미널 재시작
MCP 서버 목록에 항목이 없음	설정 파일 JSON 문법 오류	설정 파일을 JSON 검사기로 확인
API 응답이 빈 배열	조회 지역·조건 없음	더 구체적인 지역명 또는 콘텐츠 유형 지정
Claude가 “도구를 사용할 수 없다”고 응답	재시작 누락	Claude Desktop 완전 종료 후 재시작

JSON 문법 오류는 흔한 함정입니다. 쉼표가 하나 빠지거나 괄호가 닫히지 않으면 MCP 서버 전체가 로드되지 않습니다. VS Code나 온라인 JSON 검사기로 파일을 붙여 넣어 오류 위치를 찾으세요.

활용 예시: AI와 여행 일정 만들기

설치가 완료되면 아래처럼 다양한 방식으로 활용할 수 있습니다.

여행 일정 자동 생성: “2박 3일 강원도 여행 코스를 TourAPI 데이터로 구성해 줘.”
축제 달력 만들기: “올해 하반기 전국 주요 축제를 표로 정리해 줘.”
무장애 여행 계획: “휠체어 이동 가능한 제주도 관광지를 찾아 줘.”
숙박 조건 검색: “경북 안동에서 한옥 숙박 가능한 곳을 알려줘.”

실제 공공 데이터 기반이므로 일반 언어 모델 단독 답변보다 더 정확하고 최신 정보를 얻을 수 있습니다.

자주 묻는 질문

API 키 없이도 Korea Tourism API MCP Server를 사용할 수 있나요?

아니요. 한국관광공사 TourAPI는 data.go.kr 회원가입 후 API 신청을 거쳐야 인증키를 받을 수 있습니다. 키 발급은 보통 1~2시간 내에 완료되며 무료입니다.

Smithery CLI 설치 중 ‘command not found: npx’ 오류가 나옵니다.

Node.js(v18 이상)가 설치되지 않은 경우입니다. nodejs.org에서 LTS 버전을 설치한 뒤 다시 시도하세요. 설치 후에는 터미널을 새로 열어야 PATH가 갱신됩니다.

Claude Desktop 설정 파일은 어디에 있나요?

macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows는 %APPDATA%\Claude\claude_desktop_config.json 경로에 있습니다.

어떤 관광 정보를 조회할 수 있나요?

TourAPI를 통해 지역별 관광지·숙박·음식점·축제·공연 정보, 무장애 관광지, 외국어 관광 정보 등을 조회할 수 있습니다. 구체적인 항목은 공식 TourAPI 문서를 참고하세요.

Cursor에서도 동일하게 사용할 수 있나요?

네. Cursor의 MCP 설정 파일에 동일한 서버 블록을 추가하면 코드 작성 중에도 관광 데이터를 AI에 질의할 수 있습니다. 설정 방법은 위 5단계를 참고하세요.

API 키가 노출되면 어떻게 하나요?

data.go.kr의 마이페이지에서 해당 키를 폐기하고 새 키를 재발급하세요. 설정 파일을 git 저장소에 올리지 않도록 .gitignore에 claude_desktop_config.json을 추가해 두는 것을 강력히 권장합니다.

다음 단계

Korea Tourism API MCP Server를 설치했다면, 다음으로 공공데이터포털 MCP 서버 모음을 살펴보세요. 관광 데이터에 더해 국민연금·조달청·금감원 데이터까지 AI에 연결하면 더 폭넓은 공공데이터 활용이 가능합니다. 직접 만든 공공데이터 MCP 서버가 있다면 MCP모아에 등록해 한국 개발자 커뮤니티와 공유해 보세요.