MCP 서버로 클로드 코드에 외부 도구 연결하기

1단계원격 서버 연결(가장 흔한 방식)

주소(URL)만 있으면 되는 방식이에요.

1. 형식은 이렇습니다.
   복사

   claude mcp add --transport http <name> <url>

2. 예: 노션 연결
   복사

   claude mcp add --transport http notion https://mcp.notion.com/mcp

3. 예: 센트리(에러 모니터링) 연결
   복사

   claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

4. 클로드 코드를 켜고 /mcp 를 쳐서 로그인이 필요한 서버는 여기서 인증해요.
   복사

   /mcp

• 연결하기 전에 믿을 수 있는 서버인지 꼭 확인하세요. 바깥 내용을 가져오는 서버는 그 안에 숨은 지시문에 클로드가 속는 공격(프롬프트 인젝션)의 통로가 될 수 있다고 공식 문서가 경고해요.

2단계내 컴퓨터에서 돌리는 서버

npx 같은 명령으로 서버를 직접 띄우는 방식이에요. -- 뒤가 서버 실행 명령입니다.

1. 형식
   복사

   claude mcp add [options] <name> -- <command> [args...]

2. 예: 에어테이블(키는 환경 변수로 넘겨요)
   복사

   claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
     -- npx -y airtable-mcp-server

• -- 를 빼먹으면 클로드 옵션과 서버 명령이 섞여서 실패해요.

3단계누구에게 적용할지 고르기

1. --scope local (기본): 지금 프로젝트에서 나만 씀
2. --scope project: 프로젝트 폴더의 .mcp.json 에 적혀 팀원과 공유
3. --scope user: 내 모든 프로젝트에서 씀

• API 키가 들어간 연결은 project 범위로 올리지 마세요. .mcp.json이 깃에 올라가면 키가 새요.

4단계관리 명령

1. 연결 목록 보기
   복사

   claude mcp list

2. 한 서버 자세히 보기
   복사

   claude mcp get <name>

3. 연결 지우기
   복사

   claude mcp remove <name>

개발자라면 먼저 붙여 볼 것: Context7