실전 가이드

Claude Code, Cursor, VS Code에서 MCP 서버 설정하는 방법

Model Context Protocol이 무엇인지, Claude Code, Cursor, VS Code에 서버를 추가하는 방법, 참조 서버, 보안 규칙을 정리한다.

작성: Audryk · 2026년 10월 20일

MCP 서버는 코딩 에이전트가 외부 도구를 쓸 수 있게 해 준다. GitHub 리포지토리, 데이터베이스, 브라우저, 라이브러리 문서 등이 그 예다. 이 가이드는 프로토콜을 설명한 뒤 흔히 쓰는 세 클라이언트에서의 설정을 다룬다. 명령어와 파일은 공식 문서에서 가져왔으며 2026년 10월 20일에 확인했다.

MCP란?

Model Context Protocol(MCP)은 AI 애플리케이션을 로컬 파일, 데이터베이스, 검색 엔진 같은 도구, 워크플로 등 외부 시스템에 연결하기 위한 오픈소스 표준이다. 만든 쪽은 이를 AI 애플리케이션의 USB-C 포트에 비유한다(modelcontextprotocol.io). 용어집의 MCP 항목도 참고하길 바란다.

서버가 제공하는 것: tools(모델이 실행할 수 있는 작업), resources(컨텍스트 데이터), prompts(지침 템플릿)(MCP 아키텍처).
두 가지 전송 방식: 클라이언트가 같은 기기에서 서버를 로컬 프로세스로 실행하는 stdio, 그리고 bearer 토큰, API 키, 사용자 지정 헤더를 지원하는 원격 서버용 Streamable HTTP.

Claude Code에 서버 추가

Claude Code는 명령줄에서 설정한다(Anthropic). 에이전트가 아직 설치되지 않았다면 Claude Code 설치와 시작 방법 가이드를 참고하길 바란다.

원격 서버(HTTP), 온라인 서비스에 권장되는 방식:

# Basic syntax
claude mcp add --transport http <name> <url>

# Real example: Connect to Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

로컬 서버(stdio): -- 뒤의 모든 내용이 서버를 시작하는 명령이다.

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

SSE 전송 방식은 지원 중단 예정이다. Anthropic은 서버가 지원하는 경우 HTTP를 권장한다. 서버를 관리하는 명령은 다음과 같다.

# List all configured servers
claude mcp list

# Get details for a specific server
claude mcp get notion

# Remove a server
claude mcp remove notion

# (within Claude Code) Check server status
/mcp

세 가지 범위(--scope 옵션):

local(기본값): 현재 프로젝트에서 본인만 사용하며 ~/.claude.json에 저장된다;
project: 리포지토리 루트의 .mcp.json 파일로 팀과 공유하며 커밋해야 한다;
user: 본인의 모든 프로젝트에 적용되며 ~/.claude.json에 저장된다.

복제한 리포지토리는 자신의 .mcp.json 서버를 스스로 승인할 수 없다. 워크스페이스 신뢰 대화상자를 수락할 때까지 보류 상태로 남는다. 다음은 권한 범위를 좁게 설정한 개인 액세스 토큰으로 인증하는 GitHub 원격 서버의 공식 예시다.

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

claude mcp add는 토큰을 검증하지 않고 설정만 저장한다. /mcp로 연결을 확인해야 한다.

Cursor에 서버 추가

Cursor는 Marketplace에서 원클릭 설치(Customize 페이지, "Add to Cursor" 버튼, OAuth 로그인)를 제공하며, mcp.json 파일로 수동 설정할 수도 있다(Cursor).

프로젝트별 도구를 위한 프로젝트의 .cursor/mcp.json;
어디서나 쓰는 도구를 위한 홈 디렉터리의 ~/.cursor/mcp.json.

Cursor 문서에 나온, Node.js로 실행하는 로컬 서버:

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

원격 서버는 항목이 command 대신 url 키(그리고 선택적으로 headers)를 쓴다. Cursor는 stdio, SSE, Streamable HTTP를 지원하며 ${env:NAME} 문법을 해석하므로 비밀 값을 평문으로 적지 않고 환경 변수에서 읽을 수 있다.

VS Code에 서버 추가

VS Code에서 명령 팔레트(Mac은 ⇧⌘P, Windows와 Linux는 Ctrl+Shift+P)를 열고 MCP: Add Server를 실행한다(Microsoft). 서버 게시자가 URL을 제공하면 HTTP를, 명령을 제공하면 Command (stdio)를 고른다. 문서의 예시인 Playwright 서버는 Node.js 18 이상이 필요하다.

node --version
npx --version

Command (stdio)를 고르고 다음을 입력한다.

npx -y @playwright/mcp@latest

서버에 ID(예: playwright)를 지정한 다음 저장 위치를 고른다.

Global > Copilot Global: 모든 워크스페이스에 적용되는 ~/.copilot/mcp-config.json;
**Workspace-root .mcp.json**: 팀과 공유하기 위한 것(실험적 설정 chat.mcp.workspaceRootConfig.enabled);
**.vscode/mcp.json 또는 사용자 프로필의 mcp.json**: 아직 쓸 수 있지만 안내 흐름에서는 지원 중단으로 표시된다.

형식에 주의해야 한다. 이식 가능한 파일은 mcpServers 키를 쓰고, VS Code 형식은 servers를 쓴다. 서버 갤러리(프리뷰)는 확장 보기에서 @mcp를 입력하면 열린다. Microsoft는 세션에서 서버의 도구가 실제로 호출됐는지도 확인하라고 권한다. 설정을 추가했다고 해서 에이전트가 그것을 쓴다는 증거는 아니기 때문이다.

참조 서버

MCP 프로젝트는 프로토콜을 시험해 볼 수 있는 참조 서버를 유지한다. Everything, Fetch, Filesystem, Git, Memory, Sequential Thinking, Time이다(공식 예시). TypeScript 서버는 npx로, Python 서버는 uvx로 실행한다.

npx -y @modelcontextprotocol/server-memory

uvx mcp-server-git

기업이 자사 플랫폼을 위해 유지하는 서버는 modelcontextprotocol/servers 리포지토리에 정리돼 있다.

보안: 지켜야 할 규칙

로컬 MCP 서버는 샌드박스에 갇힌 플러그인이 아니다. 환경 변수를 물려받고, 계정이 읽을 수 있는 모든 것(SSH 키, 클라우드 자격 증명, 홈 디렉터리)을 읽을 수 있으며, 네트워크 연결을 열 수 있는 일반 프로세스다(modelcontextprotocol.io). 공식 권고는 다음과 같다.

목록을 점검한다: 더 이상 쓰지 않는 서버를 제거하고, 남은 서버가 각각 어디서 왔는지 파악한다;
서버가 사용자 기기에서 아무것도 필요로 하지 않는다면 원격 버전을 우선한다;
게시자를 확인하고 버전을 고정한다. latest를 쓰지 말고 의도적으로 업데이트하는 습관을 들인다. VS Code의 Playwright 예시는 @latest를 쓰므로 각자의 정책에 맞게 조정해야 한다;
서드파티 서버는 컨테이너, 샌드박스, 가상 머신 등으로 격리한다;
접근을 제한한다: 서버별 자격 증명, 특정 디렉터리로 제한한 파일 시스템 접근, 가능하면 읽기 전용, 제한된 네트워크 송신;
도구 설명을 읽는다: 모델이 이를 지침으로 읽기 때문에 프롬프트 인젝션의 통로가 될 수 있다.

Anthropic도 서버를 연결하기 전에, 특히 외부 콘텐츠를 가져오는 서버는 신뢰할 수 있는지 확인하라고 당부한다(Anthropic). Cursor는 최소 권한의 API 키를 쓰고, 중요한 통합은 소스 코드를 검토하라고 권한다(Cursor).

더 알아보기

도구 페이지에서 어떤 도구가 MCP를 지원하는지 볼 수 있다: Claude Code, Cursor, GitHub Copilot, Cline.
에디터 비교: Cursor, Devin Desktop, Copilot.
생성된 코드의 위험: 보안에 관해 연구들이 말하는 것.

출처

Model Context Protocol: What is MCP?, (확인일: 2026-10-20)
Model Context Protocol: Architecture overview, (확인일: 2026-10-20)
Model Context Protocol: Example Servers, (확인일: 2026-10-20)
Model Context Protocol: Local Server Security, (확인일: 2026-10-20)
Claude Code Docs: Connect Claude Code to tools via MCP, (확인일: 2026-10-20)
Cursor Docs: Model Context Protocol, (확인일: 2026-10-20)
VS Code Docs: Add MCP servers in VS Code, (확인일: 2026-10-20)

핵심 요약: MCP 서버는 명령 하나나 몇 줄의 JSON으로 추가할 수 있지만 로컬 서버는 사용자의 권한으로 실행된다. 신원이 확인된 게시자의 서버만, 버전을 고정하고 접근을 제한해서 설치해야 한다.

이 기사에서 오류를 발견하셨나요? 제보하기 · 정정 정책

Claude Code, Cursor, VS Code에서 MCP 서버 설정하는 방법

MCP란?

Claude Code에 서버 추가

Cursor에 서버 추가

VS Code에 서버 추가

참조 서버

보안: 지켜야 할 규칙

더 알아보기

출처

다음 읽을거리

Claude Code 설치와 시작 방법: 단계별 가이드

Gemini CLI에서 Antigravity CLI로 옮기기: 설치와 마이그레이션

예산에 맞는 코딩 에이전트 고르기: 무료, 월 $20, 엔터프라이즈

Claude Code, Cursor, VS Code에서 MCP 서버 설정하는 방법

MCP란?

Claude Code에 서버 추가

Cursor에 서버 추가

VS Code에 서버 추가

참조 서버

보안: 지켜야 할 규칙

더 알아보기

출처

손가락으로 그리는 오일러 경로

OrigoTech 뉴스레터

다음 읽을거리

Claude Code 설치와 시작 방법: 단계별 가이드

Gemini CLI에서 Antigravity CLI로 옮기기: 설치와 마이그레이션

예산에 맞는 코딩 에이전트 고르기: 무료, 월 $20, 엔터프라이즈