첫 MCP 서버 추가하기
Claude Code를 GitHub, 데이터베이스 등에 연결하는 명령 하나
⏱ 예상 ~6분
01 · 읽기
Claude Code 에 MCP 서버를 추가하는 건 명령 하나예요. claude mcp add 다음에 이름과 URL (HTTP 의 경우) 또는 명령 (stdio 의 경우) 을 적어요.
추가하고 나면 그 서버가 노출하는 모든 도구를 Claude가 자동으로 쓸 수 있어요. 코드 변경, 설정 파일, 재시작 다 필요 없어요. 추가하면 바로 Claude에게 쓰라고 시킬 수 있어요.
핵심 정리
- claude mcp add 가 서버를 추가하는 메인 명령이에요
- HTTP 서버는 이름과 URL 이 필요해요
- Stdio 서버는 이름과 실행할 명령이 필요해요
- --transport, --env, --scope 같은 옵션은 서버 이름 앞에 와야 해요
02 · 코드 예제
아래는 원격 HTTP 서버를 추가하는 방법이에요 - 가장 흔한 타입이죠. 이 예시는 Claude를 GitHub에 연결해요.
GitHub MCP 서버 추가하기
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
Notion MCP 서버 추가하기
claude mcp add --transport http notion https://mcp.notion.com/mcp
인증 헤더 추가하기
claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer your-token"
패턴은 항상 같아요: claude mcp add --transport http <name> <url>. Name 은 나중에 이 서버를 참조하는 이름이에요. URL 은 MCP 서버가 사는 곳이고요. 서버가 토큰이 필요하면 --header 로 인증 헤더를 추가해요.
03 · 코드 예제
Stdio 서버는 로컬 프로세스를 실행해요. 이 예시는 dbhub 패키지로 Claude를 PostgreSQL 데이터베이스에 연결해요.
PostgreSQL 서버 추가하기
claude mcp add --transport stdio db \
-- npx -y @bytebase/dbhub \
--dsn "postgresql://readonly:pass@localhost:5432/mydb"
환경변수와 함께 추가하기
claude mcp add --transport stdio airtable \
--env AIRTABLE_API_KEY=YOUR_KEY \
-- npx -y airtable-mcp-server
-- (이중 dash) 는 Claude 의 옵션과 서버의 명령 및 인자를 구분해요. -- 뒤의 모든 게 MCP 서버를 실행하는 명령이에요. API key 는 하드코딩하지 말고 --env 로 환경변수로 안전하게 전달해요.
04 · 단계별 설명
1. 서버 선택하기
어떤 MCP 서버를 추가할지 결정해요. HTTP 서버는 서버의 URL 이 필요해요. Stdio 서버는 npm 패키지 이름이나 명령이 필요해요. 공식 MCP 서버 목록이나 서비스의 문서를 봐요.
2. claude mcp add 실행하기
원격 서버는 claude mcp add --transport http <name> <url>, 로컬은 claude mcp add --transport stdio <name> -- <command>. 기억해요: 모든 옵션은 name 앞에 오고, -- 가 서버 명령을 구분해요.
3. 연결 확인하기
claude mcp list 를 실행해서 설정된 모든 서버를 보거나, Claude Code 안에서 /mcp 로 상태와 인증을 봐요. 녹색 상태는 서버가 연결되어 준비된 거예요.
4. Claude에게 쓰라고 시키기
Claude Code 대화를 시작하고 그 서버가 필요한 질문을 해요. GitHub: "내 열려 있는 PR 을 보여줘." 데이터베이스: "어떤 테이블들이 있어?" Claude가 서버의 도구를 자동으로 발견해요.
05 · 퀴즈
DATABASE_URL 환경변수가 필요한 로컬 데이터베이스 서버를 추가하려고 해요. 플래그 순서가 중요해요. 어느 명령이 맞을까요?
- claude mcp add --transport stdio --env DATABASE_URL=... db -- npx dbhub
- claude mcp add db --transport stdio --env DATABASE_URL=... -- npx dbhub
- claude mcp add --transport stdio db -- npx dbhub --env DATABASE_URL=...
- claude mcp add -- npx dbhub --transport stdio db
06 · 빈칸 채우기
설정된 모든 MCP 서버를 나열하려면 claude mcp _____ 를 실행해요
⚠ 전체 인터랙티브 경험에는 JavaScript가 필요해요. JavaScript를 켜고 새로 고침해 주세요.
※ 이 사이트는 독립 운영되는 교육 프로젝트로, Anthropic의 공식 제품이 아니에요. Claude™ 는 Anthropic, PBC 의 상표예요.