WhatsApp MCP (finereli)의 개요
WhatsApp MCP는 Eli Finer(GitHub의 finereli)가 만든 것으로, WhatsApp Web처럼 연결된 기기로 WhatsApp 계정에 붙어 WhatsApp이 새 기기에 넘겨주는 기록을 가져오고, MCP 클라이언트가 채팅 목록 보기, 읽기, 전체 검색, 답하지 않은 채팅 찾기, 사진·음성 메모·문서 가져오기를 할 수 있게 합니다. 보내기, 수정, 삭제는 할 수 없으며 그런 도구도 없습니다.
사람마다 Durable Object 하나를 두는 Cloudflare Worker로 실행되거나, 자기 컴퓨터의 Docker에서 실행됩니다. Google로 로그인하고 자리가 제한된 whatsapp.finereli.com의 무료 호스팅 베타를 쓰거나, 본인만 아는 비밀번호로 자기 사본을 배포할 수 있습니다. 저장소는 MIT 라이선스의 TypeScript로 2026년 10월 18일에 만들어졌고, 스타는 약 415개, 커밋은 2026년 11월 10일까지 있습니다. WhatsApp과는 비공식 라이브러리 Baileys로 통신하며 릴리스 후보 버전에 고정되어 있습니다.
WhatsApp MCP (finereli) 설치 방법
https://whatsapp.finereli.com/mcpWhatsApp MCP (finereli), 쓸 만한 가치가 있습니까?
이 리뷰를 쓸 가치를 만드는 것은 설계 판단입니다. 보내기 도구는 일부러 없으며, 이는 메시징 에이전트의 최악의 실패를 없앱니다. 메시지, 채팅 및 연락처 이름, WhatsApp 자체의 세션 키는 무작위 데이터 키로 저장 시 암호화되고, 그 데이터 키는 다시 비밀번호(PBKDF2-SHA256, 600,000회)나 호스팅 로그인 서비스에서 얻은 키로 감싸집니다. 전화번호는 키가 있는 해시로 저장되고, 검색은 약 128개 메시지 단위 블록의 필터로 이루어지므로, 복사된 데이터베이스로 알 수 있는 것은 활동 패턴과 메시지 길이뿐이고 누구와 무엇을 주고받았는지는 알 수 없습니다.
README는 이 보호가 어디서 끝나는지 드물 만큼 분명하게 적고 있으며, 독자도 그 점을 분명히 알아야 합니다. 이것은 종단 간 암호화가 아닙니다. 에이전트가 묻는 동안 서버는 키를 들고 메시지를 평문으로 읽고, 에이전트가 읽은 내용은 그 모델 제공업체로 갑니다. 호스팅 베타에서는 운영자가 로그인 서비스를 운영하므로 사용자의 키를 도출할 수 있고, OWNER_PASSWORD를 쓰는 자체 운영 사본만이 이를 없앱니다. 에이전트가 채팅을 읽기 전의 확인 단계는 없으며, 그 채팅에 있는 모든 사람이 동의 없이 사본에 들어갑니다.
계정 위험은 작지만 실재합니다. Baileys를 통해 WhatsApp Web 프로토콜을 쓰는데, WhatsApp 약관은 이를 권하지 않으며, 작성자는 WhatsApp이 그런 계정을 제한하거나 폐쇄할 수 있다고 경고합니다. 호스팅 계정은 Cloudflare 데이터센터 주소에서 접속하므로 전화보다 눈에 띌 수 있습니다. 동기화는 에이전트가 요청할 때만 일어납니다. 사용자가 로그인해 있지 않으면 아무것도 복호화할 수 없기 때문입니다. WhatsApp은 연결된 기기용 메시지를 제한된 기간만 보관하므로 오래 비워 두면 다시 연결해야 할 수 있습니다.
경쟁자는 lharries/whatsapp-mcp로, 스타 약 6,870개로 가장 잘 알려진 서버지만 메시지를 보낼 수 있고 2025년 7월 이후 커밋이 없습니다. 이 서버는 나온 지 한 달이 안 되었고, 작성자 스스로 실제 계정 하나로만 시험했다고 인정하며, 수정과 삭제는 검증되지 않았습니다. Cloudflare 자체 운영은 월 $5와 wrangler로 몇 분이면 되며, 개인 기록을 맡긴다면 그 버전입니다.
제 역할을 하는 곳
학교, 운동, 가족 단체방을 함께 챙기는 부모
이번 주 가족 단체방에서 무엇이 정해졌는지 따라잡고 싶다
월요일 이후 단체방 요약을 요청하면, 사본이 10분보다 오래되었을 경우 WhatsApp에서 새로 가져온 뒤 채팅을 읽습니다. 호스팅 베타는 무료, 자체 운영은 월 $5입니다.
WhatsApp으로 고객과 작업을 정하는 프리랜서 디자이너
고객이 요구 사항과 마감에 대해 한 말을 찾고 싶다
search_messages는 모든 채팅에서 여러 정확한 단어 질의를 한 번에 받고, get_media는 첨부된 PDF를 가져옵니다. 검색은 단어 단위의 정확한 일치이고 유사 검색이 아니므로 바꿔 말하지 말고 'deadline'과 'invoice*'처럼 물으십시오.
개인 번호로 고객에게 답하는 1인 사업자
아직 답을 기다리는 고객을 확인하고 싶다
unanswered_chats는 상대가 마지막으로 쓴 1:1 채팅을 나열합니다. 서버 자체는 보낼 수 없으므로 에이전트가 답장 초안을 쓰고 사용자가 전화에서 보냅니다.
도입 전 확인할 점
- 설정
- 호스팅: whatsapp.finereli.com에서 Google로 로그인하고 WhatsApp의 연결된 기기에서 QR 코드를 스캔한 뒤 https://whatsapp.finereli.com/mcp를 추가합니다. 자체 운영: 클론, npm install, KV 네임스페이스 생성, OWNER_PASSWORD(12자 이상) 설정 후 npm run deploy, 또는 TLS 프록시 뒤에서 docker compose up.
- 연동
- 도구 11개: list_chats, get_messages, search_messages, unanswered_chats, get_media, transcribe_audio, unnamed_chats, set_contact_names, sync_now, link_status, relink. OAuth로 Claude, ChatGPT, Grok 등 원격 MCP 클라이언트에서 작동합니다.
- 데이터와 개인정보
- 메시지는 Cloudflare Durable Object 안의 SQLite에 AES-256-GCM으로 암호화되어 저장됩니다. 타임스탬프, 메시지 유형, 대략적인 길이는 읽을 수 있습니다. 요청 중에는 메모리에서 복호화됩니다. 미디어는 필요할 때 가져오며 저장하지 않습니다. 대시보드에서 삭제하면 모두 지워집니다.
- 대규모 사용 시 비용
- 1인 자체 운영은 월 $5의 Workers Paid 요금제. 서비스로 운영하면 README 추정으로 기본 한도에서 100명 기준 최악의 경우 월 약 $10, 실제로는 $5에서 $7 정도입니다.
- 제한
- 호스팅 계정은 기본적으로 250,000건과 300 MB로 제한. WhatsApp이 새 기기에 보내는 것만, 연결마다 한 번 가져옴. 정확한 단어 검색. 이름을 붙이기 전까지 번호로만 보이는 채팅이 있습니다.
좋은 점
- 읽기 전용. 보내기, 수정, 삭제 도구 없음
- 저장 시 암호화. 번호는 키 해시로 저장
- 내 비밀번호로 Cloudflare나 Docker에서 자체 운영 가능
- 대시보드에서 전체 삭제와 연결 해제
아쉬운 점
- 비공식 프로토콜. WhatsApp이 계정을 제한할 수 있음
- 호스팅 베타 운영자는 키를 도출할 수 있음
- 요청마다 메모리에 평문
- 나온 지 한 달 미만. 실제 계정 하나로만 시험
추천 대상
개인 WhatsApp 기록에서 에이전트가 무언가를 찾아 주기를 원하고, 그에 따른 개인정보 보호를 위해 직접 운영할 의향이 있는 사람에게 맞습니다.
WhatsApp MCP (finereli) 대안
WhatsApp MCP (finereli): 자주 묻는 질문
- WhatsApp MCP (finereli), 쓸 만한 가치가 있습니까?
- 에이전트가 WhatsApp을 읽기 전용으로 검색하게 하는 신중하게 설계된 방법이지만, 자기 사본을 직접 운영하고 WhatsApp 약관이 함축하는 계정 위험을 받아들인다는 전제가 붙습니다. 평점은 5점 만점에 3.8점입니다.
- WhatsApp MCP (finereli)의 가격은 얼마입니까?
- 무료 오픈소스(MIT)입니다. 호스팅 베타는 무료이며 자리가 제한됩니다. Cloudflare에서 직접 운영하려면 월 $5의 Workers Paid 요금제가 필요하고, 음성 메모 전사는 Workers AI에서 분당 약 $0.0005입니다.
- WhatsApp MCP (finereli)의 단점은 무엇입니까?
- 비공식 프로토콜. WhatsApp이 계정을 제한할 수 있음; 호스팅 베타 운영자는 키를 도출할 수 있음; 요청마다 메모리에 평문; 나온 지 한 달 미만. 실제 계정 하나로만 시험.
- WhatsApp MCP (finereli)에 적합한 사람은 누구입니까?
- 개인 WhatsApp 기록에서 에이전트가 무언가를 찾아 주기를 원하고, 그에 따른 개인정보 보호를 위해 직접 운영할 의향이 있는 사람에게 맞습니다.
- 팀이나 프로덕션 환경에서 WhatsApp MCP (finereli)의 비용은 얼마입니까?
- 1인 자체 운영은 월 $5의 Workers Paid 요금제. 서비스로 운영하면 README 추정으로 기본 한도에서 100명 기준 최악의 경우 월 약 $10, 실제로는 $5에서 $7 정도입니다.
- WhatsApp MCP (finereli)에 회사 데이터를 맡겨도 안전합니까?
- 메시지는 Cloudflare Durable Object 안의 SQLite에 AES-256-GCM으로 암호화되어 저장됩니다. 타임스탬프, 메시지 유형, 대략적인 길이는 읽을 수 있습니다. 요 청 중에는 메모리에서 복호화됩니다. 미디어는 필요할 때 가져오며 저장하지 않습니다. 대시보드에서 삭제하면 모두 지워집니다.
- WhatsApp MCP (finereli)의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Slack MCP Server 및 Google Workspace MCP servers입니다.
답변 확인일: 2026년 11월 13일.