네이버 뉴스 MCP로 Claude에서 한국 최신 뉴스 실시간 조회하기
네이버 검색 API를 MCP 서버로 연결해 Claude에서 한국 뉴스를 실시간 조회하는 방법. API 키 발급, 환경 변수, claude_desktop_config.json 설정, 401·연결 오류 해결까지.
네이버 검색 API를 MCP 서버로 연결하면 Claude 채팅창에서 “오늘 한국 IT 뉴스 요약해줘”처럼 자연어로 요청하는 것만으로 최신 뉴스를 실시간 조회할 수 있습니다. 필요한 것은 네이버 개발자 센터에서 발급한 API 키 한 쌍과 Claude Desktop 설정 파일 한 줄의 수정뿐입니다. 아래 5단계를 그대로 따라 하면 됩니다.
왜 네이버 뉴스 MCP가 필요한가
Claude는 학습 데이터의 컷오프 이후에 발생한 사건을 알지 못합니다. 그래서 “오늘 주요 기사”, “이번 주 경제 뉴스” 같은 질문에는 기본적으로 답하지 못하거나, 과거 시점의 정보를 최신인 것처럼 답할 위험이 있습니다.
MCP(Model Context Protocol) 서버를 붙이면 Claude가 답변을 생성하는 도중에 외부 API를 직접 호출할 수 있습니다. 네이버 검색 API는 국내 언론사 기사를 한국어 질의로 곧바로 검색하기 때문에, 영어권 검색 도구로 한국 뉴스를 우회 검색할 때보다 결과의 정합성이 높습니다.
동작 흐름은 다음과 같습니다.
[사용자 질문]
↓
[Claude (MCP 클라이언트)]
↓ MCP 프로토콜 (stdio)
[네이버 뉴스 MCP 서버]
↓ HTTPS + Client ID / Secret 헤더 인증
[네이버 검색 API]
↓ JSON 응답 (제목·원문 URL·요약·발행일)
[Claude → 사용자에게 요약 답변]
핵심은 MCP 서버가 API 키 인증과 JSON 파싱을 대신 처리하고, Claude는 그 결과를 받아 요약·정리만 한다는 점입니다.
준비물
| 항목 | 용도 | 비고 |
|---|---|---|
| 네이버 계정 | developers.naver.com 로그인 | 일반 네이버 계정으로 가능 |
| Client ID / Client Secret | 검색 API 인증 키 한 쌍 | 개발자 센터에서 발급 |
| Node.js 18 이상 | npx로 MCP 서버 실행 | node --version으로 확인 |
| Claude Desktop | MCP 클라이언트 | 설정 파일을 직접 편집 |
단계별 설정 방법
1단계 — 네이버 개발자 센터에서 검색 API 키 발급
- developers.naver.com에 접속해 네이버 계정으로 로그인합니다.
- 상단 메뉴에서 Application → 애플리케이션 등록을 클릭합니다.
- 애플리케이션 이름을 입력하고, 사용 API 목록에서 검색을 선택합니다. (뉴스 검색은 별도 API가 아니라 통합 검색 API의 한 종류입니다.)
- 환경 추가에서 로컬 실행에 맞는 항목을 선택하고, 요구되는 경우 서비스 URL로
http://localhost를 입력합니다. - 등록을 완료하면 Client ID와 Client Secret이 발급됩니다. 이 두 값을 안전한 곳에 보관합니다.
네이버 검색 API의 무료 한도는 하루 25,000건입니다. 개인 프로젝트나 학습 용도라면 충분하며, 초과 시 별도 검토가 필요합니다.
2단계 — API 키를 환경 변수로 분리
API 키를 코드나 공유 파일에 직접 넣으면 유출 위험이 큽니다. 환경 변수로 빼두면 키를 노출하지 않고 여러 도구에서 재사용할 수 있습니다.
macOS / Linux
# ~/.zshrc 또는 ~/.bashrc에 추가
export NAVER_CLIENT_ID="여기에_발급받은_Client_ID"
export NAVER_CLIENT_SECRET="여기에_발급받은_Client_Secret"
# 변경 사항 즉시 적용
source ~/.zshrc
Windows (PowerShell)
[System.Environment]::SetEnvironmentVariable("NAVER_CLIENT_ID", "여기에_Client_ID", "User")
[System.Environment]::SetEnvironmentVariable("NAVER_CLIENT_SECRET", "여기에_Client_Secret", "User")
설정 후 새 터미널을 열어 echo $NAVER_CLIENT_ID(Windows는 echo $env:NAVER_CLIENT_ID)로 값이 출력되는지 확인합니다. 기존 터미널에는 변경이 반영되지 않습니다.
3단계 — Claude Desktop 설정 파일에 MCP 서버 등록
설정 파일 위치는 운영체제마다 다릅니다.
| 운영체제 | 설정 파일 경로 |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
파일을 텍스트 편집기로 열어 mcpServers 항목을 추가합니다. 파일이 없으면 새로 만들어도 됩니다.
{
"mcpServers": {
"naver-news": {
"command": "npx",
"args": ["-y", "naver-news-mcp"],
"env": {
"NAVER_CLIENT_ID": "여기에_Client_ID",
"NAVER_CLIENT_SECRET": "여기에_Client_Secret"
}
}
}
}
패키지 이름 확인:
args에 들어가는 실행 패키지 이름은 사용하는 네이버 뉴스 MCP 서버 구현에 따라 다릅니다. 위 예시의naver-news-mcp는 그대로 두기 전에 해당 서버의 README나 MCP모아 서버 목록에서 정확한 명령과 패키지명을 확인해 맞춰 주세요. Python 기반 서버라면command가uvx가 될 수도 있습니다.
env블록을 생략해도 될까? 2단계에서 시스템 환경 변수를 설정했더라도, Claude Desktop은 셸과 다른 환경에서 프로세스를 띄우는 경우가 많아 변수를 못 읽을 수 있습니다. 가장 확실한 방법은 위처럼env블록에 값을 명시하는 것입니다.
4단계 — Claude Desktop 완전 재시작
설정을 저장한 뒤 Claude Desktop을 완전히 종료합니다. 창만 닫으면 설정이 다시 읽히지 않습니다.
- macOS: 메뉴 막대 또는 Dock에서 Quit (Cmd+Q)
- Windows: 트레이 아이콘 우클릭 후 종료
그런 다음 다시 실행합니다.
5단계 — 동작 확인
채팅창에 아래처럼 입력합니다.
오늘 한국 IT 뉴스 상위 5개를 요약해줘.
Claude가 도구 사용을 거쳐 실시간 뉴스 목록을 가져와 요약하면 설정이 완료된 것입니다. 입력창 근처의 MCP 도구 아이콘(망치 모양)에 naver-news 서버가 목록으로 나타나는지도 확인하세요.
연결 후 활용 예시
MCP가 연결되면 검색·요약·분류를 한 번의 자연어 요청으로 묶을 수 있습니다.
| 예시 프롬프트 | 활용 시나리오 |
|---|---|
| ”오늘 코스피 관련 뉴스 5건 요약해줘” | 투자 리서치 |
| ”이번 주 AI 스타트업 관련 한국 뉴스 정리해줘” | 트렌드 모니터링 |
| ”삼성전자 최신 뉴스를 3줄로 요약해줘” | 기업 동향 파악 |
| ”최근 보도된 기사 제목들의 논조를 분류해줘” | 미디어 모니터링 |
네이버 검색 API는 본문 전체가 아니라 제목·요약(description)·원문 URL·발행일 등의 메타데이터를 돌려줍니다. 전체 본문이 필요하면 Claude에게 결과의 원문 링크를 따라가게 하거나, 별도 본문 수집 도구와 조합해야 합니다.
흔한 오류와 해결 방법
”Authentication failed” 또는 401 에러
인증 키가 잘못 전달된 경우입니다.
claude_desktop_config.json의env블록에서 Client ID와 Secret에 오타·앞뒤 공백이 없는지 확인합니다.- 네이버 개발자 센터에서 해당 애플리케이션이 검색 API를 사용하도록 등록되어 있는지 확인합니다. API 종류가 누락되면 키가 있어도 거부됩니다.
MCP 서버가 도구 목록에 나타나지 않음
- JSON 문법 오류를 먼저 의심합니다. 콤마 누락·따옴표 짝이 흔한 원인이며, jsonlint.com에 붙여넣어 유효성을 검사할 수 있습니다.
- 설정 파일 경로가 정확한지 확인합니다. 특히 macOS의
Application Support폴더명을 정확히 맞춰야 합니다. - 창을 닫는 것만으로는 부족합니다. 4단계의 완전 종료 후 재시작을 다시 수행합니다.
”npx: command not found”
Node.js가 설치되지 않았거나 PATH에 없는 경우입니다.
node --version # 버전 확인 (18 이상 권장)
which npx # npx 경로 확인
Node.js가 없으면 nodejs.org에서 LTS 버전을 설치한 뒤 터미널과 Claude Desktop을 모두 다시 시작합니다.
키는 맞는데 결과가 비어 있음
API 키와 연결은 정상이나 응답이 없다면, 우선 MCP 서버를 터미널에서 직접 실행해 응답을 확인하는 것이 빠릅니다. 그래도 원인이 잡히지 않으면 Claude Desktop의 개발자 도구(macOS Cmd+Option+I, Windows Ctrl+Shift+I) 콘솔에서 오류 로그를 확인합니다.
함께 쓰면 좋은 네이버 계열 MCP 서버
- 한국어 맞춤법 검사 MCP — 뉴스 요약문의 맞춤법·문법을 자동 교정할 때 유용합니다. 네이버 맞춤법 검사기를 API 키 없이 사용할 수 있습니다.
- 네이웍스 MCP 서버 — LINE WORKS / NAVER WORKS 기반 팀에서 뉴스 모니터링 결과를 메시지·캘린더로 공유할 때 활용합니다.
- 에이전트웹서치 MCP — API 키 없이 Chrome CDP로 네이버·구글·Brave를 병렬 검색합니다. 검색 API 한도가 부족하거나 키 발급 없이 빠르게 검증하고 싶을 때 보조 수단으로 검토할 수 있습니다. 단, 브라우저 자동화 검색은 스크래핑에 해당하므로 대상 서비스 이용약관을 사전에 확인하세요.
카카오·네이버 카테고리에서 더 많은 한국형 MCP 서버를 확인하거나, 전체 MCP 서버 목록을 둘러보세요.
자주 묻는 질문
네이버 검색 API는 무료인가요?
기본적으로 무료입니다. 네이버 개발자 센터(developers.naver.com)에 애플리케이션을 등록하면 키를 발급받을 수 있고, 하루 25,000건의 호출 한도가 무료로 제공됩니다. 초과 시 별도 검토가 필요합니다.
Claude Desktop 외에 Cursor나 VS Code에서도 쓸 수 있나요?
MCP를 지원하는 클라이언트라면 동일한 서버 블록을 그대로 재사용할 수 있습니다. Cursor는 .cursor/mcp.json, Claude Code는 프로젝트 루트의 .mcp.json에 같은 형식으로 등록합니다.
네이버 뉴스 API로 어떤 정보를 가져올 수 있나요?
뉴스 제목, 원문 URL, 요약(description), 발행일 등의 메타데이터를 가져옵니다. 본문 전체가 아닌 스니펫이 제공되므로, 전체 본문이 필요하면 원문 링크로 직접 접근하거나 별도 본문 수집 도구와 조합해야 합니다.
API 키 없이 네이버 뉴스를 검색하는 방법이 있나요?
API 키 없이 Chrome CDP로 네이버를 검색하는 에이전트웹서치 MCP를 활용할 수 있습니다. 다만 이 방식은 스크래핑에 해당하므로 네이버 이용약관을 사전에 확인하시기 바랍니다.
환경 변수 설정이 적용되지 않으면?
macOS/Linux는 ~/.zshrc 또는 ~/.bashrc에 export 구문을 추가한 뒤 source로 적용하고, 새 터미널에서 확인합니다. Windows는 시스템 환경 변수 설정에서 추가합니다. 그래도 인식되지 않으면 Claude Desktop을 완전히 종료한 뒤 다시 시작하세요. 가장 확실한 방법은 설정 파일의 env 블록에 값을 직접 명시하는 것입니다.
연결 후에도 Claude가 뉴스를 못 불러오면?
먼저 claude_desktop_config.json의 JSON 문법을 점검합니다. 다음으로 환경 변수 이름과 Client ID·Secret 값이 정확한지 확인합니다. 그래도 안 되면 개발자 도구(macOS Cmd+Option+I, Windows Ctrl+Shift+I) 콘솔에서 오류 메시지를 직접 확인하는 것이 가장 빠릅니다.
다음 단계
- 가이드 전체 목록 보기 — 다른 한국 API MCP 연동 방법을 확인합니다.
- 한국어 워크플로 구성 — 한국어 맞춤법 검사 MCP와 조합해 뉴스 수집부터 요약·교정까지 자동화합니다.
- 더 많은 서버 탐색 — 카카오·네이버 카테고리에서 국내 서비스 연동 서버를 찾아보세요.