[Claude Code 스킬] MCP 서버 연결 — 터미널 한 줄로 외부 도구를 Claude에 물리기 | DAKER 커뮤니티

무엇

MCP(Model Context Protocol)는 Claude Code와 외부 시스템(DB·API·SaaS)을 잇는 표준 어댑터입니다. USB-C가 노트북과 주변기기를 한 규격으로 묶듯, MCP는 도구마다 제각각인 연결 방식을 하나의 프로토콜로 통일합니다. claude mcp add 한 줄이면 Claude가 그 도구를 '자기 손'처럼 직접 호출할 수 있습니다.

언제 쓰나

사용법

로컬(stdio) 서버 추가 — Claude가 서버를 자식 프로세스로 띄우고 표준입출력(stdin/stdout)으로 대화합니다. 옵션은 모두 서버 이름 앞에 두고, -- 뒤가 실제 실행 명령입니다.

# 옵션(--transport, --scope, --env)은 항상 이름 앞, '--' 뒤는 실행 명령
claude mcp add --transport stdio project-db \
  -- npx -y @modelcontextprotocol/server-postgres postgresql://localhost:5432/mydb

# 원격(HTTP) 서버 — OAuth 인증을 네이티브로 지원
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# 관리 명령
claude mcp list          # 등록된 서버 + 연결 상태
claude mcp get sentry    # 특정 서버 상세
claude mcp remove sentry # 제거

세션 안에서 /mcp를 입력하면 서버 상태가 보입니다. 도구가 0개로 뜨면 대개 인증이 필요한 경우이니 "Authenticate"를 눌러 OAuth를 진행하세요.

팁

스코프는 3단계입니다: local(나만, 기본값) → project(.mcp.json, 팀 공유·git 커밋) → user(내 모든 프로젝트 전역). 우선순위는 local > project > user. 새 서버는 local로 가볍게 실험하고, 검증되면 --scope project로 승격해 팀에 배포하세요.

출처

Redirecting to [Claude Code 스킬] MCP 서버 연결 — 터미널 한 줄로 외부 도구를 Claude에 물리기 | DAKER 커뮤니티...