MCP 통합: Claude Code를 외부 세계와 연결한다

네트워크 연구자 멧칼프가 발견한 법칙: "네트워크의 가치는 연결된 노드 수의 제곱에 비례한다."

전화기가 1대만 있으면 쓸모없지만, 10대가 연결되면 45개의 연결이 생기고, 100만 대가 연결되면 5,000억 개의 연결이 생깁니다.

MCP 서버도 같습니다. Supabase MCP를 연결하면 자연어로 DB를 조작할 수 있고, GitHub MCP를 더하면 코드 커밋도 자동화됩니다. 연결이 늘수록 Claude Code의 능력이 제곱으로 커집니다.

Taskmaster는 "MCP 우선"으로 설계됐고, 우리 5파일+는 "Claude Code 직접 통합"으로 사용합니다. 둘 다 MCP의 동일한 가치 (외부 시스템 자연어 통신)를 활용합니다.

줍줍 (B2C 앱)

• 필수 — Supabase + GitHub + Playwright (3개)
• 선택 — Slack (앱스토어 심사 알림용)

TotalSportsView (미디어 플랫폼)

• 필수 — Supabase + GitHub + Playwright (3개)
• 필수 — Sentry (운영 모니터링, R12~R14 트리거)
• 선택 — Cloudflare (WAF 관리, 보안 강화)
• 선택 — Brave Search (리그 외부 정보 수집)

두 프로젝트 모두 3~5개 MCP가 적정선입니다. 더 많이 설치하면 비용이 증가하고 컨텍스트가 무거워집니다.

[Claude Code에서, Supabase + Filesystem MCP 활성]
"기업마당 API에서 최근 7일 공고 50개를 가져와서 LLM 분류 후
benefits 테이블에 시딩해줘. confidence 0.7 미만 필드는 NULL 처리.

진행 상황을 매 10건마다 보고해줘."

→ Claude의 처리 흐름:

1. Filesystem MCP로 LLM 분류 프롬프트 lib/parser/prompts.ts 읽음
2. fetch로 기업마당 API 호출 (50건)
3. 50건 각각 LLM 분류 (Sonnet 4.6)
4. Supabase MCP로 benefits 테이블에 INSERT (UNIQUE name+deadline)
5. confidence 분포 보고 + 검수 큐 5건 알림

[Claude Code에서, Supabase + GitHub MCP 활성]
"마이페이지의 *내가 줍줍한 지원금 총액* 쿼리를 작성하고 git commit해줘.

쿼리는 SUM(benefits.total_jupjups WHERE jupjups.user_id = X)이 아니라
직접 jupjups 테이블에서 user_id별 COUNT + 평균 days_taken으로.
이유: BUILD.md Day 17 LogOnTable 트레이스 참조."

→ Claude가 두 MCP를 결합:

1. Supabase MCP로 쿼리 작성 + EXPLAIN ANALYZE
2. GitHub MCP로 git add + commit
3. BUILD.md Day 17 트레이스 자동 갱신 (LogOnTable 4 요소)

[Claude Code에서, Supabase + Filesystem + Playwright MCP 활성]
"lib/match_facts.ts의 SSOT 인터페이스를 만들고, 자동 일관성 테스트
tests/persona_consistency.test.ts 5개 케이스를 Playwright로 작성해줘.

페르소나 system prompt에 cache_control 추가도 같이.

CLAUDE.md §5 Project-Specific Rules의 7개 규칙을 모두 준수."

→ Claude가 세 MCP를 결합:

1. Filesystem MCP로 lib/match_facts.ts 작성 (14줄, stats optional)
2. Supabase MCP로 EPL 5경기 sample 데이터 가져옴
3. Playwright MCP로 5 페르소나 일관성 테스트 작성
4. cache_control 헤더 추가 (ANTHROPIC_API_BETA)
5. CLAUDE.md §5 7개 규칙 검증 → 모두 PASS

[Claude Code에서, Sentry MCP 활성]
"Sentry에서 최근 1시간 동안 페르소나 자동 일관성 테스트 fail이
1건이라도 발생하면 cron/publish.ts를 정지하는 헤드리스 스크립트를
.claude/commands/persona-emergency.md에 작성해줘."

→ Claude의 처리:

1. Sentry MCP로 실시간 에러 모니터링 쿼리 작성
2. .claude/commands/persona-emergency.md 작성 (헤드리스)
3. CLAUDE.md §3 Critical Constraints에 추가 (테스트 fail = 자동 정지)

[원칙 1] MCP 호출 = 5파일 갱신 (둘 다 필수)

[원칙 2] LogOnTable 트레이스 = MCP 호출의 "왜" 보존

[원칙 3] CLAUDE.md §7 Common Commands에 자주 쓰는 MCP 자연어 명령 명시

[원칙 4] CLAUDE.md §3 Critical Constraints에 MCP 권한 한계 명시
예: "Supabase MCP는 SELECT만 자동 허용, INSERT/UPDATE/DELETE는 명시적 확인"