Claude MCP 사용법 완벽 정리, Code·Desktop 연결 방법과 실무 활용법

AI 에이전트 활용이 늘어나면서 AI는 하나의 작업에 답하는 수준을 넘어, 외부 도구와 데이터를 연결해 여러 단계를 이어서 처리하는 방향으로 확장되고 있습니다. 중심이 되는 AI가 전체 작업을 판단하고, 연결된 도구가 자료 조회와 브라우저 조작, 파일 관리 같은 세부 기능을 수행하는 방식입니다.

Claude에서 이러한 작업 환경을 구성할 때 알아두면 좋은 대표적인 연결 기술이 ‘MCP(Model Context Protocol)’입니다. MCP는 Claude가 외부 도구와 데이터, 업무 시스템에 공통된 방식으로 연결될 수 있도록 돕는 개방형 표준입니다. 필요한 정보를 불러오는 것뿐 아니라, 연결된 도구가 제공하는 기능을 Claude가 작업에 활용할 수 있도록 합니다.

이 글에서는 Claude MCP가 무엇이고 어떤 방식으로 작동하는지 살펴본 뒤, Claude Code와 Claude Desktop에서 MCP 서버를 연결하는 방법과 실무에서 활용할 때 확인해야 할 주의사항까지 정리해보겠습니다.

Claude MCP 핵심 요약

• Claude MCP는 외부 도구 연결을 표준화하는 방식입니다. MCP 서버를 통해 Claude가 파일, 데이터베이스, 이슈 트래커, 모니터링 도구 같은 외부 시스템에 접근할 수 있습니다.
• Claude Code와 Claude Desktop에서 활용 방식이 다릅니다. Claude Code는 claude mcp add 명령어로 서버를 등록하고, Claude Desktop은 설정 파일을 통해 로컬 MCP 서버를 연결할 수 있습니다.
• 권한과 보안 검토가 필수입니다. MCP 서버는 데이터를 읽거나 수정할 수 있으므로, 어떤 도구가 어떤 권한을 요청하는지 확인해야 합니다.
• MCP 자체는 별도 요금제가 아니라 연결 규격입니다. 다만 Claude Code, 커넥터, 팀 관리 기능은 Claude 플랜에 따라 접근 조건이 달라질 수 있습니다.

Claude MCP란?

Claude MCP(Model Context Protocol)는 Claude가 노션, 구글 드라이브, PC 파일 시스템과 같은 외부 데이터 소스나 도구에 안전하고 원활하게 연결될 수 있도록 Anthropic이 개발한 개방형 표준입니다.

기존에는 AI에 새로운 서비스나 데이터를 연결할 때마다 별도의 연동 방식을 개발해야 했지만, MCP를 활용하면 AI 애플리케이션과 외부 시스템이 공통된 규격으로 통신할 수 있어, 다양한 데이터와 기능을 보다 일관된 방식으로 연결할 수 있습니다. 

laude뿐 아니라 해당 규격을 지원하는 다른 AI 애플리케이션에서도 활용할 수 있어, 개발자, 마케터, 기획자 등 직무와 관계없이 업무에 필요한 데이터와 도구를 AI에 연결할 수 있어, AI 에이전트의 활용 범위를 넓히는 주요 연결 기술로 꼽히고 있습니다.

Claude MCP가 주목받는 이유

1. 자료를 복사해 붙여 넣는 번거로움을 줄입니다

기존에는 이슈 내용이나 오류 로그, 문서의 일부를 Claude에 직접 복사해 입력해야 했습니다. 빠르게 사용할 수 있는 방법이지만, 원본 자료가 변경되면 새로운 내용을 다시 복사해야 한다는 한계가 있습니다.

Claude MCP를 연결하면 Claude가 MCP 서버를 통해 업무에 필요한 정보를 직접 조회할 수 있습니다. 연결된 서버의 기능과 허용된 권한 범위 안에서 이슈 트래커, 데이터베이스, 모니터링 도구 등의 정보를 확인할 수 있어, 여러 서비스를 오가며 자료를 복사하는 과정을 줄일 수 있습니다.

2. 도구마다 연동 방식을 새로 개발하는 부담을 줄입니다

기존에는 Claude에 외부 도구를 연결할 때 서비스마다 별도의 연동 방식을 개발해야 했습니다. MCP는 Claude와 외부 시스템이 공통된 규격으로 통신할 수 있도록 연결 방식을 표준화합니다.

한 번 구축한 MCP 서버는 Claude를 비롯한 여러 MCP 호환 애플리케이션에서 활용할 수 있습니다. 클라이언트별 설정과 인증은 필요하지만, 도구마다 연결 구조를 처음부터 새로 개발해야 하는 부담을 줄일 수 있습니다.

3. Claude Code의 개발 업무 흐름을 확장할 수 있습니다

Claude Code에 MCP 서버를 연결하면 이슈 트래커에 등록된 요구사항을 바탕으로 기능을 구현하거나, 모니터링 데이터를 분석하고 데이터베이스를 조회하는 작업을 요청할 수 있습니다. 

이를 통해 Claude Code는 프로젝트의 코드뿐 아니라 연결된 외부 도구의 정보도 함께 참고할 수 있습니다. 개발자는 이슈 관리, 오류 분석, 데이터 조회와 코드 수정을 하나의 작업 흐름 안에서 이어갈 수 있습니다.

Claude MCP 사용법

Claude Code에서 MCP 서버 연결하기

Claude Code에서 외부 데이터나 도구를 활용하려면 해당 기능을 제공하는 MCP 서버를 먼저 연결해야 합니다. MCP 서버는 Claude Code와 외부 시스템 사이에서 필요한 정보나 기능을 전달하는 역할을 합니다. 

Caude MCP의 사용 과정을 확인하기 위해 Claude Code 공식 문서를 검색할 수 있는 claude-code-docs MCP 서버를 연결해 보겠습니다. 

프로젝트 폴더에서 터미널을 열고 다음 위의 명령어를 입력합니다. 명령어는 다음과 같은 구조로 이루어져 있습니다.

• claude mcp add: MCP 서버를 등록하는 명령어
• --transport http: HTTP 방식으로 원격 서버에 연결
• claude-code-docs: Claude Code에 표시할 서버 이름
• https://.../mcp: 연결할 MCP 서버 주소

Added HTTP MCP server claude-code-docs 

명령어를 실행한 뒤 다음과 같은 결과가 나오면 서버 등록이 완료된 것입니다. 이제 Claude Code 입력창에서 연결한 MCP 서버를 활용할 작업을 요청합니다.

Claude Code가 연결된 MCP 서버를 통해 공식 문서를 검색하고, 확인한 내용을 정리해 답변하는 것을 볼 수 있습니다. 

Claude 앱에서 커넥터로 로컬 MCP 서버 연결하기 

Claude MCP는 Claude Code뿐 아니라 Claude Desktop에서도 연결해 사용할 수 있습니다. 

이번에는 MCP 연동 과정을 직접 확인할 수 있도록, 웹페이지의 구조화된 접근성 정보를 바탕으로 브라우저를 조작하는 Playwright MCP의 연결 방법을 알아보겠습니다.

Playwright MCP를 연결하면 Claude가 웹페이지를 열고 버튼을 클릭하거나 입력창에 내용을 작성하는 등, 일반적인 대화만으로는 수행할 수 없는 브라우저 작업을 직접 실행할 수 있습니다.

Claude 앱에서 MCP를 연동하려면 먼저 왼쪽 하단의 프로필을 클릭해 설정 화면을 엽니다. 이후 메뉴 하단의 개발자를 선택하면 로컬 MCP 서버를 추가하고 관리할 수 있는 화면으로 이동합니다. 

위의 화면에서 구성편집을 눌러 claude_desktop_config에 추가하려는 MCP 프로그램의 설정을 추가해야합니다.

MCP 문서 작성 방법

각 항목의 의미는 다음과 같습니다.

• 서버이름: Claude 앱에서 MCP 서버를 구분할 이름
• command: MCP 서버를 실행하는 프로그램이나 명령어
• args: 실행할 패키지와 옵션, 접근 경로 등의 정보
• env: API 키와 같은 환경 변수

env는 인증 정보가 필요한 MCP에서만 사용합니다. 연결하려는 MCP에 따라 command, args, env의 내용이 달라지므로 해당 MCP가 제공하는 설정값을 확인해 입력해야 합니다.

Playwright MCP를 예를 들면 다음과 같이 작성할 수 있습니다.

Playwright MCP의 경우 API 키가 필요 없어 env를 빼고 작성합니다. 작성한 설정은 claude_desktop_config.json 파일의 기존 JSON 구조 안에 추가한 뒤 저장합니다.

이미 다른 설정이 들어 있다면 기존 내용을 삭제하지 말고, 마지막 설정 뒤에 쉼표를 붙인 다음, 파일을 닫는 마지막 중괄호 } 바로 앞에 mcpServers 설정을 추가합니다.

클로드 앱을 종료하고 다시 켜서 설정에 들어가면 Playwright MCP가 추가된 것을 볼 수 있습니다.

이제 클로드에 playwirght 사용을 요청하면 클로드가 사용자의 요청에 맞게 Playwright를 사용합니다. 작동이 잘 되는지 테스트를 해보겠습니다.

Playwright MCP 작동 테스트 프롬프트

Playwright MCP를 연동해 요청을 처리합니다.

작업이 완료되면 요청한 대로 Playwright의 할 일 목록에 ‘MCP 연결 테스트’가 추가된 것을 볼 수 있습니다. 

실무에서 활용하기 좋은 

Claude MCP TOP 3

1. Playwright MCP

Playwright MCP는 Claude가 웹브라우저를 직접 조작할 수 있도록 브라우저 자동화 기능을 제공하는 MCP 서버입니다.  Microsoft의 브라우저 자동화 도구인 Playwright를 기반으로 하며, 웹페이지의 구조화된 접근성 정보를 읽어 버튼과 입력창, 메뉴 등의 요소를 찾고 조작합니다. 

웹사이트를 제작하거나 관리하는 과정에서는 페이지를 열고 버튼을 클릭하거나, 입력폼이 정상적으로 작동하는지 반복해서 확인해야 하는데, Playwright MCP를 연결하면 이러한 작업을 Claude에게 자연어로 요청할 수 있습니다.

2. ElevenLabs MCP 

ElevenLabs MCP는 Claude에 ElevenLabs의 음성 생성과 오디오 처리 기능을 연결해 주는 MCP 서버입니다. Claude가 작성한 문장을 실제 음성 파일로 변환하거나, 녹음된 음성을 텍스트로 바꾸는 등 음성과 관련된 작업을 대화 안에서 요청할 수 있습니다. 유튜브 영상, 광고, 교육 콘텐츠, 팟캐스트와 같이 음성이 필요한 콘텐츠를 제작할 때 활용도가 높습니다. 

3. Blender MCP 

Blender MCP는 Claude가 3D 제작 프로그램인 Blender를 직접 조작할 수 있도록 연결해 주는 오픈소스 MCP 서버입니다. 만들고 싶은 장면이나 오브젝트를 자연어로 설명하면 Claude가 Blender에서 오브젝트를 생성하고, 위치를 조정하거나 재질을 적용하는 등의 작업을 수행합니다.

Blender MCP를 활용하면 복잡한 메뉴를 일일이 조작하지 않고도 원하는 결과를 자연어로 요청할 수 있어, 3D 시안과 제품 이미지, 게임 오브젝트, 영상용 장면을 빠르게 구성할 때 유용합니다.

Claude MCP 사용 시 주의사항 4가지

1. 신뢰할 수 있는 MCP 서버만 연결해야 합니다

MCP 서버는 Claude가 외부 서비스나 사용자의 컴퓨터에 있는 도구를 이용할 수 있도록 기능을 제공합니다. 출처가 불분명한 서버를 연결하면 민감한 데이터가 전달되거나 의도하지 않은 작업이 실행될 위험이 있습니다.

특히 사용자가 직접 등록하는 사용자 지정 커넥터는 Anthropic이 검증하지 않은 서비스와 연결될 수 있습니다. 연결 전에는 서버를 운영하는 업체나 개발자가 누구인지, 어떤 기능을 제공하는지, 어떤 권한을 요청하는지 확인해야 합니다. 

2. 필요한 권한과 접근 범위만 허용해야 합니다

MCP 서버는 데이터를 읽는 기능뿐 아니라 생성, 수정, 삭제와 같은 작업도 수행할 수 있습니다. 처음부터 넓은 권한을 허용하면 잘못된 요청이나 설정 오류로 중요한 데이터가 변경될 수 있습니다.

가능한 경우 읽기 전용 권한이나 최소 권한으로 시작하고, 실제 업무에 필요한 기능만 추가하는 것이 좋습니다. 로컬 MCP에 폴더 접근을 허용할 때도 사용자 폴더 전체가 아니라 프로젝트 폴더나 테스트 폴더처럼 필요한 경로만 지정해야 합니다.

3. 실행 전후의 작업 내용을 확인해야 합니다

MCP 서버나 외부 도구가 반환하는 내용에는 Claude가 사용자의 의도와 다른 행동을 하도록 유도하는 숨겨진 지시문이 포함될 수 있습니다. 이를 ‘프롬프트 인젝션’이라고 합니다.

프로젝트 인젝션을 방지하기 위해 파일 수정, 데이터 삭제, 이메일 전송처럼 결과를 되돌리기 어려운 작업은 자동 승인하지 않는 것이 좋습니다. 

Claude가 MCP에 전달하는 입력값과 실행 결과를 확인하고, 중요한 작업은 사용자가 최종 승인하는 과정을 유지해야 합니다.

4. Reference Server를 운영 환경에 바로 적용하지 않아야 합니다

MCP 공식 GitHub 저장소에서 제공하는 Reference Server는 MCP의 기능과 SDK 사용법을 보여주기 위한 교육용 예시입니다. 실제 운영 환경에 필요한 보안과 안정성이 모두 갖춰진 제품을 의미하지는 않습니다.

사내 시스템이나 고객 데이터에 연결하려면 테스트 환경에서 먼저 작동 방식과 권한 범위를 확인해야 합니다. 운영 환경에 적용할 때는 서비스의 특성에 따라 인증과 접근 제어, 입력값 검증, 오류 처리, 실행 기록과 감사 로그 등의 보호 장치를 별도로 설계해야 합니다.

AI 에이전트 시대, 알아두면 유용한 AI 도구 활용법 

클로드 디자인(Claude Design) 사용법, 디자인 작업 방식이 달라지고 있습니다

구글 비즈(Google Vids) 사용법, AI 아바타를 활용한 강의 영상 만들기

구글 AI 스튜디오(Google AI Studio) 사용법: 전문가들이 쓰는 방법은 따로 있습니다