본문 바로가기
M MCP모아
가이드 · 2026.11.17 업데이트

MCP 서버 설정 파일 위치 총정리 — Cursor·VS Code·Cline별 경로 한눈에

MCP 서버 설정 파일 위치를 에디터별로 한눈에 정리했습니다. Cursor mcp.json 경로, VS Code MCP 설정, Cline, Claude Desktop까지 OS별 정확한 경로와 설정 예시를 제공합니다.

Cursor, VS Code, Cline, Claude Desktop 에디터별 MCP 서버 설정 파일 경로를 비교하는 표지 이미지

MCP 서버를 설치한 뒤 가장 먼저 막히는 지점은 설정 파일을 어디에, 어떤 형식으로 작성해야 하는지 모르는 것입니다. Cursor는 mcp.json을, Claude Desktop은 claude_desktop_config.json을, VS Code는 settings.json 또는 .vscode/mcp.json을 사용하며, 경로가 OS마다 다릅니다. 이 글에서는 주요 에디터·클라이언트별 MCP 설정 파일의 정확한 위치와 최소 설정 예시를 한곳에 정리합니다.

MCP 설정 파일이 왜 에디터마다 다른가

Model Context Protocol(MCP)은 AI 클라이언트가 외부 도구 서버를 표준화된 방식으로 호출하는 개방형 규격입니다. 그러나 설정 파일의 위치와 구조는 각 클라이언트가 독립적으로 구현하므로, 에디터마다 경로와 키 이름이 조금씩 다릅니다.

사용자 (AI 클라이언트)
    │
    ▼
설정 파일 (claude_desktop_config.json / mcp.json / settings.json)
    │   ← 이 파일 위치를 파악하는 것이 이 글의 목표
    ▼
MCP 서버 프로세스 (npx / uvx / 로컬 실행)
    │
    ▼
외부 도구·API (파일 시스템, DB, 웹 서비스 등)

설정 파일을 잘못된 위치에 저장하거나 키 이름을 틀리면 서버가 조용히 무시됩니다. 에러 메시지도 없는 경우가 많아 원인을 찾기 어렵습니다. 아래 표를 기준으로 삼으면 이런 문제를 방지할 수 있습니다.

에디터·클라이언트별 MCP 설정 파일 위치 한눈에

클라이언트설정 파일명macOS 경로Windows 경로
Claude Desktopclaude_desktop_config.json~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json
Cursor (전역)mcp.json~/.cursor/mcp.json%USERPROFILE%\.cursor\mcp.json
Cursor (프로젝트)mcp.json프로젝트루트/.cursor/mcp.json프로젝트루트\.cursor\mcp.json
VS Codesettings.json~/Library/Application Support/Code/User/settings.json%APPDATA%\Code\User\settings.json
VS Code (워크스페이스)mcp.json프로젝트루트/.vscode/mcp.json프로젝트루트\.vscode\mcp.json
Cline (VS Code 확장)cline_mcp_settings.json~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

Cursor 우선순위: 프로젝트 범위(.cursor/mcp.json)가 전역(~/.cursor/mcp.json)보다 우선 적용됩니다. 팀 프로젝트에서는 프로젝트 범위를 사용하고 .gitignore에 추가하거나, API 키 없이 서버 목록만 커밋하는 방식을 권장합니다.

Claude Desktop 설정 방법

Claude Desktop은 가장 많이 사용되는 MCP 클라이언트입니다. 설정 파일을 직접 편집해야 합니다.

macOS에서 파일 열기

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

파일이 없으면 Claude Desktop을 한 번 실행한 뒤 다시 시도하세요. 애플리케이션이 첫 실행 시 빈 파일을 생성합니다.

기본 구조

{
  "mcpServers": {
    "서버이름": {
      "command": "npx",
      "args": ["-y", "패키지명"],
      "env": {
        "API_KEY": "여기에_키_입력"
      }
    }
  }
}

mcpServers 아래에 원하는 서버를 여러 개 추가할 수 있습니다. 서버 이름(키)은 Claude 대화창의 도구 목록에 표시되는 레이블입니다.

설정 파일 수정 후 재시작

설정을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 실행해야 합니다. macOS에서는 Dock 아이콘을 우클릭 → 종료, 또는 Cmd+Q로 완전 종료합니다. 단순 창 닫기로는 백그라운드 프로세스가 유지되어 변경 사항이 반영되지 않습니다.

Cursor mcp.json 설정 방법

Cursor는 AI 코드 에디터 중 MCP 지원이 가장 성숙한 편입니다. 전역 설정과 프로젝트별 설정을 분리할 수 있습니다.

전역 설정 (모든 프로젝트에 적용)

~/.cursor/mcp.json 파일이 없다면 직접 생성합니다.

mkdir -p ~/.cursor
touch ~/.cursor/mcp.json

기본 구조는 Claude Desktop과 동일합니다.

{
  "mcpServers": {
    "서버이름": {
      "command": "npx",
      "args": ["-y", "패키지명"]
    }
  }
}

프로젝트별 설정

프로젝트 루트에 .cursor/mcp.json을 생성합니다. 이 파일은 해당 프로젝트 작업 시에만 MCP 서버를 활성화합니다. API 키처럼 민감한 정보가 담긴 경우 .gitignore에 .cursor/mcp.json을 추가하는 것을 권장합니다.

Cursor에서 MCP 연결 확인

Cursor 설정(Cmd+,) → Cursor Settings → MCP 탭에서 등록된 서버 목록과 연결 상태를 확인할 수 있습니다. 초록 점이 표시되면 서버가 정상 실행 중입니다.

VS Code MCP 설정 방법

VS Code는 버전 1.99(2025년 4월)부터 MCP를 공식 지원하기 시작했습니다. GitHub Copilot Chat과 통합되어 동작합니다.

settings.json에 추가하는 방법

사용자 전역 settings.json(Cmd+Shift+P → “Open User Settings JSON”)에 다음 키를 추가합니다.

{
  "mcp": {
    "servers": {
      "서버이름": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "패키지명"]
      }
    }
  }
}

VS Code의 설정 구조는 Claude Desktop·Cursor와 약간 다릅니다. mcpServers 대신 mcp.servers를 사용하고, type: "stdio"를 명시해야 합니다.

워크스페이스 mcp.json 사용

프로젝트 루트에 .vscode/mcp.json을 생성하면 해당 워크스페이스에서만 서버를 활성화할 수 있습니다.

{
  "servers": {
    "서버이름": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "패키지명"]
    }
  }
}

워크스페이스 설정 파일에서는 mcp 래퍼 없이 바로 servers 키를 최상위에 작성합니다.

Cline 설정 방법

Cline은 VS Code 확장 프로그램으로, 자체 MCP 설정 파일을 별도 경로에 관리합니다. GUI와 파일 직접 편집 두 가지 방법을 모두 지원합니다.

GUI로 서버 추가

  1. VS Code 사이드바에서 Cline 아이콘 클릭
  2. 상단 MCP Servers 탭 선택
  3. Add Server 버튼으로 서버 정보 입력

파일 직접 편집

macOS 기준 파일 경로:

~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

파일 구조는 Claude Desktop과 동일한 mcpServers 형식을 사용합니다.

{
  "mcpServers": {
    "서버이름": {
      "command": "npx",
      "args": ["-y", "패키지명"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

disabled와 autoApprove 필드는 Cline 전용 확장 기능입니다. autoApprove에 도구 이름을 추가하면 해당 도구 실행 시 확인 없이 자동 승인됩니다.

흔한 오류와 해결 방법

서버가 도구 목록에 나타나지 않음

가장 흔한 원인은 JSON 문법 오류입니다. 특히 마지막 항목 뒤 불필요한 쉼표(trailing comma)는 표준 JSON에서 허용되지 않습니다.

{
  "mcpServers": {
    "server-a": { ... },
    "server-b": { ... }   ← 마지막 항목에 쉼표 없어야 함
  }
}

해결: 터미널에서 cat 파일경로 | python3 -m json.tool 명령으로 JSON 유효성을 빠르게 검사할 수 있습니다.

npx 실행 오류

Error: Cannot find module 'xxx'

이 오류는 Node.js가 설치되지 않았거나 PATH에 포함되지 않은 경우 발생합니다. Claude Desktop은 시스템 PATH가 아닌 자체 환경을 사용하므로, 절대 경로를 지정해야 할 수 있습니다.

{
  "mcpServers": {
    "서버이름": {
      "command": "/usr/local/bin/npx",
      "args": ["-y", "패키지명"]
    }
  }
}

which npx 명령으로 실제 npx 경로를 확인하세요.

설정 파일이 없는 경우

Claude Desktop을 한 번도 실행하지 않았다면 설정 파일이 없을 수 있습니다. 애플리케이션을 실행한 뒤 파일이 생성되는지 확인하거나, 위 경로에 직접 빈 JSON 파일을 생성해도 됩니다.

mkdir -p ~/Library/Application\ Support/Claude
echo '{"mcpServers":{}}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json

설정 예시: 코르독 서버 추가하기

코르독(KorDoc)은 HWP·HWPX·PDF·XLSX·DOCX 같은 한국 공문서를 Markdown으로 변환해 주는 MCP 서버입니다. API 키가 필요 없어 설정이 간단합니다.

Claude Desktop / Cursor / Cline 설정:

{
  "mcpServers": {
    "kordoc": {
      "command": "npx",
      "args": ["-y", "kordoc", "mcp"]
    }
  }
}

VS Code settings.json 설정:

{
  "mcp": {
    "servers": {
      "kordoc": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "kordoc", "mcp"]
      }
    }
  }
}

설치 명령은 공식 저장소(github.com/chrisryugj/kordoc)에 명시된 값을 그대로 사용합니다. 마찬가지로 HWP-MCP나 한포지(HwpForge) 같은 한글 문서 관련 서버도 동일한 방식으로 각 에디터에 추가할 수 있습니다.

자주 묻는 질문

Cursor에서 MCP 설정 파일은 어디에 있나요?

Cursor는 두 가지 범위의 mcp.json을 지원합니다. 전역 설정은 macOS 기준 ~/.cursor/mcp.json, Windows 기준 %USERPROFILE%\.cursor\mcp.json에 위치합니다. 프로젝트별 설정은 프로젝트 루트의 .cursor/mcp.json 파일을 사용합니다. 프로젝트 범위 설정이 전역 설정보다 우선 적용됩니다.

VS Code에서 MCP 서버를 설정하려면 어떻게 하나요?

VS Code 1.99 이상에서는 settings.json에 mcp 키를 추가하거나, 워크스페이스 루트의 .vscode/mcp.json 파일을 사용합니다. Copilot Chat이 활성화된 상태에서 MCP 서버를 도구로 인식합니다.

npx 서버가 Cannot find module 오류로 실행되지 않으면 어떻게 하나요?

Node.js가 설치되지 않았거나 PATH에 없을 때 나는 오류입니다. Claude Desktop은 터미널과 다른 환경을 쓰기 때문에 command에 npx의 절대 경로(예: /usr/local/bin/npx)를 적어야 하는 경우가 있습니다. 터미널에서 which npx로 경로를 확인한 뒤 설정 파일에 넣고, 앱을 완전히 재시작하세요.

Cline 확장 프로그램에서 MCP를 설정하는 방법은 무엇인가요?

Cline은 VS Code 확장 프로그램으로, MCP 서버 설정을 Cline 사이드바의 MCP Servers 탭에서 GUI로 관리하거나 설정 파일을 직접 편집할 수 있습니다. macOS 기준 경로는 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json입니다.

MCP 설정 파일에서 JSON 문법 오류가 발생하면 어떻게 되나요?

JSON 문법 오류가 있으면 MCP 서버 전체가 로드되지 않습니다. 오류 메시지도 없는 경우가 많으므로, python3 -m json.tool 또는 온라인 JSON 검사 도구로 문법을 확인하는 습관이 중요합니다.

설정 파일 수정 후 바로 적용되나요?

Claude Desktop은 완전 재시작이 필요합니다. Cursor와 VS Code는 설정 파일 저장 후 창을 새로 고치거나(Ctrl+Shift+P → Developer: Reload Window) 재시작하면 변경 사항이 적용됩니다.

다음 단계

에디터별 설정 파일 위치를 파악했다면, 이제 필요한 MCP 서버를 찾아 설치할 차례입니다. 한국 업무 환경에 유용한 서버들은 개발 도구 카테고리에서 탐색할 수 있습니다. 한글 문서 처리가 필요하다면 코르독·HWP-MCP·한포지를, 더 다양한 서버를 찾고 싶다면 전체 서버 목록을 방문해 보세요. 새롭게 발견한 한국산 MCP 서버가 있다면 서버 등록도 환영합니다.

이 글과 관련된 MCP 서버