direcf / Claude Code 스킬 생태계 & 전문가 워크플로 완전 가이드 / Ch05
GitHub ↗
CHAPTER 05 OF 10
🔗

Integration Skills — Claude Talks to Everything

통합 스킬 — Claude가 모든 서비스와 대화한다

Composio와 MCP 서버의 차이를 이해하고, 실제 외부 서비스(GitHub, Slack, Notion, DB)와 Claude를 연결하는 방법을 마스터한다.

Integration Skills — Claude Talks to Everything cheatsheet
🍌 NANO BANANA CHEATSHEET · CH 05

Overview

개관

Claude Code를 다른 AI 코딩 도구와 가르는 가장 큰 차별점 중 하나: 외부 세계와의 연결.

MCP(Model Context Protocol): Anthropic이 설계한 표준 통합 프로토콜. Claude Code에 MCP 서버를 추가하면 Claude가 그 서버의 도구를 직접 호출할 수 있다. GitHub MCP는 이슈와 PR을 직접 읽고 생성하고, DB MCP는 실시간 스키마를 조회하고 쿼리를 실행한다.

Composio: MCP와 다른 접근. 100+ 외부 서비스 API를 에이전트가 호출 가능한 구조화된 도구로 표준화한다. MCP 서버 설정 없이도 GitHub, Slack, Notion을 Claude가 사용할 수 있다.

🎯 Learning Goals
  • Composio와 MCP의 차이를 설명하고 상황에 맞게 선택할 수 있다
  • claude mcp add 로 MCP 서버를 추가하고 동작을 확인한다
  • GitHub MCP로 이슈, PR, 코드를 대화 중 직접 참조한다
  • DB MCP로 스키마를 실시간 조회하면서 SQL을 작성한다

Sections

본문

MCP vs Composio — 선택 기준

MCP 선택: 특정 서비스와 깊은 통합이 필요할 때. GitHub MCP는 PR 댓글 작성, 브랜치 생성, 파일 직접 수정까지 가능하다.

Composio 선택: 여러 서비스를 빠르게 연결할 때. 100+ 서비스가 미리 구현되어 있고, 인증을 Composio가 관리한다.

처음 시작: GitHub MCP + Filesystem MCP 두 개만으로 생산성이 극적으로 올라간다.

GitHub MCP 실전 설정

MCP 서버 추가: claude mcp add github -- npx -y @modelcontextprotocol/server-github

설정 후 가능한 것들:

  • '이 버그 관련 이슈 있어?' → Claude가 직접 GitHub Issues 검색
  • 'PR #234 리뷰해줘' → PR diff를 직접 가져와 코드 리뷰
  • '이 기능 이슈 만들어줘' → 대화 내용 기반으로 이슈 자동 생성

DB MCP — 살아있는 스키마

DB MCP를 설정하면 Claude가 실제 데이터베이스 스키마를 실시간으로 읽는다. 가짜 스키마를 보여주거나 설명할 필요가 없다.

'users 테이블과 orders를 조인하는 쿼리 작성해줘' → Claude가 실제 컬럼, 인덱스, 외래키를 보고 정확한 쿼리를 생성한다.

💡 Analogy · 비유
Claude에게 인터넷을 연결하는 것

MCP와 Composio 없는 Claude는 인터넷이 끊긴 컴퓨터다. 파일은 읽을 수 있지만 외부 세계와 대화할 수 없다. MCP를 추가하는 것은 Claude에게 인터넷을 연결하는 것이다. 이 순간부터 Claude는 실시간 데이터로 일한다.

핵심 MCP 서버 설치 명령어 모음

bash
# GitHub MCP — PR, 이슈, 코드 직접 접근
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# Filesystem MCP — 확장된 파일 시스템 접근
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /Users/username/projects

# PostgreSQL MCP — 실시간 DB 스키마 조회
claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres postgresql://localhost/mydb

# Brave Search MCP — 웹 검색 (latest docs 조회)
claude mcp add brave-search -- npx -y @modelcontextprotocol/server-brave-search

# 추가된 MCP 서버 확인
claude mcp list

# 특정 MCP 서버 제거
claude mcp remove github

각 MCP 서버는 독립된 프로세스로 실행된다. Claude는 이 서버들의 도구를 발견하고 필요에 따라 직접 호출한다. 추가된 서버는 claude mcp list로 확인할 수 있다.

🏭 현업에서의 평가
MCP 없이 Claude Code를 쓰는 것은 하이엔드 카메라에 렌즈 하나만 끼운 것과 같다. 좋은 바디지만 진정한 성능은 나오지 않는다. MCP 서버가 얼마나 잘 구성되어 있는지가 Claude Code 파워 유저를 가르는 기준이 된다.

✅ 시니어가 보는 것

  • 자주 참조하는 외부 서비스가 MCP로 연결되어 있는가
  • .mcp.json이 프로젝트에 맞게 스코핑되어 있는가
  • 인증 정보가 안전하게 관리되고 있는가

Key Takeaways

핵심 정리

MCP = Claude의 인터넷

추가 즉시 Claude가 실시간 데이터로 일하기 시작한다.

처음엔 GitHub + Filesystem MCP 두 개만

이 두 개만으로 생산성이 극적으로 올라간다. 점진적으로 확장.

DB MCP는 읽기 전용 복제본에 연결

실수로 프로덕션 데이터를 수정하는 위험을 원천 차단한다.

← Ch04 · DevOps & Infrastructure Skills Ch06 · CLAUDE.md Mastery — Context Engineering →