Cursor에서 한국 MCP 설정하는 법

Cursor와 MCP

Cursor는 AI 기능이 내장된 코드 에디터로, MCP를 정식 지원합니다. 한국 MCP 서버를 연결하면 Cursor의 AI가 공공데이터·법령·금융공시·지도 같은 한국 서비스 데이터를 직접 가져와 작업할 수 있습니다. 설정은 ~/.cursor/mcp.json 파일에 서버를 등록하는 방식으로, Claude Code와 거의 동일한 구조를 사용합니다.

1단계 — mcp.json 만들기

홈 디렉터리에 .cursor 폴더와 mcp.json 파일을 준비합니다. 프로젝트 단위로 적용하려면 프로젝트 루트의 .cursor/mcp.json을 사용할 수도 있지만, 여기서는 모든 프로젝트에 적용되는 전역 설정을 다룹니다.

mkdir -p ~/.cursor
open -e ~/.cursor/mcp.json   # macOS, 없으면 새로 생성됨

2단계 — 서버 등록

mcpServers 키 아래에 연결할 서버를 추가합니다. 아래는 카카오맵 MCP와 네이버 검색 MCP를 함께 붙이는 예시입니다.

{
  "mcpServers": {
    "kakao-map": {
      "command": "npx",
      "args": ["-y", "kakao-map-mcp"],
      "env": { "KAKAO_REST_API_KEY": "여기에_카카오_키" }
    },
    "naver-search": {
      "command": "npx",
      "args": ["-y", "naver-search-mcp"],
      "env": {
        "NAVER_CLIENT_ID": "여기에_네이버_아이디",
        "NAVER_CLIENT_SECRET": "여기에_네이버_시크릿"
      }
    }
  }
}

키가 필요 없는 서버라면 env 블록을 생략하면 됩니다. 정확한 환경 변수 이름은 각 서버의 상세 페이지 설치 탭에서 확인하세요.

3단계 — Cursor에서 활성화

Cursor를 실행하고 Settings → MCP(또는 Cursor Settings → MCP) 메뉴로 이동합니다. 방금 등록한 서버 목록이 나타나면 토글을 켜서 활성화합니다. 상태 표시등이 초록색이면 정상 연결입니다.

4단계 — 동작 확인

채팅(Composer/Chat)에서 “현재 위치 근처 카페 검색해줘”처럼 요청하면, Cursor의 AI가 등록된 MCP 도구를 자동으로 호출합니다. 도구 호출이 표시되고 결과가 답변에 반영되면 연결이 정상입니다.

문제 해결

목록에 안 뜰 때: mcp.json이 유효한 JSON인지 확인하고 Cursor를 완전히 종료 후 재실행하세요.
상태등이 빨간색: API 키 또는 환경 변수명이 틀렸을 가능성이 높습니다. 서버 상세 페이지의 값과 대조하세요.
도구를 안 부를 때: 설정에서 해당 서버가 활성화(토글 ON)되어 있는지 다시 확인하세요.