Mac에서 Claude 또는 ChatGPT를 WhatsApp에 연결하기 — 로컬에서, Business API 없이

클라우드 커넥터가 WhatsApp에 접근할 수 없는 이유

WhatsApp은 기업을 위한 Business API를 제공하지만 개인 계정용 API는 제공하지 않습니다. OAuth 흐름도 없고, 클라우드 AI가 채팅을 읽기 위해 호출할 수 있는 엔드포인트도 없습니다. 그래서 API 기반 또는 클라우드 통합은 개인 WhatsApp을 볼 수 없습니다. 도구가 접근할 수 있는 메시지는 사용자의 컴퓨터에 있는 WhatsApp 클라이언트에만 존재합니다.

Windows에서도 사용할 수 있습니다. LMCP 3.0.420부터 WhatsApp은 Windows에서도 이 페이지와 같은 도구와 프롬프트로 작동합니다. LMCP 트레이 아이콘 → 계정 연결 또는 첫 실행 설정에서 QR 코드로 휴대폰을 연결합니다. 이 페이지의 단계는 Mac 기준입니다.

LMCP는 이 로컬 클라이언트에 연결하므로 AI가 로컬 도구를 통해 WhatsApp 채팅을 다룰 수 있습니다. 요청된 메시지는 AI 클라이언트에 반환되며, 해당 클라이언트의 클라우드 제공업체에서 처리될 수 있습니다.

LMCP가 WhatsApp에 연결하는 방식

LMCP는 로컬 WhatsApp Web 클라이언트를 통해 WhatsApp과 통신합니다. 처음에는 브라우저에서 WhatsApp Web을 연결할 때와 같은 방식으로 휴대전화의 WhatsApp에서 QR 코드를 스캔합니다(WhatsApp → 설정 → 연결된 기기). 연결 후 AI 어시스턴트는 다음 작업을 할 수 있습니다.

채팅 목록 보기 — 최근 일대일 및 그룹 대화(whatsapp_list_chats)
대화 읽기 — 원하는 채팅의 메시지 기록(whatsapp_read_messages)
메시지 검색 — 키워드로 메시지 찾기(whatsapp_search_messages)
메시지 보내기 — 답장하거나 새 대화 시작하기(whatsapp_send_message)
파일 보내기 — 문서나 이미지 공유하기(whatsapp_send_file)

Mac에서 로컬로 실행되며, 기기와 WhatsApp 간 연결 방식은 WhatsApp Web과 같습니다.

WhatsApp 계정을 여러 개 사용하기: LMCP 3.0.420부터 WhatsApp 계정을 여러 개 연결하고 요청마다 하나를 선택할 수 있습니다. AI에게 계정 목록을 보여 달라고 하거나(whatsapp_list_accounts), 기본 계정을 지정하거나(set_default_whatsapp_account), 다른 계정을 연결하도록(whatsapp_connect와 add_account: true) 요청하세요. account를 지정하지 않으면 WhatsApp 도구는 기본 계정을 사용합니다.

설치 방법

LMCP를 다운로드하세요.

다운로드한 LMCP-Installer.dmg를 열고 그 안의 LMCP Installer를 실행하세요. LMCP가 응용 프로그램에 설치되면 LMCP를 여세요. WhatsApp 도구를 처음 사용하면 휴대전화를 연결할 QR 코드가 표시됩니다.
WhatsApp 도구를 처음 사용하면 LMCP가 QR 코드를 표시합니다. 휴대전화의 WhatsApp에서 스캔하세요(설정 → 연결된 기기 → 기기 연결).
새 도구를 인식하도록 AI 클라이언트를 다시 시작합니다.

프롬프트 예시

“오늘 가족 그룹 채팅을 요약해 줘”
“공급업체가 WhatsApp에서 송장에 관해 답했어?”
“지난주에 누군가 보내 준 주소를 찾아 줘”
“Ana에게 8시에 도착한다고 답장해 줘”

WhatsApp은 Mail, iMessage, Teams, Slack과 같은 LMCP 서버에 있으므로, AI는 한 번의 요청으로 WhatsApp 채팅에서 정보를 가져와 이메일 초안을 만들거나 미리 알림을 추가하는 후속 작업까지 수행할 수 있습니다.

LMCP와 오픈 소스 WhatsApp MCP 서버 비교

“WhatsApp MCP server”를 검색하면 오픈 소스 프로젝트도 나옵니다. 대표적으로 whatsmeow 라이브러리 기반의 Go 브리지와 Python MCP 서버를 사용하고 메시지 기록을 SQLite에 저장하는 lharries/whatsapp-mcp, 그리고 whatsapp-web.js 기반의 wweb-mcp가 있습니다. 둘 다 훌륭한 프로젝트이며 LMCP와 같은 기본 방식, 즉 컴퓨터에서 실행되며 QR로 연결하는 비공식 WhatsApp Web 세션을 사용합니다. 솔직하게 비교하면 다음과 같습니다.

옵션	범위	설정	웹 AI(ChatGPT, Claude.ai)
LMCP (Local MCP)	WhatsApp에 더해 iMessage, Mail, Teams, Slack, Calendar — 201+개 도구	서명된 2분 설치 프로그램, 첫 사용 시 QR 연결	예 — 선택 사항인 암호화 릴레이
lharries/whatsapp-mcp	WhatsApp 전용(읽기, 검색, 보내기, 미디어)	Go 브리지와 Python 서버 빌드, MCP 수동 구성	아니요 — 데스크톱 클라이언트 전용
wweb-mcp	WhatsApp 전용(whatsapp-web.js 세션)	Node 설정 및 MCP 수동 구성	아니요 — 데스크톱 클라이언트 전용
Business API 서버(GreenAPI 등)	개인 채팅이 아닌 WhatsApp Business 계정	API 키와 유료 타사 게이트웨이	게이트웨이에 따라 다름(클라우드)

요약하면, 직접 수정할 수 있는 WhatsApp 전용 서버를 원하고 소스에서 빌드하는 데 익숙하다면 lharries/whatsapp-mcp를 선택하세요. 한 번의 설치로 WhatsApp을 iMessage, Mail, Teams와 함께 사용하고 웹의 ChatGPT 및 Claude.ai에서도 접근하려면 LMCP를 선택하세요. 아래의 이용약관 주의사항은 오픈 소스 프로젝트를 포함한 모든 비공식 클라이언트 방식에 동일하게 적용됩니다.

자주 묻는 질문

개인 계정용 공식 WhatsApp API가 있나요?

아니요. WhatsApp은 Business API만 제공합니다. LMCP와 오픈 소스 서버를 포함한 모든 개인 계정 통합은 QR로 비공식 WhatsApp Web 세션을 연결하는 방식이므로, 모두 동일한 이용약관 관련 주의가 필요합니다.

어떤 WhatsApp MCP 서버를 선택해야 하나요?

최소한의 수정 가능한 WhatsApp 전용 도구가 필요하다면 lharries/whatsapp-mcp가 대표적인 오픈 소스 선택입니다. 하나의 서명된 설치 프로그램에서 WhatsApp과 iMessage, Mail, Teams, Calendar를 함께 사용하고 웹의 ChatGPT 및 Claude.ai에서도 접근하려면 Local MCP를 선택하세요.

중요: 비공식 클라이언트 및 제한 사항

비공식 WhatsApp Web 클라이언트를 사용합니다. WhatsApp은 개인용 API를 제공하지 않으므로 WhatsApp Web 세션을 연결하는 방식으로 작동합니다. WhatsApp/Meta와 제휴하거나 승인을 받은 제품이 아니며, WhatsApp 자동화는 이용약관에 위배될 수 있습니다. 자동화 사용으로 계정이 제한된 사례도 있습니다. 스스로 판단하여 사용하고 대량 전송이나 스팸성 전송을 피하세요.
QR 연결이 필요합니다. WhatsApp Web처럼 휴대전화로 QR을 한 번 스캔해 로그인합니다.
로컬 전용입니다. 세션은 Mac에서 실행되며 LMCP가 메시지를 다른 곳에 업로드하지 않습니다.
개인 계정용입니다. WhatsApp Business API가 아니라 사용자의 WhatsApp을 위한 기능입니다.

LMCP는 AI를 Mac 전체에 로컬로 연결합니다. iMessage 가이드, Mac용 최고의 MCP 서버 비교, 전체 가이드 목록을 확인하거나 local-mcp.com에서 자세히 알아보세요.

바로 쓸 수 있는 레시피

WhatsApp을 다른 앱과 함께 사용하는 복사-붙여넣기 워크플로입니다.