MCP 서버 관리하고 공유하기
scope 로 서버 정리하고 팀과 공유하기
⏱ 예상 ~5분
01 · 읽기
MCP 서버를 추가할 때 scope 를 선택해서 누가 볼 수 있고 어디에 저장될지 결정해요.
Local (기본값) - 비공개, 현재 프로젝트만. ~/.claude.json 의 프로젝트 경로 아래에 저장돼요. 개인 개발 서버나 민감한 자격증명을 가진 서버에 써요.
Project - repo 루트의 .mcp.json 을 통해 팀과 공유돼요. Git 에 커밋되어, repo 를 clone 하는 모두가 같은 서버를 받아요. 팀 표준 도구에 써요.
User - 내 모든 프로젝트에서 사용 가능해요. ~/.claude.json 에 저장돼요. 내가 어디서나 쓰는 개인 도구 (GitHub 나 개인 데이터베이스 같은 것) 에 좋아요.
핵심 정리
- Local (기본값): 비공개, 현재 프로젝트만
- Project: repo 안의 .mcp.json 으로 팀과 공유, git 에 커밋
- User: 개인용, 내 모든 프로젝트에서 사용 가능
- --scope local|project|user 로 선택해요
02 · 코드 예제
--scope 플래그가 서버 설정이 어디에 저장될지를 제어해요.
Local scope (기본값 - 나만, 이 프로젝트)
claude mcp add --transport http stripe https://mcp.stripe.com
Project scope (git 으로 팀과 공유)
claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp
User scope (나, 모든 프로젝트)
claude mcp add --transport http github --scope user https://api.githubcopilot.com/mcp/
Local 이 기본값이에요 - --scope local 을 쓸 필요가 없어요. Project scope 는 repo 에 .mcp.json 파일을 만들고, 팀원이 pull 할 때 같이 받아요. User scope 는 홈 디렉토리 설정에 들어가고, 어디서나 따라다녀요.
03 · 코드 예제
--scope project 를 쓰면 Claude Code가 repo 루트에 .mcp.json 파일을 만들어요. 이렇게 생겼어요 - git 에 커밋할 수 있어요.
.mcp.json (repo 에 커밋)
{
"mcpServers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/"
},
"db": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@bytebase/dbhub", "--dsn", "${DATABASE_URL}"],
"env": {
"DATABASE_URL": "${DATABASE_URL}"
}
}
}
}
${DATABASE_URL} 문법을 봐요 - 환경변수가 런타임에 확장돼서, 비밀을 노출하지 않고 설정을 공유할 수 있어요. 각 팀원이 자기 환경에 DATABASE_URL 을 설정해요. 파일 구조는 Claude Code가 자동으로 읽는 표준 형식을 따라요.
04 · 읽기
서버가 설정되면 몇 가지 간단한 명령으로 관리해요.
claude mcp list 는 모든 서버를 보여줘요. claude mcp get <name> 은 한 서버의 세부 정보를 보여줘요. claude mcp remove <name> 은 서버를 제거해요.
Claude Code 안에서 /mcp 를 타이핑하면 서버 상태를 보고, OAuth 서버와 인증하고, 연결 문제를 해결할 수 있어요. 서버가 응답하지 않을 때 /mcp 가 가장 먼저 진단할 곳이에요.
핵심 정리
- claude mcp list - 설정된 모든 서버 보기
- claude mcp get <name> - 한 서버의 세부 정보
- claude mcp remove <name> - 서버 제거
- Claude Code 안의 /mcp - 상태, 인증, 문제 해결
05 · 퀴즈
팀원 모두가 같은 Sentry MCP 서버를 써야 해요. 설정을 git 에 커밋해서 새 팀원이 자동으로 받게 하고 싶어요. 어떤 scope 를 쓰나요?
- Local (기본값)
- Project
- User
- Global
06 · 분류 드래그
설정할 세 개의 다른 MCP 서버가 있어요. 각각을 누가 필요로 하는지 보고 맞는 scope 에 매칭해 봐요.
(이 섹션은 인터랙티브해요 — JavaScript를 켜 주세요.)
⚠ 전체 인터랙티브 경험에는 JavaScript가 필요해요. JavaScript를 켜고 새로 고침해 주세요.
※ 이 사이트는 독립 운영되는 교육 프로젝트로, Anthropic의 공식 제품이 아니에요. Claude™ 는 Anthropic, PBC 의 상표예요.