MCP 사용법 2026: 커넥터, 설정 파일, 명령 한 줄 3가지로 AI에 내 도구 연결하기

MCP 사용법 2026: 커넥터, 설정 파일, 명령 한 줄 3가지로 AI에 내 도구 연결하기

MCP: Model Context Protocol(모델 컨텍스트 프로토콜)의 줄임말로, AI 앱을 내 파일, 앱, 도구에 연결하는 공통 규격이에요. 프로토콜(protocol)은 서로 대화할 때 지키기로 한 약속을 뜻해요. 어떤 기기든 같은 모양으로 꽂는 USB-C 포트처럼, AI 앱과 외부 도구를 같은 방식으로 이어 줘요.

MCP는 무엇인가요?

Anthropic(앤트로픽) 발표에 따르면 MCP는 2024년 11월 25일에 오픈소스(open-source, 누구나 내용을 보고 쓸 수 있게 공개한 방식)로 나왔어요. 2026년 11월 3일 기준으로 공개된 지 1년 11개월이 지났어요. 공식 소개 페이지는 MCP를 이렇게 정의해요.

"MCP (Model Context Protocol) is an open-source standard for connecting AI applications to external systems."

풀어 쓰면 "MCP는 AI 앱을 바깥 시스템에 연결하기 위한 오픈소스 표준"이라는 뜻이에요. 여기서 바깥 시스템은 내 컴퓨터의 파일, 데이터베이스(정보를 모아 둔 저장소), 검색 엔진, 일의 흐름을 자동으로 돌리는 워크플로 같은 것들이에요.

같은 문서에는 이런 비유도 나와요.

"Think of MCP like a USB-C port for AI applications."

우리말로는 "MCP를 AI 앱용 USB-C 포트라고 생각해 보세요"쯤 돼요. 노트북에 모니터, 저장 장치, 충전기를 같은 포트로 꽂듯이, AI 앱도 하나의 규격으로 여러 도구에 이어진다는 그림이에요. 공식 소개 페이지는 이 규격을 쓰는 앱으로 Claude, ChatGPT(챗GPT, OpenAI가 만든 대화형 AI)를 꼽아요. 여기에 VS Code(코드 편집 프로그램)와 Cursor(커서, AI 기능을 넣은 코드 편집 프로그램)도 들어가요.

MCP에는 등장인물이 둘 있어요. 하나는 MCP를 쓰는 앱이고 다른 하나는 도구를 내주는 서버(server, 요청을 받아 일을 해 주는 프로그램)예요. 사무실에 비유하면 앱은 일을 맡기는 직원이고 서버는 창고 열쇠를 쥔 관리인이에요. 직원이 "다운로드 폴더에 뭐가 있어요?"라고 부탁하면 관리인이 창고에서 목록을 꺼내 와요. 서버는 내 컴퓨터 안에서 돌기도 하고(로컬 서버), 인터넷 어딘가에서 돌기도 해요(원격 서버).

나에게 맞는 MCP 사용법은 무엇인가요?

연결 방법은 3가지인데 서버가 어디에 있느냐에 따라 갈려요. 공식 문서에 따르면 인터넷에 있는 원격 서버는 커스텀 커넥터(Custom Connector, 주소로 직접 추가하는 연결 통로)로 이어요. 내 컴퓨터에서 도는 로컬 서버는 설정 파일이나 명령으로 이어요.

처음이라면 1번부터 따라 하세요. Claude Code를 쓰지 않는 분은 3번 섹션을 건너뛰어도 돼요.

설치 없이 커넥터로 연결하려면 어떻게 하나요?

공식 원격 서버 문서의 절차를 따라 하기 쉽게 6개 단계로 나눴어요. 컴퓨터에 아무것도 설치하지 않고, 서버 주소만 있으면 돼요. 연습에는 공식 문서가 마련해 둔 연습용 서버 주소를 쓸 수 있어요.

1. Claude 웹 또는 Claude Desktop에서 설정(Settings)을 열어요. 커넥터 메뉴는 설정 안에 있어요.
2. 설정 안에서 Connectors 메뉴로 들어가요. 연결된 외부 도구를 모아서 관리하는 자리예요.
3. 오른쪽 위의 Add를 누르고 Add custom connector를 골라요. 목록에 없는 서버를 주소로 직접 붙이는 메뉴라서 이걸 골라요.
4. 서버 주소 칸에 아래 주소를 붙여 넣고 Add를 눌러요. 이 주소가 공식 연습용 원격 서버예요.
5. 서버가 인증(이 도구가 내 계정으로 일해도 되는지 허락하는 절차)을 요구하면 화면 안내를 따라 마쳐요. 허락 없이는 서버가 내 정보에 닿지 못하게 막아 두려는 단계예요.
6. 입력창 왼쪽 아래의 "Add files, connectors, and more /" 표시를 눌러 Connectors에 방금 붙인 서버가 보이는지 확인해요. 여기서 보이면 연결된 거예요.

4단계에서 붙여 넣는 주소는 아래와 같아요. 그대로 복사하면 돼요.

https://example-server.modelcontextprotocol.io/mcp

연결한 뒤에는 커넥터 설정에서 도구별로 켜고 끌 수 있어요. 쓰지 않을 도구는 꺼 두면 Claude가 쓸 수 있는 범위가 그만큼 줄어요. 어떤 요금제에서 커넥터를 쓸 수 있는지는 Claude 공식 도움말에서 확인하세요.

Claude Desktop에 내 폴더를 연결하려면 어떻게 하나요?

이번에는 내 컴퓨터의 폴더를 Claude가 읽고 쓰게 해 볼게요. 공식 로컬 서버 문서에 나오는 Filesystem(파일시스템) 서버를 써요. 설정 파일 경로는 운영체제별로 3개예요. 이 방법은 설치와 파일 편집이 필요해서 1번보다 손이 더 가요.

1. Node.js가 있는지 확인해요. 이 예시 서버는 Node.js(노드제이에스, 자바스크립트 프로그램을 내 컴퓨터에서 실행해 주는 도구)가 있어야 떠요. 터미널(terminal, 글자로 명령을 입력해 컴퓨터를 다루는 창)을 열고 아래 명령을 입력해요.

node --version

버전 번호가 나오면 설치된 거예요. 아무것도 안 나오거나 오류가 나면 nodejs.org에서 LTS 버전을 내려받아 설치하세요. 공식 문서도 LTS 버전을 권해요.

2. Claude Desktop의 Edit Config를 열어요. 화면 맨 위 메뉴 막대에서 Claude 메뉴, Settings..., Developer 탭, Edit Config 순서로 들어가요. 앱 창 안의 설정이 아니라 시스템 메뉴 막대에 있는 Claude 메뉴예요. 이 메뉴가 설정 파일 편집으로 바로 이어 줘서 파일 위치를 직접 찾지 않아도 돼요.

   편집할 파일 이름은 claude_desktop_config.json이에요. 설정 파일(앱이 시작할 때 읽는 약속 문서)이 놓이는 경로는 운영체제마다 달라요.

macOS    ~/Library/Application Support/Claude/claude_desktop_config.json
Windows  %APPDATA%\Claude\claude_desktop_config.json
Linux    ~/.config/Claude/claude_desktop_config.json

3. 파일에 아래 내용을 넣어요. 이 내용이 "Claude야, Filesystem 서버를 이 폴더들에 연결해"라는 지시서 역할을 해요. 파일 형식은 JSON(제이슨, 이름과 값을 짝지어 적는 글 형식)이에요.

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

위 내용에서 command의 npx는 프로그램을 내려받아 바로 실행해 주는 명령이에요. args의 마지막 두 줄이 서버가 접근할 수 있는 폴더예요. 예시의 username은 내 컴퓨터 사용자 이름으로 바꿔야 해요. 중괄호와 쉼표 하나만 빠져도 서버가 뜨지 않으니 통째로 복사해서 붙이세요.

폴더를 고를 때 공식 문서는 이렇게 경고해요.

"Only grant access to directories you're comfortable with Claude reading and modifying."

Claude가 읽고 바꿔도 괜찮은 폴더에만 접근을 허용하라는 경고예요. 처음에는 바탕화면이나 다운로드처럼 잃어도 부담 없는 폴더로 시작하세요.

4. 파일을 저장하고 Claude Desktop을 완전히 종료한 다음 다시 실행해요. 공식 문서에 따르면 완전히 종료하고 다시 실행해야 새 설정이 읽혀요.
5. 입력창 왼쪽 아래의 "Add files, connectors, and more /" 표시에서 filesystem 서버가 보이는지 확인해요. 여기서 보여야 Claude가 폴더 도구를 쓸 수 있어요.
6. Claude에게 폴더 일을 시켜 봐요. 공식 문서의 예시 요청은 "시를 써서 바탕화면에 저장해 줘"와 "다운로드 폴더에 업무 파일 뭐 있어?"예요.

Filesystem 서버가 Claude에게 주는 도구는 4가지 묶음이에요. 공식 문서의 구분은 이래요.

• 파일 내용과 폴더 구조 읽기
• 새 파일과 새 폴더 만들기
• 파일 이동과 이름 바꾸기
• 이름이나 내용으로 파일 찾기

파일을 건드리는 작업이 나오면 Claude가 먼저 승인을 물어봐요. 이 장치는 공식 문서에 이렇게 적혀 있어요.

"All actions require your explicit approval before execution, ensuring you maintain full control over what Claude can access and modify."

모든 작업이 실행 전에 내 승인을 거쳐요. 그래서 Claude가 무엇을 읽고 바꿀지는 끝까지 내가 정해요. 승인 창이 뜨면 어떤 파일에 무슨 일을 하려는지 읽고 누르세요.

Claude Code에서는 어떻게 연결하나요?

Claude Code를 쓰는 분은 명령 한 줄로 연결해요. 아직 설치하지 않았다면 클로드코드 설치 2026 가이드를 먼저 따라 하세요. 아래 명령들은 claude 세션(Claude Code와 대화하는 화면) 밖의 터미널에서 입력해요.

1. 서버를 추가해요. 공식 빠른 시작 문서의 예시 서버를 붙여 볼게요. 이름을 먼저 붙이고 그 뒤에 주소를 적는 순서예요.

claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp

명령 속 http는 웹 주소로 이어 가는 연결 방식이에요. claude-code-docs는 내가 붙이는 서버 이름이고요. 이름이 있어야 나중에 Claude에게 "이 서버를 써"라고 가리킬 수 있어요.

2. 연결 상태를 확인해요. 아래 명령은 등록된 서버를 목록으로 보여 줘요.

claude mcp list

서버 이름 옆에 ✔ Connected가 보이면 연결된 거예요. 처음 확인에서 ✘ Failed to connect가 보여도 당황하지 마세요. 아래 막힘 목록에서 설명할게요.

3. claude를 실행하고 서버 이름을 넣어 요청해요. 평소에는 이름을 넣지 않아도 Claude가 알맞은 도구를 스스로 고르지만, 처음에는 이름을 넣어야 답이 정말 이 서버에서 왔는지 확인할 수 있어요.

claude

실행한 뒤 이렇게 입력해 보세요. 이 문장은 제가 만든 예시예요.

claude-code-docs 서버를 써서 Claude Code에서 MCP 서버를 추가하는 방법을 찾아 줘

세션 안에서는 /mcp를 입력하면 연결된 서버를 확인할 수 있어요.

서버를 추가할 때는 스코프(scope, 서버를 쓸 수 있는 범위)가 3개 중 하나로 정해져요. 공식 문서는 이렇게 나눠요.

아무것도 지정하지 않으면 local이에요. 그래서 다른 폴더에서 열면 서버가 안 보일 수 있어요. 어느 폴더에서나 쓰고 싶다면 서버를 추가할 때 --scope user 옵션을 함께 넣어요.

내 컴퓨터에서 도는 로컬 서버도 같은 명령으로 붙여요. 공식 문서의 예시는 Playwright(플레이라이트, 웹 브라우저를 대신 조작하는 도구) 서버예요.

claude mcp add playwright -- npx -y @playwright/mcp@latest

하이픈 두 개인 --가 중요해요. 이 기호 앞은 Claude Code에게 주는 옵션이고 뒤는 서버를 실행하는 명령이에요. 이 서버는 Node.js 18 이상이 있어야 해요. 이 조건은 Playwright 서버에만 해당하는 말이에요.

Sentry, Linear, Notion처럼 로그인이 필요한 서버는 추가한 직후 ! Needs authentication이 보여요. 문서에도 정상이라고 나와 있어요. 세션 안에서 /mcp를 열어 Authenticate를 고르면 브라우저가 열리고 거기서 로그인하면 돼요.

쓰지 않는 서버는 지워요. 아래 명령은 앞에서 붙인 서버를 등록에서 빼요.

claude mcp remove claude-code-docs

안전하게 쓰려면 무엇을 지켜야 하나요?

MCP는 AI에게 내 파일과 계정에 닿는 길을 열어 주는 일이에요. 공식 문서가 알려 주는 내용을 바탕으로 규칙 4개만 지키면 돼요.

1. 믿을 수 있는 서버만 붙여요. 로컬 서버는 내 컴퓨터에서 도는 프로그램이에요. 출처가 불분명한 서버는 붙이지 마세요.
2. 폴더는 잃어도 괜찮은 곳부터 열어요. 공식 로컬 서버 문서에 따르면 서버는 내 계정의 권한으로 돌아가요. 그래서 내가 할 수 있는 파일 작업을 서버도 할 수 있어요. args에는 Claude가 읽고 바꿔도 괜찮은 폴더만 넣어요.
3. 승인 요청은 읽고 누르세요. 승인 창은 Claude의 작업을 막을 수 있는 마지막 문이에요. 내용을 보지 않고 계속 허용만 누르면 이 장치가 소용없어져요.
4. 안 쓰는 서버는 지워요. 공식 빠른 시작 문서에 따르면 연결된 서버는 도구 이름이 매 세션의 컨텍스트(AI가 한 번에 기억하며 읽는 대화 공간)를 차지해요. 안 쓰는 서버를 지우면 그 공간도 아끼고 접근 길도 줄어요.

처음 하면 여기서 막힙니다

처음 하는 분이 자주 마주칠 만한 증상 8가지를 공식 문제 해결 문서에서 골랐어요. 증상 다음에 해결 방법을 붙였어요.

1. Claude Desktop에 서버가 안 보여요. Claude Desktop을 완전히 종료했다가 다시 실행해요. 그래도 안 보이면 JSON 문법에 빠진 쉼표나 괄호가 없는지 보고, 폴더 경로가 상대 경로가 아니라 절대 경로(맨 위 폴더부터 전부 적은 경로)인지 확인해요. 로그(앱이 남긴 기록)는 macOS에서 ~/Library/Logs/Claude, Windows에서 %APPDATA%\Claude\logs에 있고, mcp.log와 mcp-server-서버이름.log 파일을 열어 보면 돼요.
2. npx 실행이 실패해요. Node.js가 설치되지 않았을 가능성이 커요. 터미널에서 node --version을 입력해 버전이 나오는지 확인해요.
3. Windows에서 ${APPDATA}가 들어간 ENOENT 오류가 나요. 설정 파일의 env 항목에 APPDATA를 실제 경로로 펼친 값을 넣고 npm install -g npm으로 npm을 전역 설치해요.
4. Claude Code의 /mcp에 "No MCP servers configured"가 떠요. 다른 프로젝트 폴더에서 서버를 추가했기 때문이에요. 기본 스코프가 local이라서 그래요. 지금 있는 폴더에서 다시 추가하거나 --scope user로 추가해요.
5. 첫 확인에서 ✘ Failed to connect가 보여요. npx가 서버 프로그램을 내려받는 중일 수 있어요. 잠시 뒤 claude mcp list를 다시 입력해 보세요.
6. 시작할 때 시간 초과(타임아웃)가 나요. Claude Code는 서버가 시작되기를 기본 30초 기다려요. 환경변수(프로그램에 미리 건네는 설정값) MCP_TIMEOUT을 쓰면 더 기다리게 할 수 있고, 공식 예시는 60000(밀리초, 1000분의 1초 단위라서 60초)이에요.

MCP_TIMEOUT=60000 claude

7. --를 빠뜨려서 서버 옵션이 이상하게 읽혀요. --가 없으면 서버 옵션을 Claude Code가 자기 옵션으로 읽어요. 서버를 지우고 --를 넣어서 다시 추가해요.
8. 서버는 연결됐는데 도구가 안 보여요. 보통 API(프로그램끼리 정보를 주고받는 통로) 키 같은 환경변수가 빠진 경우예요. API 키는 서비스가 "이 사람이 맞다"고 알아보는 열쇠 같은 문자열이에요. 서버를 추가할 때 --env KEY=value 형태로 값을 넣어요.

마무리

오늘은 MCP가 AI 앱과 외부 도구를 잇는 공통 규격이라는 점을 보고, 연결 방법 3가지를 차례로 따라 해 봤어요. MCP 사용법에서 가장 부담이 적은 시작은 커넥터로 공식 연습용 서버를 붙여 보는 일이에요. 그다음 내 폴더 하나를 열어 보고, Claude Code를 쓴다면 명령 한 줄로 서버를 붙여 보세요.

다음에 해 볼 일은 공식 서버 모음 저장소에서 관심 가는 서버를 하나 골라, 오늘 배운 방식으로 붙여 보는 거예요. 이어서 읽을 만한 입문 글은 아래 관련 글에 모아 뒀어요.

자주 묻는 질문

Claude Desktop에 서버가 안 보이면 어떻게 하나요?

먼저 Claude Desktop을 완전히 종료했다가 다시 실행해요. 그래도 안 보이면 JSON 문법, 폴더 경로가 절대 경로인지, 로그 파일 순서로 확인해요. macOS 로그는 ~/Library/Logs/Claude 폴더에 있어요.

npx가 실행되지 않으면 어떻게 하나요?

Node.js가 설치되지 않았을 가능성이 커요. 터미널에서 node --version을 입력해 버전 번호가 나오는지 확인하고, 안 나오면 nodejs.org에서 LTS 버전을 설치해요.

Claude Code에서 "No MCP servers configured"가 뜨면 어떻게 하나요?

다른 프로젝트 폴더에서 서버를 추가했기 때문일 가능성이 커요. 서버는 기본 스코프인 local로 저장되어 그 프로젝트에서만 보이거든요. 지금 폴더에서 다시 추가하거나 --scope user를 붙여 모든 프로젝트에서 쓰게 해요.

첫 확인에서 Failed to connect가 뜨면 고장난 건가요?

꼭 그렇지는 않아요. npx가 서버 프로그램을 내려받는 동안에는 연결이 실패한 것처럼 보일 수 있어요. 잠시 기다렸다가 claude mcp list를 다시 입력해 보세요.

서버는 연결됐는데 도구가 안 보이면 어떻게 하나요?

공식 문서는 API 키 같은 환경변수가 빠진 경우가 많다고 알려요. 서버를 추가할 때 --env KEY=value 형태로 값을 넣으면 해결되는 경우가 있어요.

MCP 서버를 지우려면 어떻게 하나요?

Claude Code에서는 claude mcp remove 서버이름을 입력해요. 연결된 서버는 도구 이름이 매 세션의 컨텍스트를 차지하니 안 쓰는 서버는 지워 두는 편이 좋아요.

관련 글

• AI로 남의 앱을 역공학해도 될까요? rea와 한국 저작권법…
• DB 클라이언트 dbx 소문 3가지 바로잡기
• claude doctor 돌렸는데 왜 안 고쳐질까요? 진짜…

참고 자료

• Model Context Protocol 공식 문서: What is MCP?
• Model Context Protocol 공식 문서: Connect to local MCP servers
• Model Context Protocol 공식 문서: Connect to remote MCP servers
• Claude Code 공식 문서: MCP quickstart
• Anthropic: Introducing the Model Context Protocol
• Model Context Protocol 공식 서버 모음 저장소