WhatsApp MCP
공식AI에서 자신의 번호를 사용하여 WhatsApp 채팅을 읽고, 검색하고, 답장하세요.
WhatsApp MCP(으)로 무엇을 할 수 있나요?
- 누가 기다리고 있는지 찾기 —
get_unanswered_chats를 사용하여 마지막 메시지에 답장이 없는 채팅을 확인하고, 누가 답장을 기다리는지 파악하세요. - 메시지 검색 —
search_messages로 모든 채팅 또는 특정 채팅이나 연락처 내에서 메시지 텍스트를 검색하세요. - 내 말투로 초안 작성 —
get_writing_style로 내가 글을 쓰는 방식의 예시를 가져와, 작성한 답장이 나처럼 들리도록 하세요. - 보내기 또는 예약 —
send_message로 텍스트나 파일 링크를 보내거나,schedule_message로 일회성 또는 반복 메시지를 설정하세요. - 보낸 메시지 관리 — 이모지로 반응하고, 내 텍스트를 편집하고, 모두에게서 메시지를 삭제하거나, 채팅을 읽음으로 표시하세요.
- 연결 및 상태 확인 — QR 또는 페어링 코드로 연결을 시작하고, WhatsApp이 연결되어 있는지 확인하거나, 세션을 다시 시작하세요.
호스팅형 MCP 서버
npx add-mcp 'https://server.wa-mcp.com/mcp'Claude Code, Codex, Cursor 등에 설치됩니다
문서
WhatsApp MCP 문서
WhatsApp MCP는 여러분의 AI 어시스턴트(Claude, ChatGPT, Cursor 또는 Model Context Protocol을 지원하는 모든 클라이언트)를 여러분이 이미 사용 중인 WhatsApp 번호에 연결합니다. 어시스턴트는 채팅을 읽고 검색하며, 답장을 기다리는 사람이 누구인지 찾아내고, 메시지를 보내거나 예약, 편집, 반응할 수 있습니다. 항상 여러분 자신의 번호에서, 그리고 여러분이 요청할 때만 작동합니다.
WhatsApp Web과 동일한 방식으로 연결된 기기로 WhatsApp에 연결됩니다. 설치할 앱도, 새 번호도, Meta Business API도 필요 없습니다.
설정
한 번만 연결하면 되고, 그다음 채팅에서 WhatsApp을 연결합니다.
옵션 A: Claude의 커넥터 디렉터리
- Claude에서 커넥터 디렉터리를 열고 WhatsApp MCP를 찾습니다.
- 연결을 클릭합니다. 연결 페이지가 열리면 여러분의 AI 앱 이름이 표시되는지 확인한 후 연결을 다시 클릭합니다.
- Claude로 돌아와 새 채팅을 열고 **"내 WhatsApp 연결해 줘"**라고 입력합니다(아래 "WhatsApp 연결하기" 참조).
가입이나 비밀번호는 없습니다. 여러분의 WhatsApp 번호가 곧 계정이며, 이를 연결하는 것이 여러분임을 확인하는 방법입니다.
옵션 B: 개인 연결 URL (모든 MCP 클라이언트)
- wa-mcp.com에 접속하여 AI 앱을 선택하고 내 링크 생성을 클릭합니다.
- 해당 링크를 AI 앱에 사용자 지정 커넥터(MCP 서버)로 추가합니다. 사이트에 각 앱별 정확한 단계가 나와 있으며, Claude를 WhatsApp에 연결하는 방법에서 Claude의 단계를 차근차근 안내합니다.
- 새 채팅을 열고 **"내 WhatsApp 연결해 줘"**라고 입력합니다.
링크는 비밀번호처럼 작동하므로 비공개로 유지하세요. 동일한 링크를 여러 AI 앱에서 사용할 수 있습니다.
WhatsApp 연결하기
어시스턴트에게 WhatsApp 연결을 요청하면 두 가지 방법을 제안합니다:
- QR 코드: 어시스턴트가 QR 코드(및 QR 코드가 있는 페이지 링크)를 표시합니다. 휴대폰에서 WhatsApp을 열고 → 설정 → 연결된 기기 → 기기 연결로 이동하여 스캔합니다.
- 페어링 코드: 어시스턴트에게 국가 코드를 포함한 전화번호를 알려줍니다. 8자리 코드가 반환됩니다. 휴대폰에서 연결된 기기 → 기기 연결 → 대신 전화번호로 연결을 열고 코드를 입력합니다.
연결 후 WhatsApp은 최근 기록(최대 약 90일)을 연결된 기기로 동기화하며, 계정이 큰 경우 몇 분이 걸릴 수 있습니다.
요금제
- 무료 체험: 처음 전화번호를 연결한 후 1시간 동안 모든 기능을 사용할 수 있습니다.
- 무료 요금제: 체험 후에도 채팅 읽기, 요약, 검색 및 텍스트 메시지 전송은 계속 작동합니다. 텍스트 메시지 끝에 "Sent via wa-mcp.com"이 붙으며, 새 대화(최근 90일 동안 여러분에게 메시지를 보내지 않은 사람)는 시작할 수 없습니다.
- 유료 요금제: 파일(사진, 동영상, 음성 메모, 문서), 예약 메시지, 편집, 메시지에 반응 및 삭제, 차단 방지 가드레일이 적용된 새 대화, 그리고 라벨 없음.
어시스턴트에게 *"내 요금제는 뭐야?"*라고 물어보면 요금제와 구독 옵션을 확인할 수 있습니다.
도구
도구는 어시스턴트가 선택합니다. 여러분은 평범한 말로 요청하기만 하면 됩니다.
읽기
| 도구 | 기능 |
|---|---|
get_recent_chats | 가장 최근 채팅과 각 채팅의 최신 메시지. |
get_unanswered_chats | 마지막 메시지가 상대방으로부터 온 채팅으로, 누가 답장을 기다리는지 확인할 수 있습니다. |
read_chat_history | 특정 채팅, 사람 또는 그룹의 메시지. |
search_messages | 메시지 텍스트를 검색하며, 선택적으로 특정 채팅이나 특정 사람으로 범위를 좁힐 수 있습니다. |
search_contacts | 이름이나 번호로 연락처 또는 그룹을 찾습니다. |
download_media | 메시지에서 사진, 음성 메모, 동영상, 문서 또는 스티커를 엽니다. |
get_writing_style | 여러분이 글을 쓰는 방식의 예시로, 여러분을 위해 작성된 초안이 여러분처럼 들리도록 합니다. |
쓰기
| 도구 | 기능 |
|---|---|
send_message | 텍스트 또는 링크의 파일을 사람이나 그룹에 보냅니다. 먼저 입력 중 표시를 보여줍니다. |
schedule_message | 메시지를 나중에 보내도록 예약합니다(한 번 또는 반복: 매일, 매주, 매월 등). |
list_scheduled_messages | 예정된 예약 메시지와 지난 예약 메시지 기록을 나열합니다. |
cancel_scheduled_message | 예약 메시지를 취소합니다(모든 반복 포함). |
react_to_message | 이모지로 메시지에 반응하거나 반응을 제거합니다. |
edit_message | 본인이 보낸 메시지의 텍스트를 변경합니다. |
delete_message | 본인이 보낸 메시지를 모든 사람에게서 삭제합니다. |
mark_as_read | 채팅을 읽음으로 표시합니다. |
연결 및 계정
| 도구 | 기능 |
|---|---|
get_session_status | WhatsApp이 연결되어 있고 접속 중인지 확인합니다. |
get_pairing_qr | QR 코드로 연결을 시작합니다. |
request_pairing_code | 페어링 코드로 연결을 시작합니다. |
restart_session | 메시지 수신이 중단되면 WhatsApp에 다시 연결합니다. |
manage_subscription | 요금제와 구독 옵션을 표시합니다. |
report_feedback | 버그 신고나 기능 요청을 보냅니다. |
unlink_whatsapp | WhatsApp 연결을 해제합니다(계정은 유지됨). |
delete_account | 확인 후 계정과 모든 데이터를 삭제합니다. |
예시 프롬프트
- "어제부터 누가 내 답장을 기다리고 있어?"
- "이번 주에 가족 그룹에서 무슨 이야기를 했는지 요약해 줘."
- "카를로스가 나에게 주소를 보낸 메시지를 찾아 줘."
- "아나에게 주문이 목요일에 발송된다고 알려 줘." (정확한 문구를 지정하지 않은 경우 어시스턴트가 먼저 초안을 보여줍니다)
- "매주 월요일 오전 9시에 팀 그룹에 주간 업데이트를 보내라고 알려 줘."
안전
- 전송되는 내용은 여러분이 통제합니다. 어시스턴트가 여러분을 위해 메시지를 작성할 때, 정확한 텍스트를 지정하지 않은 경우 전송 전에 초안을 보여줍니다.
- 차단 방지 가드레일. 최근 90일 동안 여러분에게 메시지를 보내지 않은 사람에게 보내는 메시지는 간격을 두고 전송됩니다(1분에 최대 1건, 12시간마다 최대 10명). 이것이 번호가 스팸으로 신고되는 원인이기 때문입니다. 여러분에게 메시지를 보낸 사람과의 채팅은 제한되지 않습니다. 대량 전송 도구는 없습니다.
- 입력 중 표시. 여러분이 직접 입력할 때처럼 각 메시지 전에 짧은 "입력 중…"이 표시됩니다.
문제 해결
- "WhatsApp이 연결되지 않았습니다": 연결된 기기가 제거되었습니다(휴대폰에서 또는 연결 해제로). 어시스턴트에게 같은 번호로 WhatsApp을 다시 연결해 달라고 요청하세요.
- 페어링 코드가 작동하지 않음: 코드는 짧은 시간 후 만료됩니다. 새 코드를 요청하고, 번호에 국가 코드가 포함되어 있는지 확인하고, 휴대폰에서 대신 전화번호로 연결을 사용하세요.
- 메시지 수신이 중단됨: 어시스턴트에게 WhatsApp 연결을 다시 시작해 달라고 요청하세요. 휴대폰의 WhatsApp이 약 14일 동안 오프라인이었다면 WhatsApp이 연결된 기기를 로그아웃합니다. 휴대폰에서 WhatsApp을 연 후 다시 연결하세요.
- "이 연결은 전화번호…에 영구적으로 등록되어 있습니다": 각 연결은 하나의 전화번호에 속합니다. 다른 번호를 사용하려면 연결을 해제한 후 커넥터를 제거하고 다시 추가하세요(또는 개인 URL의 경우 새로 생성하세요).
- 커넥터가 연결되지 않았다고 표시됨 (디렉터리 사용자): 커넥터에서 WhatsApp MCP를 제거하고 다시 연결한 후 같은 전화번호를 연결하세요. 계정과 구독은 그대로 유지됩니다.
개인정보 및 데이터
여러분의 메시지는 어시스턴트가 검색할 수 있도록 당사 서버에 90일 동안 저장되며, 광고나 AI 학습에 절대 사용되지 않습니다. 어시스턴트가 읽는 내용은 해당 제공업체의 정책에 따라 처리됩니다. 언제든지 어시스턴트에게 WhatsApp 연결 해제 또는 계정 삭제를 요청하세요. 삭제하면 모든 것이 즉시 제거됩니다. 자세한 내용은 개인정보 처리방침 및 이용약관에 있습니다.