기상청 API 키 발급 및 MCP 설정 — data.go.kr부터 Claude 연동까지

Q: API 키 승인까지 얼마나 걸리나요?

기상청 단기예보 API는 신청 후 즉시 또는 1~2시간 이내에 자동 승인되는 경우가 대부분입니다. 드물게 담당자 확인이 필요한 경우 최대 1~2 영업일이 소요될 수 있습니다.

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

macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows는 %APPDATA%\Claude\claude_desktop_config.json에 위치합니다. 파일이 없으면 직접 생성하면 됩니다.

기상청 단기예보 API 키를 data.go.kr에서 발급받고 한국 기상청 날씨 MCP 서버에 연결하면, Claude Desktop 채팅창에서 “오늘 서울 날씨 어때?”라고 입력하는 것만으로 실시간 날씨 정보를 바로 받을 수 있습니다. API 키 발급은 무료이며 대부분 즉시 승인됩니다. 이 글은 공공데이터포털 회원가입부터 Claude 연동 테스트까지 6단계로 전 과정을 안내합니다.

왜 기상청 API를 MCP로 연결해야 하나요?

기상청은 공공데이터포털(data.go.kr)을 통해 단기예보·초단기예보·강수확률 등 다양한 날씨 데이터를 오픈API로 무료 제공합니다. 하지만 기존에는 이 데이터를 사용하려면 HTTP 요청 코드를 직접 작성하고 응답 JSON을 파싱해야 했습니다.

MCP(Model Context Protocol)를 활용하면 이 과정을 AI가 대신합니다. 한국 기상청 날씨 MCP 서버를 Claude Desktop에 연결하면, 자연어 질문만으로 기상청 단기예보 API 호출이 자동으로 이루어집니다.

사용자 자연어 질문
        │
        ▼
Claude Desktop (AI 언어 모델)
        │  MCP 프로토콜
        ▼
한국 기상청 날씨 MCP 서버
        │  HTTP 요청 + API 키
        ▼
기상청 단기예보 조회서비스 (data.go.kr)
        │  JSON 기상 데이터
        ▼
Claude Desktop (날씨 정보 정리 후 답변)

준비물 확인

시작 전에 아래 항목을 준비해 두세요.

항목	설명
data.go.kr 계정	이메일로 무료 가입 가능
기상청 API 키 (인증키)	이 글의 단계 1~3에서 발급
Claude Desktop	Anthropic 공식 사이트에서 무료 다운로드
Node.js 18 이상	npx 명령 실행에 필요
인터넷 연결	API 호출 및 패키지 설치용

Node.js가 설치되어 있는지 확인하려면 터미널에서 아래 명령을 실행하세요.

node --version

v18.0.0 이상이 출력되면 준비 완료입니다.

단계 1 — data.go.kr 회원가입 및 로그인

공공데이터포털에 접속해 우상단 회원가입 버튼을 클릭합니다. 개인·기업·기관 중 해당 유형을 선택하고 이메일 인증을 완료하면 됩니다. 이미 계정이 있다면 로그인만 진행하세요.

단계 2 — 기상청 단기예보 API 활용 신청

포털 상단 검색창에 “단기예보” 를 입력합니다.
검색 결과 상단의 오픈API 탭을 클릭합니다.
“기상청 단기예보 조회서비스” 카드를 클릭해 상세 페이지로 이동합니다.
상세 페이지의 활용신청 버튼을 클릭합니다.
활용 목적란에 간단히 내용을 입력합니다(예: “AI 개인 비서 연동 및 학습 목적”).
신청을 완료하면 승인 결과가 이메일로 전송됩니다.

기상청 단기예보 API는 대부분 즉시 또는 수 시간 내 자동 승인됩니다. 승인 전에는 인증키가 활성화되지 않으니 이메일을 먼저 확인하세요.

공식 API 안내 페이지는 data.go.kr 기상청 단기예보 API에서 확인할 수 있습니다.

단계 3 — 인증키 확인 및 복사

승인이 완료되면 마이페이지에서 인증키를 확인합니다.

포털 상단 마이페이지를 클릭합니다.
좌측 메뉴에서 오픈API → 개발계정을 선택합니다.
신청한 API 목록에서 “기상청 단기예보 조회서비스”를 찾습니다.
일반 인증키(Decoding) 또는 일반 인증키(Encoding) 중 하나를 복사합니다.

두 가지 인증키 형태의 차이는 다음과 같습니다.

인증키 유형	설명	MCP 서버 사용
일반 인증키 (Decoding)	URL 디코딩된 형태 (`+`, `=`, `/` 포함)	대부분 권장
일반 인증키 (Encoding)	URL 인코딩된 형태 (`%2B`, `%3D` 등)	서버 설정에 따라 다름

일반적으로 Decoding 키를 사용하는 것이 안전합니다. 오류가 발생하면 Encoding 키로 교체해 보세요.

단계 4 — 한국 기상청 날씨 MCP 서버 설치

한국 기상청 날씨 MCP 서버(GitHub: ohhan777/korea_weather)는 기상청 단기예보 API를 MCP 인터페이스로 래핑한 서버입니다.

터미널에서 아래 명령을 실행하면 Smithery CLI가 서버를 자동으로 설치하고 Claude Desktop 설정 파일에 등록해 줍니다.

npx -y @smithery/cli mcp add ohhan777/korea_weather --client claude

명령 실행 중 API 키 입력을 요청받으면, 단계 3에서 복사한 인증키를 붙여넣기합니다.

수동 설치를 선호하는 경우

Smithery CLI를 사용하지 않고 직접 설정 파일을 편집하고 싶다면 아래 섹션으로 이동하세요.

단계 5 — Claude Desktop 설정 파일 직접 편집 (수동 방식)

Smithery CLI로 이미 설치했다면 이 단계는 건너뛰어도 됩니다. 수동으로 설정하거나 키를 변경하고 싶을 때 참고하세요.

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

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

파일을 텍스트 편집기로 열고 아래와 같이 mcpServers 섹션을 추가하거나 수정합니다.

{
  "mcpServers": {
    "korea-weather": {
      "command": "npx",
      "args": ["-y", "@smithery/cli", "run", "ohhan777/korea_weather"],
      "env": {
        "KMA_API_KEY": "여기에_발급받은_기상청_인증키_입력"
      }
    }
  }
}

주의: 환경 변수명은 MCP 서버 구현에 따라 달라질 수 있습니다. 정확한 환경 변수명은 GitHub 저장소의 README를 확인하세요. 서버가 요구하는 키 이름을 그대로 사용해야 합니다.

단계 6 — Claude Desktop 재시작 및 연결 테스트

설정 파일 저장 후 Claude Desktop을 완전히 종료하고 다시 시작합니다. 채팅 입력창 옆에 MCP 도구 아이콘(플러그 모양)이 나타나면 서버가 정상 연결된 것입니다.

아래와 같은 질문으로 동작을 확인해 보세요.

오늘 서울 날씨 알려줘

내일 부산 강수확률은 얼마야?

이번 주말 제주도 날씨 예보를 알려줘

기상청 단기예보 API를 기반으로 현재 날씨·강수확률·기온 등의 정보가 정리된 형태로 답변이 오면 설정이 완료된 것입니다.

흔한 오류와 해결 방법

오류 증상	원인	해결 방법
MCP 도구 아이콘이 보이지 않음	JSON 문법 오류 또는 설정 저장 누락	JSON 유효성 검사 후 재시작
”API 키가 유효하지 않습니다” 오류	인증키 미승인 또는 오타	마이페이지에서 키 재확인, 승인 이메일 확인
npx 명령을 찾을 수 없음	Node.js 미설치	Node.js 공식 사이트에서 LTS 버전 설치
날씨 데이터가 “null” 또는 빈 값	Encoding/Decoding 키 형태 불일치	인증키를 Decoding 형태로 교체
호출 횟수 초과 오류	API 트래픽 쿼터 소진	포털 마이페이지에서 트래픽 증량 신청

JSON 문법 빠른 확인법

설정 파일 저장 전에 아래 서비스에 JSON을 붙여넣어 문법 오류를 미리 확인할 수 있습니다.

https://jsonlint.com

기상청 단기예보 API 주요 데이터 항목

이 MCP 서버를 통해 조회할 수 있는 주요 날씨 데이터 항목은 다음과 같습니다.

데이터 항목	설명	단위
TMP	1시간 기온	섭씨(°C)
SKY	하늘 상태	1(맑음)/3(구름많음)/4(흐림)
POP	강수확률	%
PTY	강수형태	0(없음)/1(비)/2(비·눈)/3(눈)
REH	습도	%
WSD	풍속	m/s

기상청 단기예보 API는 최대 3일(72시간) 이내의 날씨를 1~3시간 간격으로 제공합니다.

자주 묻는 질문

기상청 API 키는 무료인가요?

네, data.go.kr의 기상청 단기예보 조회서비스 API는 무료로 제공됩니다. 단, 하루 호출 횟수 제한(기본 트래픽 쿼터)이 있으며, 더 많은 호출이 필요하면 활용 신청 시 트래픽 증량을 요청할 수 있습니다.

API 키 승인까지 얼마나 걸리나요?

기상청 단기예보 API는 신청 후 즉시 또는 1~~2시간 이내에 자동 승인되는 경우가 대부분입니다. 드물게 담당자 확인이 필요한 경우 최대 1~~2 영업일이 소요될 수 있습니다.

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

macOS는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows는 %APPDATA%\Claude\claude_desktop_config.json에 위치합니다. 파일이 없으면 직접 생성하면 됩니다.

단기예보와 중기예보의 차이는 무엇인가요?

단기예보는 3일(72시간) 이내의 시간별·일별 날씨를 제공하고, 중기예보는 3~10일 후의 날씨 전망을 제공합니다. 한국 기상청 날씨 MCP 서버는 단기예보 API를 기본으로 사용합니다.

MCP 서버가 연결되지 않으면 어떻게 하나요?

먼저 JSON 문법 오류 여부를 확인하세요. 다음으로 API 키 승인 상태를 마이페이지에서 재확인하고, Claude Desktop을 완전히 종료 후 재시작해 보세요. npx 명령이 없다면 Node.js 설치 여부를 점검하세요.

다른 MCP 클라이언트에서도 사용할 수 있나요?

네, MCP 프로토콜을 지원하는 Cursor, Continue 등 다른 AI 개발 도구에서도 동일한 방식으로 설정할 수 있습니다. 설정 파일 위치와 형식은 각 도구의 공식 문서를 참고하세요.

다음 단계

기상청 API 키 설정과 MCP 서버 연결이 완료되었다면, 이제 Claude Desktop에서 한국 날씨 데이터를 마음껏 활용해 보세요.

한국 기상청 날씨 MCP 서버 — 서버 상세 정보 및 고급 설정 확인
날씨 카테고리 전체 보기 — 더 많은 날씨 관련 MCP 서버 목록
전체 가이드 목록 — 다른 MCP 설정 방법 가이드
전체 MCP 서버 디렉토리 — 분야별 MCP 서버 탐색

직접 개발한 날씨 관련 MCP 서버가 있다면 등록 신청을 통해 MCP모아에 등록해 주세요. 한국 개발자 커뮤니티와 함께 더 풍부한 MCP 생태계를 만들어 가겠습니다.