이 장에서 배우는 것
•
MCP가 무엇이고 왜 필요한지 (USB 포트 비유)
•
claude mcp add로 서버 추가하는 방법
•
설치 실패 원인 5가지와 해결법
•
노션, Playwright, 웹 검색 MCP 활용법
•
MCP 여러 개 조합해서 복잡한 작업 처리하기
•
음성으로 Claude Code 사용하는 방법
지금까지 다룬 파일 정리, 데이터 분석, 문서 작성은 모두 컴퓨터에 있는 파일로 하는 작업이었습니다. 하지만 실제 업무는 여러 도구에 흩어져 있습니다. 회의록은 노션에, 파일은 구글 드라이브에, 대화는 슬랙에 있습니다. MCP 없이는 이런 것들을 일일이 복사해서 Claude Code에 붙여넣어야 합니다. MCP를 연결하면 "노션에서 이번 달 회의록을 가져와서 보고서를 만들어줘"처럼 한 번에 지시할 수 있습니다. MCP 하나를 잘 연결하면 매일 반복하던 수작업이 한 문장 지시로 바뀝니다.
MCP란
MCP는 Claude Code와 외부 서비스를 연결하는 표준 규격입니다(Model Context Protocol의 약자). USB 포트에 다양한 장치를 꽂아 쓰듯, MCP라는 규격을 통해 노션, 슬랙, 웹 검색 같은 서비스를 Claude Code에 연결합니다. 이렇게 연결된 각각의 서비스를 "MCP 서버"라고 부릅니다.
MCP는 Claude Code 전용이 아닙니다 MCP는 Anthropic이 만들었지만 Claude Code 전용이 아닙니다. Cursor, Windsurf 같은 다른 AI 도구에서도 같은 MCP 서버를 쓸 수 있는 개방형 표준입니다. 그래서 MCP 서버의 종류가 빠르게 늘고 있고, 사례와 문제 해결 자료가 풍부합니다.
기본 Claude Code만으로는 할 수 없지만, MCP를 추가하면 가능한 것들:
•
인터넷에서 최신 정보 검색
•
노션 페이지를 읽고 작성
•
구글 드라이브 파일을 직접 가져와서 처리
•
슬랙 채널의 대화를 요약
•
웹사이트를 열어서 정보를 추출
MCP 서버 추가하기
터미널에서 claude mcp add 명령어로 추가합니다. 예를 들어 Playwright MCP를 추가하려면:
claude mcp add playwright -- npx @playwright/mcp@latest
Plain Text
복사
여기서 playwright는 MCP 서버 이름이고, -- 뒤는 실행 명령어입니다.
추가한 서버를 관리하는 명령어:
명령어 | 설명 |
/mcp | 대화 중 설치된 MCP 서버 목록 확인 |
claude mcp list | 터미널에서 설치된 MCP 서버 목록 확인 |
claude mcp remove <이름> | MCP 서버 제거 |
설치가 어렵다면 Claude Code에게 도움을 요청하세요:
Notion MCP 서버를 설치하고 싶은데, 어떻게 하면 돼?
Plain Text
복사
설치가 실패할 때 — 실전 트러블슈팅
MCP 설치는 한 번에 되는 경우도 많지만, 안 될 때는 반복적으로 안 됩니다. 가장 흔한 실패 원인과 해결법입니다.
"npx: command not found"
Node.js가 설치되어 있지 않거나, 설치됐는데 터미널이 인식을 못하는 경우입니다.
Node.js가 설치되어 있는지 확인해줘. 버전도 알려줘.
Plain Text
복사
Node.js 18 이상이 필요합니다 Node.js가 없으면 설치를 시키고, 설치 후에도 "command not found"가 나오면 터미널을 완전히 닫았다가 다시 열어야 합니다. Node.js 18 이상이 필요한 MCP 서버가 많으므로, 버전이 16 이하라면 업데이트가 필요합니다.
"Error: Cannot find module" 또는 패키지 다운로드 실패
네트워크 문제이거나, npm 캐시가 깨진 경우입니다.
회사 네트워크가 원인일 수 있습니다 집 와이파이나 모바일 핫스팟으로 바꿔서 시도해보면 원인이 네트워크인지 확인할 수 있습니다.
API 키 관련 오류
Brave Search, Slack 같은 MCP 서버는 API 키가 필요합니다. "unauthorized" 또는 "invalid key" 오류가 나는 흔한 실수들:
•
키 앞뒤에 공백이 포함됨 (복사할 때 흔히 발생)
•
환경 변수 이름이 미묘하게 다름 (BRAVE_API_KEY vs BRAVE_SEARCH_API_KEY)
API 키 오류가 나면, 해당 MCP 서버의 공식 문서에서 정확한 환경 변수 이름을 확인하세요.
"MCP 서버가 시작은 되는데 도구가 안 보여요"
Claude Code를 완전히 종료(/exit)하고 다시 시작하면 해결되는 경우가 많습니다.
claude mcp remove <이름>
Plain Text
복사
으로 삭제하고 처음부터 다시 설치합니다.
유용한 MCP 서버
MCP 서버는 수백 개가 있습니다. 그중 비개발자 업무에 도움이 되는 대표적인 서버를 소개합니다.
Notion MCP
노션과 연결하면 Claude Code에서 노션 페이지를 읽고, 만들고, 수정합니다.
노션의 "회의록" 데이터베이스에 오늘 회의 내용을 저장해줘.
제목: 주간 팀 미팅
참석자: 김팀장, 이대리
주요 논의: Q1 목표 설정
결정 사항: 마케팅 예산 20% 증액
Plain Text
복사
노션의 "거래처" 데이터베이스에서 최근 3개월간 거래가 없는 업체를 찾아줘
Plain Text
복사
아래 명령어로 Notion 공식 MCP를 추가합니다:
claude mcp add --transport http notion https://mcp.notion.com/mcp
Plain Text
복사
노션 MCP의 접근 권한 노션의 모든 페이지에 접근할 수 있는 게 아닙니다. MCP 연결 시 접근 권한을 부여한 페이지만 읽고 쓸 수 있습니다. "노션에서 페이지를 찾을 수 없다"는 오류가 나오면, 인증 설정에서 해당 페이지에 대한 접근 권한을 추가했는지 확인하세요.
Playwright MCP (웹 브라우징)
Playwright MCP를 추가하면 Claude Code가 실제 웹 브라우저를 열어서 웹사이트를 탐색합니다.
claude mcp add playwright -- npx @playwright/mcp@latest
Plain Text
복사
웹사이트 정보 추출:
경쟁사 A의 홈페이지에서 가격표를 가져와서 우리 가격과 비교표를 만들어줘
Plain Text
복사
여러 페이지 조사:
아래 3개 사이트에서 "AI 업무 자동화" 관련 최신 글을 찾아서 요약해줘
- techcrunch.com
- zdnet.co.kr
- bloter.net
Plain Text
복사
로그인이 필요한 사이트 Playwright는 실제 브라우저 창을 열기 때문에, 로그인이 필요한 사이트도 사용 가능합니다. Claude가 로그인 페이지를 열면 직접 로그인하고, 이후 작업은 Claude가 이어서 합니다.
Playwright의 현실적인 한계: JavaScript로 동적 로딩되는 콘텐츠, 봇 차단이 강한 사이트, CAPTCHA가 있는 페이지에서는 원하는 정보를 못 가져올 수 있습니다.
2026.01-02 업데이트
Playwright MCP는 Agent Browser로 대체되었다가, 현재는 둘 다 선택 가능합니다.
취향에 따라 고르시면 됩니다.
웹 검색 MCP
웹 검색 MCP를 추가하면 인터넷에서 정보를 검색해서 작업에 활용합니다. Playwright가 특정 사이트를 직접 방문하는 것이라면, 웹 검색 MCP는 검색엔진으로 정보를 찾는 것입니다.
최근 3개월간 "AI 업무 자동화" 관련 주요 뉴스를 검색해서 정리해줘
Plain Text
복사
Brave Search MCP가 대표적입니다. Brave Search API 키를 발급받아야 합니다.
검색 결과는 반드시 출처 확인 웹 검색 결과를 그대로 믿으면 안 됩니다. 중요한 내용이라면 "출처 URL도 같이 알려줘"라고 요청해서, 원본을 직접 확인하세요.
기타
•
Google Drive MCP: 드라이브의 파일을 직접 읽고 처리. "드라이브의 2024년 보고서 폴더에서 모든 엑셀 파일을 병합해줘" 같은 지시가 가능합니다.
•
Slack MCP: 슬랙 채널의 메시지를 읽고 요약. "이번 주 #공지사항 채널에서 중요한 내용을 정리해줘" 같은 지시가 가능합니다.
MCP 서버의 안정성
종류 | 안정성 | 선택 기준 |
서비스 공식 MCP (Notion, Microsoft 등) | 높음 | 우선 사용 권장 |
GitHub 활동 활발한 오픈소스 | 보통 | Issues 탭 확인 후 |
업데이트 6개월 이상 없는 서버 | 낮음 | 사용 비권장 |
MCP 조합 활용
MCP 서버는 여러 개를 동시에 사용할 수 있습니다.
웹 검색 + 노션:
"2024년 SaaS 시장 트렌드"를 검색해서,
주요 내용을 노션의 "리서치" 페이지에 정리해줘
Plain Text
복사
Playwright + 로컬 파일:
경쟁사 3곳의 홈페이지에서 서비스 가격을 수집하고,
우리 가격표 파일(pricing.xlsx)과 비교해서 분석 보고서를 만들어줘
Plain Text
복사
MCP 조합 시에도 단계별 진행 원칙 MCP 조합 작업에서 중간에 하나가 실패하면 나머지 결과도 다 틀어집니다. "먼저 노션에서 데이터를 가져와줘"로 시작하고, 결과를 확인한 뒤 "이제 매출 데이터와 합쳐줘"로 이어가는 게 안전합니다.
음성으로 Claude Code 사용하기
타이핑 대신 말로 지시할 수 있습니다.
방법 1: 음성 입력 앱 (간단)
Mac에서는 음성 입력 앱을 설치하면 Claude Code 입력창에 받아쓰기할 수 있습니다.
•
MacWhisper: 무료 기본 버전 제공, Pro는 유료. Mac 전용.
•
superwhisper: 유료 구독. Mac/iOS.
이 앱들은 Claude Code뿐 아니라 어디서든 음성 입력이 가능해서, 한번 설치하면 다른 곳에서도 유용합니다.
방법 2: VoiceMode MCP (통합적)
Claude Code 안에서 직접 음성 대화를 할 수 있는 MCP입니다.
•
오픈소스 (MIT 라이선스), github.com/mbailey/voicemode
•
설치: claude mcp add --scope user voicemode -- uvx --refresh voice-mode
처음이라면 방법 1(음성 입력 앱)부터 시작하는 것을 권합니다.
MCP 서버 관리하기
사용하지 않는 서버는 꺼두기
MCP 서버를 추가하면 Claude Code가 시작할 때마다 해당 서버의 도구 정보를 읽어들입니다. 서버가 많아질수록 대화를 시작하기도 전에 컨텍스트가 차게 됩니다.
실제로 쓰는 서버만 활성화하세요 MCP 서버 7개를 활성화해두면 시작하자마자 전체 컨텍스트의 30% 이상이 도구 설명으로 채워집니다. 자주 쓰지 않는 서버는 claude mcp remove <이름>으로 제거하고, 필요할 때 다시 추가하는 것이 효율적입니다.
폴더별로 MCP 나누기
claude mcp add에 --scope 옵션을 쓰면 됩니다:
옵션 | 적용 범위 |
--scope local | 현재 폴더에서만, 나만 사용 |
--scope project | 현재 폴더에서, 팀 전체 공유 |
--scope user | 어디서든, 나만 사용 |
MCP 서버 찾기
MCP 생태계는 빠르게 성장하고 있고, 지금도 새로운 서버가 계속 나오고 있습니다.
새로운 MCP 서버를 찾으려면:
•
claudemcp.com: MCP 서버 디렉토리, 카테고리별 검색
•
mcpcat.io: Claude Code용 추천 MCP 서버 가이드
•
github.com/punkpeye/awesome-mcp-servers: 커뮤니티가 관리하는 MCP 서버 모음
필요한 기능이 있으면 "○○ MCP server"로 검색하면 대부분 찾을 수 있습니다.
직접 해보기
MCP 서버 하나 설치하기 (예: claude mcp add playwright -- npx @playwright/mcp@latest)
/mcp 명령어로 설치된 MCP 서버 목록 확인하기
설치한 MCP를 활용해서 작업 하나 실행해보기
사용하지 않는 MCP 서버가 있으면 제거하기
정리
•
MCP는 Claude Code와 외부 서비스를 연결하는 표준 규격입니다. claude mcp add로 추가하고 /mcp로 확인합니다.
•
설치 실패의 대부분은 Node.js 미설치, API 키 오류, 네트워크 문제입니다. "npx: command not found"가 나오면 Node.js부터 확인하세요.
•
노션, Playwright(웹 브라우징), 웹 검색 등 업무에 유용한 MCP 서버가 있고, 여러 개를 조합하면 복잡한 작업도 한 번에 처리됩니다.
•
서비스 공식 MCP 서버를 우선 사용하고, 개인이 만든 서버는 GitHub 활동 상태를 확인한 뒤 설치합니다.
•
사용하지 않는 서버는 제거하고, 폴더별로 나눠서 관리하면 효율적입니다.