Claude Code 사용 가이드 | 터미널, IDE & 웹을 위한 AI 코딩 에이전트

MCP란?

Model Context Protocol(MCP)은 Claude Code를 외부 도구 및 데이터 소스에 연결하는 오픈 프로토콜입니다. AI를 위한 USB 포트라고 생각하세요 — 데이터베이스, API, 브라우저 및 모든 커스텀 도구를 연결하여 Claude의 기능을 확장합니다.

🚀 연결할 수 있는 것들

Supabase 데이터베이스 작업
GitHub 이슈 및 PR 관리
Slack 팀 커뮤니케이션
파일 시스템 작업

PostgreSQL 데이터베이스 관리
Notion 페이지 및 문서 관리
웹 브라우저 자동화
MCP 서버가 있는 모든 도구

💡 작동 방식: 'claude mcp add'로 서버를 연결하거나, 프로젝트에 .mcp.json을 설정하세요. Claude가 사용 가능한 도구를 발견하고 요청에 관련될 때 사용합니다.

NEW in 2.1

🔍 MCP 도구 검색 (자동 모드)

MCP 도구가 컨텍스트의 10%를 초과하면 자동으로 지연 로드됩니다. Claude가 필요할 때 적절한 도구를 검색하여 상당한 컨텍스트 윈도우 공간을 절약합니다.

임계값 설정: mcpToolSearch: 'auto:N' (N = 0-100 퍼센트)

UPDATED

🔗 전송 프로토콜

HTTP가 권장 전송 프로토콜입니다. SSE(Server-Sent Events)는 지원 중단되었습니다. 로컬 프로세스를 위한 stdio와 실시간 연결을 위한 WebSocket(ws)도 지원합니다.

// New HTTP transport (Recommended)"url": "http://localhost:3000/mcp""transport": "http"

// SSE transport - DEPRECATED

NEW

@ MCP 리소스 멘션

@ 구문을 사용하여 프롬프트에서 MCP 리소스를 직접 참조하세요. Claude가 리소스를 해석하고 내용을 포함합니다.

claude> @database/users @supabase://tables/users — 테이블 구조 분석

claude> @github/issues @github://issues?state=open — 최근 이슈 보기

NEW

/ MCP 프롬프트를 슬래시 명령어로

MCP 서버 프롬프트가 자동으로 슬래시 명령어로 등록됩니다. /를 입력하면 연결된 서버의 사용 가능한 명령어를 볼 수 있습니다.

/supabase/create-migration, /github/review-pr

MCP 프로토콜 튜토리얼

Supabase MCP 마스터하기

Supabase를 Claude Code에 연결하여 전체 백엔드 개발 워크플로우를 자동화하세요.

1. 빠른 설정

claude mcp add supabase-e SUPABASE_ACCESS_TOKEN=your_tokennpx -y @supabase/mcp-server-supabase@latest

Supabase 개인 액세스 토큰으로 연결 (설정 > 액세스 토큰에서 생성)

2. 실전 사용 예시

claude> 블로그 포스트를 저장할 테이블을 만들어줘

스키마 설계 > 테이블 생성 > RLS 정책 설정

claude> 사용자 인증 Edge Function을 만들고 배포해줘

함수 작성 > 테스트 > 실시간 배포

claude> 현재 데이터베이스 사용량과 비용을 분석해줘

사용량 조회 > 비용 계산 > 최적화 제안

claude> users 테이블에 실시간 구독을 설정해줘

Realtime 활성화 > 구독 설정 > 이벤트 리스너 생성

🚀 프로 팁: '데이터베이스 비용 분석해줘', '느린 쿼리 최적화해줘' 같은 고급 명령도 사용 가능합니다!

완전 자동화 워크플로우

GitHub + Supabase + Slack을 연결하여 전체 사이클을 자동화: 이슈 > 코드 수정 > 배포 > 팀 알림.

1

GitHub 연결

claude mcp add github

2

Supabase 연결

claude mcp add supabase

3

Slack 연결

claude mcp add slack

🎯 전체 자동화 예시

claude>GitHub 이슈 #42를 분석해서 수정하고, 배포 후 Slack #dev에 알려줘

이슈 내용 분석 및 관련 코드 파일 찾기

버그 수정 코드 작성 및 테스트

GitHub에 PR 생성 및 머지

Supabase에 Edge Function 배포

Slack 채널에 완료 알림 전송

💡 추가 워크플로우 예시

▸

매일 오전 9시에 데이터베이스 백업하고 Slack에 결과 알려줘

정기 백업 자동화

▸

새 PR이 열리면 자동으로 테스트 실행하고 결과를 코멘트로 달아줘

CI/CD 자동화

▸

데이터베이스 성능이 느려지면 자동으로 최적화하고 팀에 보고해줘

성능 모니터링 자동화

⚡ 실제 사례: 팀들이 MCP 기반 자동화 워크플로우를 사용하여 버그 수정 시간을 수 시간에서 수 분으로 단축했다고 보고합니다.

MCP 프로토콜 가이드

MCP란?

🚀 연결할 수 있는 것들

🔍 MCP 도구 검색 (자동 모드)

🔗 전송 프로토콜

@ MCP 리소스 멘션

/ MCP 프롬프트를 슬래시 명령어로

인기 MCP 서버

🔥 필수 MCP 서버

Supabase MCP

GitHub MCP

💎 고가치 MCP 서버

Slack MCP

PostgreSQL MCP