Claude Code에 MCP 서버 추가하는 방법(claude mcp add)

claude mcp add로 Claude Code에 로컬 및 원격 MCP 서버를 추가하고, 범위를 선택하고, /mcp로 확인합니다.

로컬(stdio) 서버 추가

claude CLI로 서버를 등록합니다. -- 뒤의 내용이 서버를 실행하는 명령입니다:

claude mcp add --transport stdio airtable -- npx -y airtable-mcp-server

환경 변수는 -- 앞에 --env KEY=value로 전달합니다.

https:// 엔드포인트에는 HTTP 전송을 사용합니다:

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

기본값은 local 범위(나만, 이 프로젝트에서만)입니다. --scope project는 프로젝트에서 공유하는 .mcp.json에 기록하고, --scope user는 모든 프로젝트에서 쓸 수 있게 합니다.

Claude Code 세션에서 /mcp를 실행하면 연결된 서버와 도구가 표시됩니다.