클로드 MCP 연결·사용법: 커넥터 추가하는 4가지 방법

MCP(Model Context Protocol)가 무엇인지 알았다면, 다음은 "그래서 어떻게 연결하나"입니다. 클로드에 MCP를 연결하는 방법은 크게 네 가지이며, 가장 쉬운 디렉토리 커넥터부터 개발자용 Claude Code까지 단계가 다릅니다. (MCP의 개념 자체가 궁금하면 MCP란?를 먼저 보세요.)

방법 1. 디렉토리 커넥터 (가장 쉬움)

Google Drive, Slack, GitHub처럼 이미 준비된 인기 커넥터는 클릭 몇 번이면 됩니다.

1. 채팅 입력창 왼쪽 아래의 "+" 버튼을 누르거나 "/"를 입력해 메뉴를 엽니다.
2. Connectors(커넥터)를 선택하면 커넥터 디렉토리가 열립니다. 카테고리별로 보거나 전체 목록을 훑어볼 수 있습니다.
3. 원하는 앱을 선택하고 인증(OAuth) 로그인을 마칩니다. 연결 시 요청되는 접근 권한을 꼭 확인하세요.

연결 후에는 매번 앱 이름을 부르지 않아도, 요청에 맞으면 클로드가 알아서 해당 도구를 대화에 끌어옵니다. claude.ai, Claude Desktop, iOS·Android 앱에서 디렉토리를 이용할 수 있습니다.

📍 정확한 버튼 위치(2026년 공식 기준): Anthropic 커넥터 공식 도움말에 따르면, 디렉토리 커넥터는 Customize(맞춤설정) > Connectors(또는 주소창에 claude.ai/settings/connectors 입력)에서도 추가할 수 있습니다. Connectors 옆 "+" 버튼을 누르고, 원하는 서비스를 클릭한 뒤 "Connect"(또는 "Install")를 누르면 됩니다. 디렉토리 커넥터는 무료 플랜 포함 모든 플랜에서, 커스텀 커넥터는 무료 1개·유료 다수까지 가능합니다.

방법 2. 커스텀 커넥터 — 원격 MCP 서버

직접 만든 서버나 사내 서비스를 연결하려면 커스텀 커넥터를 씁니다.

1. Customize(맞춤설정) > Connectors(커넥터)로 이동합니다(또는 주소창에 claude.ai/settings/connectors 입력).
2. "커스텀 커넥터 추가(Add custom connector)"를 선택합니다.
3. 서버 URL(예: https://your-server.example.com/mcp)과 필요한 인증 정보를 입력합니다.

⚠️ 중요: 커스텀 커넥터는 Anthropic 클라우드에서 여러분의 서버로 연결합니다(내 PC가 아님). 따라서 서버가 공개 인터넷에서 접근 가능해야 하며, 방화벽·VPN·사내망 뒤에 있으면 연결되지 않습니다. 전송 방식은 Streamable HTTP를 권장합니다(SSE는 추후 단계적 폐지 가능). 또한 커스텀 커넥터는 Anthropic이 검증하지 않은 서비스에 연결하는 것이므로, 신뢰할 수 있는 조직의 서버만 연결하고 권한을 신중히 검토하세요.

방법 3. 로컬 MCP 서버 — Claude Desktop

내 컴퓨터에서 실행되는 로컬 도구·파일에 접근하려면 Claude Desktop의 설정 파일을 사용합니다(원격 커넥터와는 별개 메커니즘이며 stdio로 로컬 실행).

설정 파일 위치:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

예시(파일시스템 서버 연결):

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    }
  }
}

저장 후 Claude Desktop을 재시작하면 됩니다. 채팅창 "+" > Connectors에서 연결된 MCP 서버와 도구를 확인할 수 있고, .mcpb 형식의 데스크톱 확장으로 설치하는 방법도 있습니다. 단, 로컬 MCP는 claude.ai 웹이나 Cowork에서는 쓸 수 없습니다.

방법 4. Claude Code (개발자·터미널)

터미널에서 작업한다면 한 줄로 MCP 서버를 추가합니다.

# 기본 형식
claude mcp add --transport http <name> <url>

# 예: Notion 연결
claude mcp add --transport http notion https://mcp.notion.com/mcp

인증이 필요한 서버는 OAuth 2.0을 지원합니다. 서버가 401/403을 반환하면 /mcp 명령에서 인증 흐름을 완료할 수 있습니다. 원격 연결에는 HTTP 전송이 가장 널리 지원됩니다.

이 밖에 Claude API의 MCP connector로도 Messages API에서 공개 HTTP MCP 서버에 직접 연결할 수 있습니다(개발자용, 자세한 건 platform.claude.com 문서).

Claude Code에서 커스텀 커넥터를 직접 추가하는 단계별 방법(원격 HTTP·로컬 stdio·범위·인증·자주 막히는 지점)은 Claude Code에 커스텀 커넥터 추가하기에서 더 자세히 다룹니다.

터미널에서 자주 쓰는 팁

• 로컬 서버는 -- 뒤에 실행 명령: 원격은 위처럼 --transport http를 쓰고, 로컬 서버는 claude mcp add <이름> -- npx -y @modelcontextprotocol/server-filesystem ~/projects처럼 실행 명령을 -- 뒤에 붙입니다.
• 윈도우에서 npx는 cmd /c로 감싸기: 예) claude mcp add my-tool -- cmd /c npx -y <패키지>
• 연결이 끊겼을 때: claude mcp list에서 서버가 disconnected로 보이면 클로드 코드를 재시작해 보세요.
• 도구가 너무 많으면 컨텍스트를 잡아먹습니다: 도구 정의가 컨텍스트 윈도우의 약 10%를 넘으면 Tool Search가 자동으로 필요한 도구만 불러옵니다.
• 프로덕션 데이터베이스는 읽기 전용 계정으로 연결하세요(실수로 쓰기·삭제가 일어나지 않도록).

인기 커넥터

디렉토리에서 자주 쓰이는 커넥터로는 Google Drive, Slack, GitHub, Notion 등이 있습니다. 각 커넥터 페이지에서 읽기/쓰기 권한과 사용 가능 여부를 확인할 수 있습니다. (특정 순위가 아니라 대표적인 예시입니다.)

보안 체크

• 신뢰할 수 있는 서버만 연결하세요. 커스텀/미검증 서버는 클로드가 그 서비스에서 데이터를 읽고 작업을 수행할 수 있습니다.
• 연결 시 요청되는 접근 권한을 검토하세요. 원본에서 볼 권한이 있는 데이터만 동기화됩니다.
• 모든 데이터 전송은 암호화됩니다.

고지: 메뉴·경로·전송 방식은 클라이언트 버전과 플랜에 따라 다르고 수시로 바뀔 수 있습니다. 이 글은 작성 시점의 Anthropic 공식 안내(support.claude.com, code.claude.com, platform.claude.com)를 기준으로 합니다. 가장 정확한 최신 정보는 공식 문서에서 확인하세요. 본 사이트는 Anthropic 공식 사이트가 아닙니다.

자주 묻는 질문

클로드에 커넥터를 어떻게 추가하나요?

가장 쉬운 방법은 Claude 앱의 디렉토리 커넥터에서 원하는 서비스를 켜는 것입니다. 클릭 몇 번으로 연결되며 개발 지식이 필요 없습니다. 더 자유로운 연결이 필요하면 커스텀 커넥터나 Claude Code를 씁니다.

커스텀 커넥터는 어떻게 추가하나요?

원격 MCP 서버의 URL을 입력하고 필요한 인증(보통 OAuth 또는 API 키)을 거치면 됩니다. 다만 커스텀 커넥터는 Anthropic이 검증하지 않으므로, 신뢰할 수 있는 서버인지 먼저 확인해야 합니다.

어떤 서버를 연결할 수 있나요?

용도별 대표 서버 예시는 추천 MCP 서버 모음에, 찾는 경로는 MCP 서버 찾는 법에 정리했습니다.

커넥터 연결이 안 될 때는요?

인증 만료, URL 오류, 서버 다운 등이 흔한 원인입니다. 증상별 점검은 MCP 서버 문제 해결을 참고하세요.

커넥터가 안전한가요?

디렉토리 커넥터는 비교적 안전하지만, 커스텀 커넥터는 출처를 신뢰할 수 있을 때만 연결해야 합니다. 권한은 최소화하고, 안전 수칙은 커넥터 보안 주의점에서 확인하세요.

더 보기: Claude Code MCP 설정 · 추천 MCP 서버 모음 · 안전하게 쓰려면 커넥터 보안 주의점 · 처음이라면 MCP가 뭔가요(비개발자용) · 노션 연동 가이드 · 구글 연동 가이드 · 피그마 연동 가이드 · 슬랙 연동 가이드

관련 가이드: 클로드 커넥터·MCP 종류 총정리 — 구체적 예시로 Linear 연동 · Asana 연동 · Zapier 연동

연결이 잘 됐는지 확인하는 방법

MCP를 추가한 뒤 "정말 연결된 건지" 모르겠다면 아래 방법으로 바로 확인하세요.

방법 A — Claude.ai 웹/앱 (디렉토리 커넥터·커스텀 원격)

1. 대화 입력창 왼쪽 아래 🔧 도구(Tools) 아이콘을 클릭합니다.
2. 추가한 커넥터 이름이 목록에 보이고 토글이 켜진 상태이면 성공입니다.
3. 확인 신호: 채팅창에 "GitHub 파일을 읽어줘"처럼 MCP 기능을 요청하면 Claude가 도구 사용 여부를 물어보는 팝업을 띄웁니다. 팝업이 뜨면 연결 완료.

⚠️ 도구 아이콘이 보이지 않으면 — 현재 플랜이 MCP를 지원하는지 claude.ai → 설정 → 플랜 화면에서 확인하세요. (MCP 커넥터는 유료 플랜 이상에서 사용 가능합니다. 정확한 플랜 조건은 support.claude.com에서 최신 내용을 확인하세요.)

방법 B — Claude Code (로컬 CLI)

터미널에서 아래 명령어를 실행하면 현재 등록된 MCP 서버 목록이 출력됩니다.

claude mcp list

확인 신호: 추가한 서버 이름과 상태(예: github: connected)가 줄로 나타나면 성공입니다. 목록이 비어 있으면 claude mcp add 단계로 돌아가세요.

방법 C — Claude Desktop (로컬 설정파일)

1. Claude Desktop을 완전히 종료 후 재시작합니다(트레이 아이콘 → Quit).
2. 새 대화를 열고 입력창 근처에 망치·렌치 모양 아이콘이 생겼으면 MCP 서버가 로드된 것입니다.
3. 아이콘이 없으면 설정파일 경로와 JSON 문법을 다시 점검하세요(아래 '자주 막히는 지점' 참고).

자주 막히는 지점 & 해결

다른 커넥터도 찾고 있다면 커넥터 디렉토리에서 자주 쓰는 커넥터를 용도별로 검색·필터해볼 수 있습니다.

관련 글

• MCP(Model Context Protocol)란? 구조와 보안까지
• 클로드 MCP 추천 서버: 용도별로 자주 쓰는 커넥터 정리 (2026)
• Claude Code MCP 설정: claude mcp add·스코프·전송 방식 완전 정리
• 클로드 피그마 연동: Figma MCP로 디자인→코드 변환 (Claude Code, 2026)
• MCP 서버 직접 만들기 — 파이썬으로 첫 서버부터 Claude 연결까지 (2026)