topic★★★★★난이도 · 약 18분

MCP — 외부 서비스와 연결하기

Model Context Protocol — DB, API, 파일 시스템 등 외부 서비스를 AI에게 연결하는 표준 프로토콜.

#MCP#Model Context Protocol#외부 서비스#Supabase

왜 배우는가

Claude Code의 기본 도구만으로는 데이터베이스 조회, 외부 API 호출, 웹 검색 등을 할 수 없다. MCP를 통해 외부 서비스를 연결하면 AI의 활용 범위가 비약적으로 넓어진다.

MCP(Model Context Protocol)는 AI 에이전트가 외부 도구·서비스에 접근할 수 있게 하는 표준 프로토콜이다. USB처럼 한 번 연결하면 AI가 해당 서비스를 자유롭게 사용할 수 있다.

도구 사용 확장 — MCP 서버가 DB·API·외부 서비스를 AI의 도구 목록에 추가한다

MCP 서버	기능	활용 예시
Supabase	PostgreSQL DB 조작	테이블 생성, 데이터 조회, 마이그레이션
Fetch	HTTP 요청	외부 API 호출, 웹페이지 내용 가져오기
GitHub	저장소 관리	PR 생성, 이슈 조회, 코드 리뷰
파일 시스템	로컬 파일 접근	설정 파일 읽기, 로그 분석
Slack	메시지 전송	배포 알림, 에러 보고

bash

# MCP 서버 추가 (npx 방식)
claude mcp add supabase -- npx -y @supabase/mcp-server

# MCP 서버 추가 (scope 지정)
claude mcp add --scope user fetch -- npx -y @anthropic/fetch-mcp

# 설치된 MCP 목록 확인
claude mcp list

# MCP 서버 제거
claude mcp remove fetch

claude mcp add 명령어로 MCP 서버를 등록한다. --scope user는 모든 프로젝트에서 사용 가능하게 하고, 생략하면 현재 프로젝트에만 적용된다.

MCP의 동작 원리 — (1) 사용자가 MCP 서버를 등록하면 Claude Code가 서버 프로세스를 실행한다. (2) AI가 외부 서비스 접근이 필요하면 MCP 도구를 호출한다. (3) MCP 서버가 실제 서비스(DB, API 등)와 통신하고 결과를 AI에게 반환한다.

bash

# Windows에서 MCP 설치가 안 될 때 — cmd 래퍼 사용
claude mcp add-json supabase -s user '{
  "type": "stdio",
  "command": "cmd",
  "args": ["/c", "npx", "-y", "@supabase/mcp-server"]
}'

# 설치 후 검증
claude mcp list
# → supabase: connected 확인

Windows 환경에서는 npx 직접 호출이 실패할 수 있다. cmd 래퍼로 감싸면 대부분 해결된다.