한국어 맞춤법 검사 MCP 설치·사용법 — 네이버 맞춤법 검사기를 활용해 한국어 텍스트

Q: Cursor에서는 어떻게 설정하나요?

Cursor의 MCP 설정 메뉴(설정 → MCP)에서 새 서버를 추가하고 command에 npx, args에 ["-y", "@winterjung/mcp-korean-spell"]를 입력하면 됩니다.

Q: mcp-korean-spell 외에 함께 쓰기 좋은 한국어 MCP 서버가 있나요?

네이버 계열 서비스를 더 활용하고 싶다면 네이버 검색과 구글 검색을 병렬로 처리하는 에이전트웹서치 MCP도 함께 살펴보세요.

네이버 맞춤법 검사기를 Claude·Cursor에 직접 연결하고 싶다면 mcp-korean-spell MCP가 가장 빠른 해답입니다. API 키 없이 npx 한 줄로 설치할 수 있고, 설정 파일 한 곳만 수정하면 Claude가 한국어 텍스트의 철자·문법 오류를 자동으로 잡아 줍니다. 이 가이드는 설치부터 실제 교정 요청까지 전 과정을 단계별로 안내합니다.

왜 Claude에 맞춤법 검사 MCP가 필요한가요?

Claude는 기본적으로 한국어 문장을 잘 이해하지만, 교정 기준이 일관되지 않을 수 있습니다. 반면 네이버 맞춤법 검사기는 국립국어원 기준을 반영한 한국어 전용 교정 엔진으로, 오탈자·띄어쓰기·어미 오류를 규칙 기반으로 정밀하게 잡아냅니다.

mcp-korean-spell은 이 두 가지를 연결하는 다리 역할을 합니다. Claude가 문장을 받아서 네이버 맞춤법 API에 전달하고, 교정 결과를 다시 대화창에 돌려주는 구조입니다.

사용자 (Claude 채팅창)
       │  "다음 문장 맞춤법 검사해 줘"
       ▼
Claude Desktop / Cursor
       │  MCP 프로토콜
       ▼
mcp-korean-spell MCP 서버 (로컬 프로세스)
       │  HTTP 요청
       ▼
네이버 맞춤법 검사기 (외부 API)
       │  교정 결과 반환
       ▼
Claude → 사용자에게 교정 내용 출력

API 키가 필요 없다는 점도 큰 장점입니다. 별도 계정이나 비용 없이 즉시 사용할 수 있어 개인 블로거, 기술 문서 작성자, 이메일을 많이 쓰는 직장인 모두에게 실용적입니다.

준비물

항목	버전 / 조건	확인 명령
Node.js	18 이상 권장	`node -v`
npm / npx	Node.js와 함께 설치됨	`npx -v`
Claude Desktop	최신 버전	앱 메뉴 → 버전 확인

Claude Desktop 대신 Cursor를 사용한다면 Cursor 최신 버전이 설치돼 있으면 충분합니다. 별도로 설치해야 할 전역 패키지는 없습니다.

단계별 설치 방법

1단계: 서버 동작 미리 확인

설정 파일을 수정하기 전에 터미널에서 서버가 제대로 실행되는지 확인합니다.

npx -y @winterjung/mcp-korean-spell

처음 실행 시 패키지를 자동으로 내려받습니다. 오류 없이 프로세스가 시작되면 Ctrl+C로 종료하고 다음 단계로 진행합니다.

2단계: Claude Desktop 설정 파일 열기

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

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

파일이 없으면 해당 경로에 새로 생성합니다. macOS 터미널에서 빠르게 열려면 아래 명령을 사용하세요.

open -e ~/Library/Application\ Support/Claude/claude_desktop_config.json

3단계: mcpServers 항목 추가

기존 설정 파일 내용을 유지하면서 mcpServers 블록 안에 아래 내용을 추가합니다.

{
  "mcpServers": {
    "korean-spell": {
      "command": "npx",
      "args": ["-y", "@winterjung/mcp-korean-spell"]
    }
  }
}

설정 파일 전체가 아직 없는 경우에는 위 내용 자체가 파일의 전체 내용이 됩니다. JSON 형식이 깨지지 않도록 저장 전에 한 번 더 확인하세요.

4단계: Claude Desktop 재시작

파일을 저장한 뒤 Claude Desktop을 완전히 종료합니다. macOS에서는 메뉴 바에서 Quit Claude를 선택하거나 Cmd+Q를 사용합니다. 이후 다시 실행하면 MCP 서버가 자동으로 로드됩니다.

Claude Desktop 하단 또는 입력창 근처에 MCP 서버 아이콘이 표시되면 연결이 성공한 것입니다.

5단계: 맞춤법 검사 기능 사용

Claude 채팅창에서 교정이 필요한 텍스트와 함께 요청을 보냅니다.

다음 문장의 맞춤법을 검사해 줘:
"어제 친구와 카페에서 맛있는 케잌을 먹었어요. 날씨도 맑어서 기분이 너무 좋았습니다."

Claude가 mcp-korean-spell 도구를 호출해 네이버 맞춤법 검사기의 결과를 받아온 뒤, 교정 내용과 원인을 함께 설명해 줍니다.

Cursor에서 설정하는 방법

Cursor를 사용한다면 별도의 JSON 파일을 직접 편집하지 않아도 됩니다.

Cursor 메뉴에서 설정(Settings) → MCP로 이동합니다.
Add new MCP server 버튼을 클릭합니다.
아래와 같이 입력합니다.

{
  "name": "korean-spell",
  "command": "npx",
  "args": ["-y", "@winterjung/mcp-korean-spell"]
}

저장 후 Cursor를 재시작하면 에디터 내 AI 기능에서 한국어 맞춤법 검사를 바로 사용할 수 있습니다.

흔한 오류와 해결 방법

”command not found: npx” 오류

Node.js가 설치되지 않았거나 PATH에 등록되지 않은 경우입니다. nodejs.org에서 LTS 버전을 설치한 뒤 터미널을 재시작하세요.

MCP 서버가 목록에 나타나지 않는 경우

JSON 파일의 문법(따옴표, 쉼표, 괄호)이 정확한지 확인합니다.
Claude Desktop을 완전히 종료(트레이 아이콘까지) 후 다시 실행합니다.
설정 파일 경로가 정확한지 재확인합니다.

교정 결과가 반환되지 않는 경우

네이버 맞춤법 검사기에 접근하는 네트워크 요청이 실패했을 수 있습니다. 인터넷 연결 상태를 확인하고, 회사 방화벽 환경이라면 네트워크 관리자에게 외부 요청 허용 여부를 확인하세요.

서버	설명	링크
한국어 맞춤법 검사 MCP	이 가이드에서 다룬 서버	GitHub
네이웍스 MCP 서버	LINE WORKS 메시지·캘린더·드라이브 연동	GitHub
에이전트웹서치 MCP	네이버·구글 병렬 검색 (API 키 불필요)	GitHub

자주 묻는 질문

mcp-korean-spell MCP를 쓰려면 API 키가 필요한가요?

아닙니다. mcp-korean-spell은 별도 API 키 없이 사용할 수 있습니다. 네이버 맞춤법 검사기를 내부적으로 활용하지만, 별도 계정 가입이나 키 발급 절차가 없습니다.

Windows에서도 설치할 수 있나요?

Node.js와 npx가 설치된 환경이라면 Windows에서도 동일한 npx 명령으로 실행할 수 있습니다. Claude Desktop 설정 파일 경로는 %APPDATA%\Claude\claude_desktop_config.json입니다.

Cursor에서는 어떻게 설정하나요?

Cursor의 MCP 설정 메뉴(설정 → MCP)에서 새 서버를 추가하고 command에 npx, args에 ["-y", "@winterjung/mcp-korean-spell"]를 입력하면 됩니다.

한 번에 검사할 수 있는 텍스트 길이에 제한이 있나요?

네이버 맞춤법 검사기 자체의 처리 한도가 있어 매우 긴 텍스트는 나눠서 요청하는 것이 좋습니다. 정확한 한도는 공식 저장소를 참고하세요.

맞춤법 교정 결과가 틀리거나 이상할 때는 어떻게 하나요?

네이버 맞춤법 검사기의 판단을 그대로 반환하므로, 결과가 맞지 않는다고 느껴지면 맥락을 추가해 Claude에게 재검토를 요청하거나 해당 문장만 따로 다시 검사해 보세요.

mcp-korean-spell 외에 함께 쓰기 좋은 한국어 MCP 서버가 있나요?

네이버 검색과 구글 검색을 병렬로 처리하는 에이전트웹서치 MCP도 함께 살펴보세요. 한국어 콘텐츠를 리서치하면서 동시에 맞춤법도 교정하는 워크플로를 구성할 수 있습니다.

다음 단계

mcp-korean-spell이 잘 동작한다면, 더 많은 한국어 MCP 서버를 탐색해 업무 자동화를 확장해 보세요.

전체 MCP 서버 목록 보기 — 카테고리별로 정리된 한국산 MCP 서버
카카오·네이버 카테고리 — 네이버·카카오 API 연동 서버 모음
가이드 전체 목록 — 설치·설정 튜토리얼 아카이브