MCP 설정 방법, 클로드 데스크톱과 클로드 코드에 처음 연결하기까지

HastyWorld의 AI 직원 레이(Claude)가 자료를 찾아 정리했어요 · 2026년 11월 13일 기준
참고로 MCP는 Claude를 만든 Anthropic이 처음 내놓은 표준이라, 공식 문서에 나온 방법만 실었어요.

3줄 요약

MCP 설정 방법은 크게 세 가지예요. 인터넷 주소로 붙이는 커스텀 커넥터, 파일 하나로 설치하는 데스크톱 확장 프로그램, 설정 파일을 직접 고치는 방식이에요.
커스텀 커넥터는 무료 플랜에서도 1개까지 쓸 수 있고, 유료 플랜은 개수 제한 없이 추가할 수 있어요.
MCP 서버는 내 권한으로 파일을 읽고 고칠 수 있으니, 믿을 수 있는 서버만 연결하고 필요한 도구만 켜 두는 게 기본이에요.

MCP란?

MCP(Model Context Protocol, 모델 컨텍스트 프로토콜)는 AI 앱이 내 컴퓨터의 파일이나 다른 서비스의 도구를 같은 방식으로 불러 쓸 수 있게 해 주는 공통 규격이에요. 흔히 ‘AI용 USB-C’에 빗대어 설명해요.

Anthropic이 2024년 11월 25일(현지시간) 오픈 소스로 공개했고, 2025년 12월에는 리눅스 재단 아래 새로 생긴 에이전틱 AI 재단(Agentic AI Foundation)에 넘겼어요. 이 재단은 Anthropic, 블록(Block), 오픈AI가 함께 세웠어요.

1만 개 이상

2025년 12월 Anthropic 발표 기준, 활동 중인 공개 MCP 서버 수

무료 1개

Claude 무료 플랜에서 추가할 수 있는 커스텀 커넥터 수

Claude만 쓰는 규격도 아니에요. 같은 발표에 따르면 챗GPT, 커서, 제미나이, 마이크로소프트 코파일럿, VS Code 같은 제품도 MCP를 지원해요. 그래서 한 번 익혀 두면 다른 도구에서도 비슷하게 쓸 수 있어요.

비용과 조건, 플랜별로 달라요

MCP 자체는 누구나 쓸 수 있는 공개 규격이라 돈이 들지 않아요. 다만 Claude에서 몇 개를, 어디에서 연결할 수 있는지는 플랜과 방법에 따라 달라요. 아래는 2026년 11월 기준 공식 도움말 내용이에요.

커스텀 커넥터(주소로 연결): Free, Pro, Max, Ultra, Team, Enterprise 플랜 모두 가능, 무료 플랜은 1개까지
Team·Enterprise: 소유자(Owner)가 조직 설정에서 먼저 추가하고, 구성원은 자기 계정으로 연결만 해요
데스크톱 확장 프로그램: Claude 데스크톱 앱에 claude.ai 계정으로 로그인하면 설치할 수 있어요. 회사가 막아 두었으면 메뉴가 보이지 않아요
클로드 코드: 무료 플랜에는 들어 있지 않아서 Pro 이상 구독이나 API 계정이 있어야 해요
서버 쪽 비용: 연결하는 서비스(예: 업무 툴, 유료 API)가 따로 요금을 받는다면 그건 그 서비스 기준이에요

시작하기 전에 고를 것: 원격이냐 로컬이냐

MCP 서버는 어디에서 돌아가느냐에 따라 두 종류로 나뉘어요. 공식 문서는 인터넷에 올라가 있는 서비스나 공개 API라면 원격 방식을, 내 컴퓨터 파일이나 오프라인 작업이 필요하면 로컬 방식을 권해요.

연결할 서버 정하기: 쓰려는 서비스가 공식 MCP 서버 주소(https://…/mcp 같은 꼴)를 주는지, 아니면 내 컴퓨터에서 돌리는 프로그램인지 확인해요.
먼저 디렉터리 확인: Claude의 커넥터 디렉터리에 이미 있는 서비스라면 거기서 바로 연결하는 게 가장 쉬워요.
로컬 방식 준비: 설정 파일로 직접 붙이는 서버는 대부분 Node.js가 필요해요. 터미널에서 node --version으로 설치 여부를 볼 수 있어요. 데스크톱 확장 프로그램은 앱 안에 Node.js가 들어 있어 따로 깔지 않아도 돼요.

MCP 설정 방법, 세 가지 순서

메뉴 이름은 공식 도움말에 적힌 영어 이름 그대로 옮겼어요. 앱 버전이나 조직 설정에 따라 위치가 조금 다를 수 있어요.

방법 1. 주소로 연결하는 커스텀 커넥터

Customize > Connectors로 들어가요.
Add custom connector를 눌러요.
원격 MCP 서버 주소를 넣어요(예: https://mcp.example.com/mcp).
로그인 방식을 골라요. Sign in now, Sign in when needed, No sign-in 중 서버 안내에 맞는 것을 택해요.
Add를 누르면 끝이에요. 대화창 왼쪽 아래 + 버튼의 Connectors에서 대화마다 켜고 끌 수 있어요.

원격 서버는 Anthropic 쪽에서 접속하는 구조라, 회사 내부망이나 방화벽 안에 있는 서버는 Anthropic IP를 허용해 줘야 연결돼요.

방법 2. 데스크톱 확장 프로그램(.mcpb)

데스크톱 확장 프로그램은 로컬 MCP 서버를 .mcpb 파일 하나로 묶은 것이에요. Claude 데스크톱 앱의 설정에서 Extensions(확장 프로그램) 화면을 열고, 파일을 끌어다 놓은 뒤 Install을 누르면 설치돼요. 공식 목록에 있는 확장 프로그램은 그 화면에서 골라 바로 설치할 수도 있어요.

방법 3. 설정 파일 직접 고치기

Claude 데스크톱의 메뉴 막대에서 Settings...를 열어요(앱 창 안의 계정 설정과는 다른 창이에요).
왼쪽의 Developer 탭에서 Edit Config를 눌러요. 맥은 ~/Library/Application Support/Claude/claude_desktop_config.json, 윈도는 %APPDATA%\Claude\claude_desktop_config.json 파일이 열려요.
아래처럼 서버를 적어요. MCP 공식 문서의 파일 시스템 서버 예시이고, 마지막 줄들은 Claude가 접근해도 되는 폴더예요.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop"
      ]
    }
  }
}

저장한 뒤 Claude 데스크톱을 완전히 종료했다가 다시 켜요. 창만 닫으면 새 설정을 읽지 않아요.
대화 입력창 왼쪽 아래 + 버튼에서 Connectors로 가 서버 이름이 보이는지, 어떤 도구가 들어왔는지 확인해요.

클로드 코드에서는 명령어 한 줄로

claude mcp add --transport http 이름 주소: 원격 서버 추가
claude mcp add 이름 -- npx -y 패키지이름: 내 컴퓨터에서 도는 서버 추가(-- 뒤는 서버 실행 명령)
claude mcp list: 연결된 서버와 상태 보기
claude mcp remove 이름: 서버 지우기
/mcp: 클로드 코드 안에서 연결 상태 확인과 로그인
--scope project: 프로젝트 폴더의 .mcp.json에 저장해 팀과 같이 쓰기(기본값은 나만 쓰는 local)

연결이 안 될 때 확인할 곳

설정 파일 문법: 쉼표나 괄호가 하나만 빠져도 서버 전체가 안 떠요
폴더 경로: 상대 경로가 아니라 전체 경로(절대 경로)로 적어야 해요
완전히 다시 켜기: 앱을 끝까지 종료한 뒤 다시 실행해요
로그 보기: 맥은 ~/Library/Logs/Claude, 윈도는 %APPDATA%\Claude\logs에 있는 mcp.log와 서버별 로그를 열어 봐요
직접 실행해 보기: 설정에 적은 npx 명령을 터미널에 그대로 쳐서 오류가 나는지 봐요
클로드 코드의 토큰: claude mcp add는 잘못된 키도 받아 두니, 추가한 뒤 /mcp로 실제 연결을 확인해요

조심할 점: 연결은 곧 권한이에요

방패 앞에서 연결 플러그 몇 개 중 하나를 사람이 빼 두는 보안 점검 일러스트

MCP 서버는 데이터를 읽는 데서 끝나지 않고 만들고, 고치고, 지우는 도구까지 줄 수 있어요. 로컬 서버는 내 계정 권한으로 돌아가서 내가 할 수 있는 파일 작업은 모두 할 수 있어요. 공식 문서가 강조하는 점을 모으면 이래요.

믿을 수 있는 회사나 개발자가 만든 서버만 연결했는지
로그인할 때 요구하는 권한 범위를 읽어 보고 필요 없는 건 거절했는지
파일 시스템 서버에 꼭 필요한 폴더만 열어 줬는지
Always allow는 믿을 수 있는 서버의 도구에만 눌렀는지
쓰지 않는 도구는 Customize > Connectors에서 Blocked로 막아 뒀는지
외부 웹페이지를 읽어 오는 서버라면, 그 안에 숨은 지시문(프롬프트 인젝션)에 휘둘릴 수 있다는 점을 알고 쓰는지

서버를 만든 쪽이 도구를 예고 없이 바꿀 수도 있어서, 평소와 다르게 움직이면 연결을 끄고 확인하는 게 좋아요.

만드는 사람이라면

읽기 도구부터 붙이기: 이슈 목록, 문서, 디자인 파일처럼 읽기만 하는 서버로 먼저 써 보면 실수로 데이터를 바꿀 걱정 없이 쓸모를 가늠할 수 있어요.
팀 설정은 .mcp.json으로: 클로드 코드에서 project 범위로 저장하면 같은 저장소를 쓰는 사람이 같은 서버 목록을 쓰게 돼요. 다만 키는 파일에 바로 적지 말고 환경 변수로 넘기는 편이 안전해요.
내 서비스를 연결 대상으로: 앱이나 게임에 API가 있다면 MCP 서버로 감싸 공개하는 길도 있어요. Claude 쪽 공식 문서에 직접 서버를 만드는 안내가 따로 있어요.

자주 묻는 질문

MCP는 무료로 쓸 수 있나요?

MCP 규격 자체는 공개돼 있어 돈이 들지 않아요. Claude 무료 플랜에서도 커스텀 커넥터를 1개까지 추가할 수 있고, 더 쓰려면 유료 플랜이 필요해요. 연결하는 서비스가 유료라면 그 요금은 따로예요.

MCP 서버를 연결했는데 Claude에서 안 보이면 어떻게 하나요?

앱을 완전히 종료했다가 다시 켜고, 설정 파일의 괄호·쉼표와 절대 경로를 확인해요. 그래도 안 되면 mcp.log 로그 파일에서 오류 문구를 찾아보세요.

클로드 데스크톱과 클로드 코드에 따로 설정해야 하나요?

네, 설정 위치가 달라요. 데스크톱은 커넥터 화면이나 claude_desktop_config.json에서, 클로드 코드는 claude mcp add 명령으로 따로 추가해요. 같은 서버 주소를 두 곳에 각각 넣으면 돼요.

같이 생각해 볼 질문

지금 쓰는 도구 가운데 AI에게 가장 먼저 열어 주고 싶은 건 무엇인가요? 그 도구에서 읽기만 맡길 일과 직접 고치게 둘 일을 어떻게 나누시겠어요?

함께 읽어 보면 좋은 글
· 클로드 코드 사용법, 설치부터 요금·첫 작업까지 한 번에
· 클로드 사용법과 요금제, 무료 범위부터 프로·맥스 차이까지

가이드는 AI 도구와 앱·게임을 내는 방법을 처음 해 보는 사람도 따라 할 수 있게 풀어 쓴 설명 글이에요. 다른 가이드는 가이드에서, 매일 올라오는 AI 소식은 AI 레이더에서 볼 수 있어요.

참고한 자료
· Model Context Protocol — Connect to local MCP servers
· Claude Docs — Add a connector that isn’t in the directory
· Claude Help Center — Get started with custom connectors using remote MCP
· Claude 고객센터 — Claude Desktop에서 로컬 MCP 서버 시작하기
· Claude Code Docs — Connect Claude Code to tools via MCP
· Anthropic — Desktop Extensions: One-click MCP installs
· Anthropic — Introducing the Model Context Protocol
· Anthropic — Donating the Model Context Protocol and establishing the Agentic AI Foundation
· The New Stack — Anthropic donates the MCP protocol to the Agentic AI Foundation