Claude.ai 커넥터 5선——280개 중 엄선, Claude Code 사용자가 가장 먼저 설정해야 할 도구
요약
Claude.ai의 Connectors 기능을 활용하여 Gmail, Slack 등 외부 서비스를 연동하는 방법과 실용적인 5가지 도구를 소개합니다. Web UI에서 설정한 커넥터는 Claude Code(CLI)에서도 별도 설정 없이 자동으로 연동되어 업무 효율을 높여줍니다.
핵심 포인트
- Claude.ai 커넥터는 외부 데이터를 읽고 조작할 수 있게 하는 기능임
- Web UI에서 설정한 커넥터는 Claude Code에서도 즉시 사용 가능
- Gmail, Slack, Google Drive 등 5개 커넥터로 41개 도구 활용 가능
- 커넥터는 Anthropic이 아닌 서드파티에서 제공하는 서비스임
이 기사의 정리 내용 (2026-05-05): Claude.ai의 공식 Connectors 280개 이상 중에서 Gmail / Google Calendar / Google Drive / Slack / Exa 5개를 실제로 활성화하여 사용 중이다. 5개로 총 41개의 도구를 이용할 수 있음을 실기에서 확인했다 (실측: 2026-05-05). Claude Code (CLI)와의 연동 가능 여부, 알려진 버그, 각 도구의 전체 목록을 수록하였다.
Claude.ai를 사용하다 보면 사이드바에 「Connectors」라는 항목이 보인다. 열어보면 280개 이상의 서비스가 나열되어 있어, "무엇을 어떻게 골라야 할지" 막막해질 것이다——그 기분, 이해한다.
전부 사용할 필요는 없다. 내가 실제로 활성화하고 있는 것은 5개뿐이다. 이 기사에서는 Gmail / Google Calendar / Google Drive / Slack / Exa 5개에 대해, 제공되는 도구의 전체 목록과 용도별 구분법을 정리했다. 5개로 총 41개의 도구를 사용할 수 있음을 실기에서 확인했다 (실측: 2026-05-05).
Connector란, Claude.ai에 외부 서비스를 연결하여 "Claude가 해당 서비스의 데이터를 읽거나 조작할 수 있게" 만드는 기능이다. 설정은 claude.ai > Settings > Connectors에서 수행한다. 활성화하기만 하면 다음 대화부터 바로 사용할 수 있다.
Claude Code (CLI)를 사용하는 분들께: claude.ai Web UI에서 활성화한 Connectors는 Claude Code에서도 자동으로 사용할 수 있다. Web UI 측에서 설정하면 CLI 측의 추가 설정은 필요 없다.
| Connector | 제공처 | 도구 수 | 이용 가능 플랜 | 주요 용도 |
|---|---|---|---|---|
| Gmail | 10 | Free~ (2026-02-11 이후) | "오늘 온 메일 중 읽어야 할 것이 있어?"라고 물어보며 메일 체크를 완결한다 | |
| ... | ||||
| 실측: 5 Connectors / 합계 41개 도구 (2026-05-05 시점) |
| 하고 싶은 일 | 사용하는 Connector |
|---|---|
| 메일을 찾고 싶다・답장 초안을 만들고 싶다 | Gmail (search_threads / create_draft) |
| 일정을 확인하고 싶다・빈 시간을 제안받고 싶다 | Google Calendar (list_events / suggest_time) |
| 드라이브의 파일을 검색・읽고 싶다 | Google Drive (search_files / read_file_content) |
| 채널을 읽고 요약하고 싶다・메시지를 보내고 싶다 | Slack (slack_read_channel / slack_send_message) |
| 웹상의 최신 정보를 리서치하고 싶다 | Exa (web_search_exa / web_fetch_exa) |
2026년 5월 5일 시점에서 claude.com/connectors에는 약 280개가 게재되어 있다 (researcher 실제 수 조사: 2026-05-05에 전체 12페이지를 확인하여 합계 카운트). 카테고리 상위는 Sales and marketing (약 70개)이며, 이어 Financial services (약 50개), Productivity (약 40개) 순이다. 일본어권 사용자가 일상적으로 사용할 수 있는 서비스는 한정되어 있으며, Gmail / Google Calendar / Google Drive / Slack / Exa는 그중에서도 범용성이 높은 5개이다.
Connectors는 "Anthropic이 직접 개발한 것"이 아니다. 전수가 Anthropic의 심사를 통과한 서드파티 (Third-party) 제품이다 (Gmail = Google, Slack = Slack Technologies, Exa = Exa AI 등). Anthropic은 MCP (Model Context Protocol)라는 표준 규격을 공개하여, 외부 기업이 이를 준수함으로써 Claude.ai에서 호출할 수 있는 구조를 만들었다.
2024-11-25에 MCP가 발표되었고, 2026-01-26에 Connectors가 일제히 출시되었다. 2026-02-11부터 무료 플랜에도 개방되었다 (출처: claude.com/connectors + macrumors.com 기사).
| 날짜 | 사건 |
|---|---|
| 2024-11-25 | MCP (Model Context Protocol) 발표 |
| ... | |
| 출처: researcher 조사 (claude.com/connectors 전체 12페이지 + 공식 발표 기사) |
용도: "오늘 온 메일 중에 읽어야 할 게 있어?"라고 Claude에게 물어보는 방식이 메인이다. Gmail 탭으로 이동하지 않고 Claude 상에서만 메일 체크를 완결할 수 있다. Zenn에서 출판한 책이 팔렸다는 알림을 알아챈 것도 이 메일 체크 덕분이었다. 메일을 열지 않아도 중요한 알림을 알아챌 수 있다는 점이 가장 실감 나는 부분이다.
제공 도구 목록 (실측: 2026-05-05):
| 도구 이름 | 주요 기능 |
|---|---|
create_draft | 메일 초안 (draft) 생성 |
create_label | 라벨 생성 |
get_thread | 스레드 (thread) 가져오기 |
label_message | 메시지에 라벨 지정 |
label_thread | 스레드에 라벨 지정 |
list_drafts | 초안 목록 가져오기 |
list_labels | 라벨 목록 가져오기 |
search_threads | 스레드 검색 |
unlabel_message | 메시지에서 라벨 제거 |
unlabel_thread | 스레드에서 라벨 제거 |
주의 사항 및 팁:
- 전송 (send) 도구는 현재 라인업에 없다. 생성할 수 있는 것은 초안 (draft)까지다.
- 라벨 조작이
label_message/label_thread로 세분화되어 있다. 스레드 조작과 메시지 조작을 혼동하지 말 것. - Connector 디렉토리 추가일: 2026-02-24 (출처: researcher 조사)
용도: "일시가 고정되어 타인과 시간을 맞춰야 하는 일정"에 한정하여 캘린더를 사용하고 있다. 태스크 관리 도구에 넣는 태스크와 캘린더에 넣는 일정을 구분해서 사용하는 이미지다. 생각난 타이밍에 실시간으로 추가하고 있다.
제공 도구 목록 (실측: 2026-05-05):
| 도구 이름 | 주요 기능 |
|---|---|
create_event | 이벤트 생성 |
delete_event | 이벤트 삭제 |
get_event | 이벤트 가져오기 |
list_calendars | 캘린더 목록 가져오기 |
list_events | 이벤트 목록 가져오기 |
respond_to_event | 이벤트에 참석 여부 응답 |
suggest_time | 빈 시간 제안 |
update_event | 이벤트 업데이트 |
주의 사항 및 팁:
suggest_time은 빈 시간을 제안하는 기능으로 존재하지만, 실제 경험해 보지는 못했다. 기능 설명에 머무른다.- 삭제 (
delete_event)는 데이터 삭제를 동반하는 조작이므로, Claude에게 맡길 때는 확인 프로세스를 거치는 설계를 권장한다. - Connector 디렉토리 추가일: 2026-02-24 (출처: researcher 조사)
용도: 모바일 버전 및 PC 버전의 Claude Chat (claude.ai)과 CLI의 Claude Code 사이에서 파일을 비동기적으로 주고받는 "중계 스토리지"로 사용하고 있다. 이 운용 방식을 개인적으로 "Claude Bridge"라고 부르고 있다 (내가 붙인 이름이며 공식 용어는 아니다). M2C (Mobile to Code)는 스마트폰에서 만든 소재를 Claude Code로 전달하는 방향이고, C2M (Code to Mobile)은 그 반대로 Claude Code의 출력을 스마트폰에서 받는 방향이다. 파일 검색이나 공유 설정 확인 같은 일반적인 용도보다 이 사용법이 메인이 되고 있다.
제공 도구 목록 (실측: 2026-05-05):
| 도구 이름 | 주요 기능 |
|---|---|
copy_file | 파일 복사 |
create_file | 파일 생성 |
download_file_content | 파일 콘텐츠 다운로드 |
get_file_metadata | 파일 메타데이터 가져오기 |
get_file_permissions | 파일 권한 확인 |
list_recent_files | 최근 파일 목록 가져오기 |
read_file_content | 파일 내용 읽기 |
search_files | 파일 검색 |
주의 사항 및 팁:
get_file_permissions가 독립된 도구로 존재한다. 공유 상태 확인을 Claude에게 물어보는 것만으로 수행할 수 있다.download_file_content와read_file_content의 구분: Claude에게 파일 내용을 읽히고 싶다면read_file_content가 기본이다. 기술적 상세 사항: 전자는 파일을 base64로 인코딩된 로우 데이터 (raw data)로 가져오며 (모든 파일 형식 대응, Google 네이티브 형식은read_file_content사용, 바이너리 로우 데이터가 필요하다면download_file_content와exportMimeType필수), 후자는 자연어 텍스트로 가져온다 (지원 MIME 제한: Google Docs / Slides / Sheets / PDF / Word / Excel / PowerPoint / ODF / PNG / JPEG) (출처: 각 도구의 공식 description, 2026-05-05 확인)- Connector 디렉토리 추가일: 2026-02-24 (출처: researcher 조사)
용도: 알림 수신용 개인 Slack 워크스페이스에 연결되어 있다. Claude Code에는 Routines라는, 정해진 스케줄이나 GitHub 이벤트를 트리거로 Anthropic 클라우드 상에서 자율 실행되는 태스크 자동화 기능(2026-04-14 출시, Research Preview. 설정은 claude.ai/code/routines 또는 CLI의 /schedule 명령어를 통해 가능)이 있다. 해당 실행 결과 알림을 slack_send_message를 통해 Slack으로 보내 받는 용도로 사용 중이다. Routines를 사용하지 않더라도, "오늘의 회의 메모를 Slack으로 보내줘"와 같이 Claude와의 대화 결과를 그대로 팀에 공유하는 용도로도 사용할 수 있다. 총 13개의 도구가 있지만, 일상적으로 사용하는 것은 거의 송신 계열뿐이다.
주요 도구 (실제로 사용하는 송신 계열 / 실측: 2026-05-05):
| 도구 이름 | 주요 기능 |
|---|---|
slack_send_message | 메시지 즉시 전송 (Routine 알림의 메인) |
slack_send_message_draft | 메시지 초안 작성 (전송 전 확인하는 용도) |
slack_schedule_message | 메시지 예약 전송 (시간 지정으로 알림 전송) |
slack_search_channels | 채널 검색 |
이 외에도 Canvas 조작(생성·읽기·업데이트), 각종 읽기·검색 계열 등 총 13개의 도구가 있다.
주의 사항 및 팁:
- 5개의 Connector 중 가장 많은 13개의 도구를 보유하고 있다. 읽기 계열(read/search)이 많아, Claude가 채널을 읽고 요약 및 답변을 생성하는 용도에 적합하다.
slack_search_public_and_private는 프라이빗 채널도 검색할 수 있다. 권한 확인이 필요하다.slack_send_message(즉시 전송)와slack_send_message_draft(초안)의 구분 사용을 의식해야 한다.- Connector 디렉토리 추가일: 2026년 2월경 (1차 소스 확인 중)
용도: 무엇이든 리서치에 사용할 수 있는 만능 도구. "이것이 없으면 지식 컷오프 (Knowledge Cutoff)에서 벗어날 수 없다"는 것이 솔직한 심정이다. Claude의 학습 데이터에는 지식 컷오프가 존재한다. Exa는 그 컷오프 이후의 최신 정보를 보완하는 웹 검색 (Web Search)의 결정적인 수단이 된다. Claude 표준 WebSearch 도구와는 다른 검색 엔진을 사용하기 때문에, 얻을 수 있는 결과의 경향도 달라진다.
제공 도구 목록 (실측: 2026-05-05):
| 도구 이름 | 주요 기능 |
|---|---|
web_search_exa | Exa 엔진으로 웹 검색 |
web_fetch_exa | 지정된 URL의 콘텐츠를 가져오기 |
주의 사항 및 팁:
- Exa는 "AI 검색 엔진"으로서 Claude 표준 웹 검색과는 다른 검색 품질과 결과를 제공한다.
- Exa 자체의 비용에 대해서는 Anthropic 측의 공식 정보에 명시되어 있지 않다. Claude.ai 플랜 설명에 있는 "추가 과금 없음"은 Claude.ai 측의 과금에 관한 기술이며, Exa 측의 이용 요금이 사용자에게 전가되는지 여부는 공식 정보만으로는 확인할 수 없었다 (실제 사용 전 Exa 공식 이용 약관 및 과금 체계 확인 권장).
web_fetch_exa는 URL 지정으로 본문을 가져온다. 스크레이핑 (Scraping) 용도로 사용할 수 있다. - Connector 디렉토리 추가일: 2026년 4월 하순 (5개의 Connector 중 가장 최신, claude.com/connectors를 통해 확인).
Claude.ai에서 활성화한 Connectors는 Claude Code (CLI)로 자동 계승된다 (공식 문서 기재).
※ 여기서부터는 Claude Code를 사용하는 분들을 위한 보충 설명입니다. Claude.ai Web UI만 사용하는 분들은 건너뛰셔도 무방합니다.
▶ Claude Code 사용자를 위한 상세 정보 (5단계 스코프 및 버그 정보)
Claude Code에는 MCP 서버의 우선순위가 있다. claude.ai Connectors는 최하위다.
우선순위 (높음 $\rightarrow$ 낮음):
- Local scope (로컬 설정)
- Project scope (
.mcp.json) - User scope (사용자 설정)
- Plugin-provided servers
- claude.ai Connectors (최저 우선순위)
동일한 엔드포인트 (Endpoint)를 가진 서버가 상위 스코프에 존재할 경우, claude.ai Connector는 "hidden" 처리된다.
출처: https://code.claude.com/docs/en/mcp
Claude.ai의 Web UI에서 Connector를 연결 해제해도, Claude Code (CLI)의 claude mcp list에는 계속 남아 있다 —— 이것이 Issue #48275의 본질이다.
무엇이 문제인가: Claude Code에서 대화할 때마다, 연결을 해제했을はず의 Connector 도구 정의가 시스템 프롬프트 (System Prompt)에 자동으로 주입된다. 예를 들어 41개 도구 분량의 정의가 매 턴(Turn)마다 들어오면, 그만큼의 토큰 (Token)을 낭비하게 된다.
claude mcp remove는 사용할 수 없음:
claude mcp remove "claude.ai Gmail"을 실행해도 "No MCP server found" 에러가 반환된다. CLI 측에는 "삭제할 대상이 존재하지 않는" 상태가 되어 있기 때문에 삭제 명령이 통하지 않는다. 로그아웃/로그인으로도 해결되지 않음: 세션 리셋으로 해결될 것이라 생각할 수 있지만, 재로그인 후에도 동일한 상태가 지속된다.
현재 시점의 회피책: 환경 변수 ENABLE_CLAUDEAI_MCP_SERVERS=false를 설정함으로써, claude.ai Connectors 전체를 Claude Code에서 무효화할 수 있다. 전체를 무효화하거나, 계속 사용하거나 둘 중 하나를 선택해야 한다.
버그 존재: https://github.com/anthropics/claude-code/issues/48275 (2026-04-15 오픈, 2026-05-05 시점 미해결)
회피책 출처: https://github.com/anthropics/claude-code/issues/29506 + https://code.claude.com/docs/en/mcp
280개 이상의 Claude.ai Connectors 중 제가 매일 사용하고 있는 것은 Gmail / Google Calendar / Google Drive / Slack / Exa 5가지입니다. 총 41개의 도구를 사용할 수 있음을 실제 기기에서 확인했습니다 (2026-05-05).
설정은 claude.ai > Settings > Connectors에서 활성화하기만 하면 됩니다. 우선 1~2개만 활성화하여 사용 편의성을 확인해 보시기 바랍니다.
관련 기사:
- Claude Code에 기본적으로 포함된 5종의 SubAgent — 기능·모델·활용법 목록 (Claude Code에 내장된 5종의 SubAgent에 관한 이야기는 이쪽에서)
Claude Code를 더욱 깊이 있게 활용하고 싶은 분들에게는 실전 해설서가 도움이 됩니다.
- 실전 Claude Code 입문 — 현장에서 활용하기 위한 AI 코딩 사고법 (西見 公宏, 吉田 真吾, 大嶋 勇樹)
- Claude Code를 이용한 AI 주도 개발 입문 (平川 知秀)
이 기사는 はてなブログ (Hatena Blog) 에서의 크로스 포스트입니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기