Ch9. 커넥터·MCP·플러그인 — 바깥 세상 연결
이 장을 끝내면 할 수 있는 것: Notion·구글드라이브·GitHub 중 하나를 Claude에 연결해 첫 페이지를 읽거나 쓸 수 있다.
1. Claude는 자기 컴퓨터 안에서만 살지 않는다
Ch1~Ch8에서 우리는 내 컴퓨터 안의 일을 다듬었다. 회의록·메일·일정. 그런데 우리 일의 절반은 컴퓨터 바깥에 있다.
- 노션에 적어둔 회사 위키
- 구글드라이브에 쌓인 자료
- GitHub 저장소의 코드와 이슈
- 이메일(Gmail) 받은 편지함
- 카카오톡·Slack 대화
이걸 매번 복사해서 Claude에 붙여넣는 건 비효율적이다. 차라리 Claude가 직접 들어가 페이지를 읽거나 글을 쓰면 된다.
이걸 가능하게 하는 다리가 3종이다 — 커넥터 → MCP → 플러그인 순서로 진입 장벽이 올라간다.
- 커넥터 — Anthropic이 직접 검수해 Claude 앱에 공식 내장한 외부 서비스 연결 기능. 클릭 한 번.
- MCP — Model Context Protocol. Anthropic이 공개한 AI 도구 연결 오픈 표준. 누구나 서버를 만들어 붙일 수 있다.
- 플러그인 — 스킬·에이전트·MCP·슬래시 커맨드를 한 봉투에 묶은 주제 패키지.
이 장이 책에서 다뤄질 가치는 한 가지다 — 커넥터 1개를 연결하는 순간 Claude가 다루는 자료의 범위가 10배 늘어난다. 비개발자에게 가장 큰 변화는 여기서 한 번 더 일어난다.
커넥터 / MCP / 플러그인 3종이 Claude를 외부 서비스에 연결하는 다이어그램
2. 무엇과 어떻게 다른가
2-1. 커넥터 vs MCP vs 플러그인
| 축 | 커넥터 (클릭 한 번) | MCP (직접 셋업) | 플러그인 (번들) |
|---|---|---|---|
| 진입 장벽 | 매우 낮음 (클릭만) | 높음 (설정 파일 작성) | 보통 (마켓플레이스에서 설치) |
| 자동성 | 자동 | 사용자가 트리거 명시 | 스킬/에이전트와 함께 자동 |
| 적용 범위 | Claude 웹·데스크톱 | 모든 Claude 환경 | 플러그인 호환 환경 |
| 누가 만드나 | Anthropic 공식 | 본인 또는 외부 개발자 | 마켓플레이스 등록자 |
| 비개발자 첫 시도 | ○ (이걸로 시작) | × | △ |
비개발자 진입 순서: 커넥터 → 플러그인 → MCP. 커넥터로 외부 연결의 감을 잡고, 필요해지면 플러그인 설치, 가장 마지막에 MCP 직접 셋업.
2-2. 비개발자가 자주 쓸 커넥터 (2026 기준)
| 커넥터 | 무엇을 가능하게 | 활용 예 |
|---|---|---|
| Notion | 페이지 읽기·쓰기 | "이 회의록 노션에 정리해줘" |
| Google Drive | 파일 검색·읽기 | "최근 받은 PDF 5개 요약해줘" |
| Gmail | 메일 분류·답장 초안 | "주문 확인 메일만 표로" |
| GitHub | 이슈·코드 검색 | "내 레포 이슈 3개 정리" |
| Slack | 채널 메시지 검색·요약 | "이번 주 #general 핵심 5줄" |
이 책의 비개발자 독자는 노션 또는 구글드라이브 1개부터 시작한다. 한 개 연결해 한 번 써보면 다음 연결은 쉽다.
2-3. 인기 플러그인 (2026 기준)
| 플러그인 | 주제 | 누구용 |
|---|---|---|
| anthropic-skills | 🟢 공식 — PDF·Excel·PPT·Webdev·Docx | 입문자 — 시작점 |
| anthropics/cookbook | 🟢 공식 — 예제·튜토리얼 | 학습자 |
| superpowers | 🟡 커뮤니티 — 브레인스토밍·디버깅·TDD | 개발자 |
| oh-my-claudecode | 🟡 커뮤니티 — 에이전트 35종 | Claude Code 파워유저 |
3. ⚠️ 처음 사람들이 자주 막히는 곳
함정 1. API 키 노출
MCP를 직접 셋업할 때 API 키를 설정 파일에 적는다. 이 파일이 GitHub에 올라가거나 누군가에게 공유되면 API 키가 평생 검색되고, 누가 그 키로 우리 계정을 마음대로 쓸 수 있다.
대처:
- API 키는
.env파일에 분리,.gitignore에.env추가 (Ch4 함정 2와 같은 패턴) - MCP 설정 파일에는 "API 키는 환경변수에서" 같은 참조만
- 노출되면 즉시 해당 서비스에서 키 무효화 후 새로 발급
함정 2. 권한을 너무 넓게 — "전체 공유" 클릭
커넥터 연결 시 권한 화면에서 "내 노션 전체에 접근" 같은 옵션을 무심코 승인한다. 그러면 Claude가 회사 위키·개인 일기·비밀 문서까지 모두 볼 수 있다.
대처:
- 필요한 페이지·폴더만 공유. 노션은 페이지 단위, 구글드라이브는 폴더 단위로 권한 가능
- 정기적으로 권한 점검 (한 달에 한 번 Connectors 페이지에서 연결 목록 확인)
- 더 이상 안 쓰는 커넥터는 즉시 해제
함정 3. 커넥터 + MCP 중복
같은 Notion을 커넥터로도 켜고 MCP로도 켜면 Claude가 어느 쪽을 써야 할지 헷갈린다. 응답이 느려지거나 권한 충돌이 생길 수 있다.
대처: 하나만 켠다. 커넥터 목록에 있으면 커넥터, 없을 때만 MCP.
4. 5분 미니 실습 — Notion 커넥터 1개 연결
전제
- 노션 계정이 있다 (없으면 notion.so에서 무료 가입)
- 노션에 테스트용 빈 페이지 1개가 있거나 만들 수 있다
단계
-
claude.ai에서 우상단 프로필 → Settings → Connectors.
✓ 체크포인트: 사용 가능한 커넥터 목록이 보인다.
-
Notion 옆 "Connect" 버튼 클릭.
✓ 체크포인트: 노션 OAuth 권한 화면이 새 창에 뜬다.
-
권한을 **"선택한 페이지만"**으로 좁히고, 테스트용 빈 페이지 1개만 선택.
✓ 체크포인트: 권한 승인 후 Claude로 돌아와 "Connected" 표시.
-
claude.ai 메인으로 돌아가 새 메시지를 던진다.
내 노션의 [페이지 이름] 에 "Hello Claude!" 한 줄 추가해줘.✓ 체크포인트: Claude가 노션 페이지를 갱신했다는 응답이 온다.
-
노션 앱·웹에서 확인한다. 그 페이지에 새 줄이 들어가 있어야 한다.
결과 인증
이 실습을 끝냈다면:
- Claude가 외부 서비스(노션)에 직접 쓰기 동작을 한 첫 경험을 가졌다
- Claude의 자료 범위가 내 컴퓨터를 넘어섰다
- 다음 일에 같은 패턴을 적용할 준비가 됐다 (구글드라이브, GitHub 등)
⚠️ 트러블슈팅
문제 1: 권한 화면에서 페이지가 안 보입니다. → 노션 워크스페이스가 비어 있을 수 있다. 노션에서 빈 페이지 1개를 먼저 만든 뒤 다시 시도.
문제 2: Claude가 "노션을 찾을 수 없다"고 답합니다. → 커넥터 연결이 시간 차로 적용될 수 있다. 1~2분 후 새 대화창에서 다시 시도.
문제 3: 의도하지 않은 페이지를 갱신해버렸습니다. → 커넥터 권한을 다시 점검 (Settings → Connectors → Notion → "Manage permissions"). 페이지 단위로 좁힌다.
다음 장으로: Ch10에서는 같은 노션 작업을 **자동 호출되는 매뉴얼 — 스킬(Skills)**로 바꾼다. 매주 같은 4공식을 다시 안 적어도, 한 키워드로 자동 발동.
© 2026 COMMME · Built with Claude Code