네이버 검색 API Claude 연동 — MCP 서버로 한국어 검색 결과 불러오기

Q: Claude Desktop 외에 Cursor나 VS Code에서도 네이버 MCP를 쓸 수 있나요?

네, MCP 표준을 지원하는 클라이언트라면 모두 사용할 수 있습니다. Cursor의 경우 .cursor/mcp.json 파일에 동일한 형식으로 서버를 등록하면 됩니다.

네이버 검색 API를 Claude AI와 직접 연결하면, 대화 중에 Claude가 스스로 한국어 실시간 검색을 수행하고 결과를 요약해 줍니다. MCP(Model Context Protocol) 서버를 중간에 두면 별도의 스크립트 없이 Claude Desktop이나 Cursor에서 바로 네이버 검색을 활용할 수 있습니다. 이 글에서는 API 키 발급부터 설정 파일 등록까지 모든 단계를 구체적으로 안내합니다.

왜 네이버 검색 API를 Claude에 연결해야 하나요?

Claude는 학습 데이터의 컷오프(지식 마감 시점) 이후 정보를 모릅니다. 하지만 MCP 서버로 네이버 검색 API를 연결하면 Claude가 대화 도중 실시간으로 한국 뉴스, 블로그, 웹문서를 검색해 최신 정보를 답변에 반영할 수 있습니다. 특히 한국 시장 동향, 국내 법령 변경, K-뷰티·K-팝 트렌드처럼 한국어 특화 정보가 필요한 업무에서 효과가 큽니다.

사용자 질문
    │
    ▼
Claude (MCP 클라이언트)
    │  MCP 프로토콜 (JSON-RPC)
    ▼
네이버 검색 MCP 서버
    │  HTTPS
    ▼
네이버 검색 API (developers.naver.com)
    │
    ▼
뉴스·블로그·웹문서 검색 결과
    │
    ▼
Claude가 결과를 요약·분석 → 사용자에게 답변

준비물 확인

시작 전에 아래 항목이 준비됐는지 확인하세요.

항목	필요 여부	비고
네이버 계정	필수	developers.naver.com 로그인용
네이버 API 키 (Client ID / Secret)	API 방식 사용 시 필수	하루 25,000건 무료
Node.js 18 이상	필수	MCP 서버 실행 환경
Claude Desktop 또는 Cursor	필수	MCP 클라이언트
Git	필수	서버 저장소 클론용

단계별 연동 방법

1단계: 네이버 개발자센터에서 앱 등록 및 API 키 발급

developers.naver.com에 로그인한 뒤 Application → 애플리케이션 등록 메뉴로 이동합니다. 다음 항목을 입력합니다.

애플리케이션 이름: 원하는 이름(예: Claude MCP)
사용 API: 검색 선택 (뉴스, 블로그, 웹문서 등 필요한 항목 체크)
비로그인 오픈 API 서비스 환경: WEB 설정 선택 후 http://localhost 입력

등록 후 Client ID와 Client Secret을 안전한 곳에 보관하세요. 이 두 값이 API 호출의 인증 수단입니다.

2단계: 네이버 검색 MCP 서버 선택

현재 네이버 검색을 지원하는 MCP 서버 중 가장 접근성이 좋은 것은 AgentWebSearch-MCP입니다. 이 서버는 Chrome CDP(Chrome DevTools Protocol)를 이용해 API 키 없이도 네이버·구글·Brave 검색을 병렬로 실행할 수 있습니다. 공식 API 키를 발급받아 안정적으로 운영하려면 별도 커스텀 서버를 구성해야 합니다.

카테고리 내 다른 서버도 카카오·네이버 카테고리에서 확인할 수 있습니다.

3단계: AgentWebSearch-MCP 설치

# 저장소 클론
git clone https://github.com/insung8150/AgentWebSearch-MCP.git
cd AgentWebSearch-MCP

# 의존성 설치
npm install

# 빌드 (package.json에 build 스크립트가 있는 경우)
npm run build

이 서버는 Chrome이 설치된 환경이어야 합니다. Chrome이 없다면 Chromium을 별도로 설치하거나 Puppeteer의 번들 Chromium을 사용할 수 있습니다. 정확한 실행 방법은 공식 저장소의 README를 참고하세요.

4단계: Claude Desktop 설정 파일에 MCP 서버 등록

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

OS	경로
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

설정 파일을 열고 아래와 같이 mcpServers 항목에 서버를 추가합니다.

{
  "mcpServers": {
    "agentwebsearch": {
      "command": "node",
      "args": ["/절대경로/AgentWebSearch-MCP/dist/index.js"],
      "env": {}
    }
  }
}

경로는 3단계에서 클론한 디렉토리의 실제 절대 경로로 변경하세요. 네이버 공식 API 키를 환경 변수로 전달해야 하는 서버라면 env 항목에 아래처럼 추가합니다.

{
  "mcpServers": {
    "naver-search": {
      "command": "node",
      "args": ["/절대경로/서버/index.js"],
      "env": {
        "NAVER_CLIENT_ID": "여기에_Client_ID_입력",
        "NAVER_CLIENT_SECRET": "여기에_Client_Secret_입력"
      }
    }
  }
}

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

설정 파일 저장 후 Claude Desktop을 완전히 종료하고 다시 실행합니다. 채팅 입력창 아래 또는 도구 아이콘에서 MCP 서버가 연결됐음을 나타내는 표시가 보이면 성공입니다.

연동 확인용 테스트 질문 예시입니다.

오늘 네이버에서 "AI MCP" 관련 최신 뉴스를 검색해서 3줄로 요약해줘.

Claude가 검색 도구를 호출하고 결과를 요약해 준다면 연동이 완료된 것입니다.

한국어 관련 MCP 서버 조합 추천

네이버 검색 MCP와 함께 쓰면 시너지가 나는 서버들입니다.

서버	용도	API 키 필요
AgentWebSearch-MCP	네이버·구글 병렬 검색	불필요
한국어 맞춤법 검사 MCP	네이버 맞춤법 검사기 연동	불필요
네이웍스 MCP 서버	LINE WORKS 메시지·캘린더 연동	필요

예를 들어 네이버 검색으로 최신 블로그 글을 가져오고, 맞춤법 검사 MCP로 답변 초안을 다듬는 워크플로를 Claude 안에서 모두 처리할 수 있습니다.

흔한 오류와 해결 방법

오류: “MCP server failed to start”

설정 파일의 command 경로나 args 경로가 잘못됐을 가능성이 높습니다. 터미널에서 직접 동일한 명령을 실행해 에러 메시지를 확인하세요.

node /절대경로/AgentWebSearch-MCP/dist/index.js

오류: Chrome을 찾을 수 없음

AgentWebSearch-MCP가 Chrome 실행 파일을 자동 감지하지 못하는 경우입니다. Chrome이 설치돼 있는지 확인하고, 서버 README의 CHROME_PATH 환경 변수 설정 방법을 참고하세요.

오류: API 호출 실패 (401 Unauthorized)

네이버 API 키가 올바르지 않거나, 설정 파일의 env 변수명이 서버 코드와 다를 수 있습니다. 네이버 개발자센터에서 앱 상태가 서비스 적용 중인지 먼저 확인하세요.

JSON 파싱 오류

claude_desktop_config.json 파일을 수정할 때 쉼표나 따옴표 누락으로 JSON이 깨지기 쉽습니다. jsonlint.com 같은 온라인 검증 도구로 파일을 붙여넣어 구문 오류를 확인하세요.

Cursor에서 네이버 MCP 설정하기

Cursor를 사용하는 경우 프로젝트 루트에 .cursor/mcp.json 파일을 만들고 아래와 같이 작성합니다.

{
  "mcpServers": {
    "agentwebsearch": {
      "command": "node",
      "args": ["/절대경로/AgentWebSearch-MCP/dist/index.js"],
      "env": {}
    }
  }
}

Cursor를 재시작하면 Composer(에이전트 모드)에서 검색 도구를 사용할 수 있습니다.

자주 묻는 질문

네이버 검색 API 키가 없어도 Claude에서 네이버를 검색할 수 있나요?

AgentWebSearch-MCP 서버는 Chrome CDP 방식을 사용하기 때문에 API 키 없이도 네이버 검색이 가능합니다. 다만 공식 API 방식보다 안정성이 낮을 수 있으며, Chrome 실행 환경이 필요합니다.

네이버 검색 API의 무료 호출 한도는 얼마인가요?

네이버 개발자센터 기준으로 검색 API는 하루 25,000건까지 무료로 제공됩니다. 초과 시 유료 전환이 필요하므로 대량 호출 시에는 사용량을 모니터링하세요.

Claude Desktop 외에 Cursor나 VS Code에서도 네이버 MCP를 쓸 수 있나요?

네, MCP 표준을 지원하는 클라이언트라면 모두 사용할 수 있습니다. Cursor의 경우 .cursor/mcp.json 파일에 동일한 형식으로 서버를 등록하면 됩니다. VS Code는 Cline, Continue 등 MCP를 지원하는 확장을 통해 활용할 수 있습니다.

네이버 검색 API로 어떤 콘텐츠를 가져올 수 있나요?

뉴스, 블로그, 웹문서, 카페글, 책, 쇼핑, 이미지, 지식iN 등 다양한 검색 타입을 지원합니다. API 호출 시 query 파라미터와 함께 타입을 지정합니다. 각 타입별 응답 필드는 네이버 개발자센터 API 문서에서 확인하세요.

MCP 서버와 일반 HTTP API 연동의 차이점은 무엇인가요?

MCP 서버를 쓰면 Claude가 직접 API를 호출하는 도구(tool)로 인식해 대화 중 자동으로 필요한 검색을 실행합니다. 반면 일반 HTTP 연동은 별도 코드를 작성해 Claude에 결과를 붙여넣어야 합니다. MCP 방식이 훨씬 자연스럽고 자동화 친화적입니다.

네이버 맞춤법 검사도 MCP로 쓸 수 있나요?

네, mcp-korean-spell 서버를 사용하면 Claude 안에서 네이버 맞춤법 검사기를 API 키 없이 바로 호출할 수 있습니다. 설치 명령은 npx -y @winterjung/mcp-korean-spell입니다.

다음 단계

네이버 검색 MCP 연동이 완료됐다면, 한국어 워크플로를 더욱 풍부하게 만들 수 있는 서버들을 추가로 살펴보세요.

한국어 맞춤법 검사 MCP — 네이버 맞춤법 검사기를 Claude에서 직접 사용
네이웍스 MCP 서버 — LINE WORKS 메시지·캘린더·드라이브를 Claude로 제어
AgentWebSearch-MCP — 네이버·구글·Brave 병렬 검색
전체 서버 목록 보기 — MCP모아에 등록된 모든 MCP 서버 탐색
가이드 더 보기 — MCP 설치·연동 가이드 모음