whatsapp-bridge로 내 서버에서 왓츠앱 대화를 AI와 검색한다

whatsapp-bridge는 왓츠앱을 연결 기기로 연동해 선택한 대화만 내 서버에 암호화해 저장하고, MCP를 통해 AI 비서가 검색·열람하도록 하는 자체 호스팅 도구다. 현재 읽기 전용이며, 비공식 왓츠앱 클라이언트를 사용하므로 계정이 제한될 위험이 있다.

휴대전화에서 왓츠앱의 설정 › 연결된 기기 › 기기 연결로 들어가 QR 코드를 스캔한다. 대화는 처음에 모두 선택 해제 상태이며, 사용자가 보관할 대화만 선택해야 메시지가 저장된다. 연결 후 한 시간 안에 대화를 선택하면 왓츠앱이 연결 과정에서 보내는 이전 기록도 보관할 수 있다. AI 비서는 로그인한 뒤 선택된 대화만 검색하고 읽으며, 활용한 메시지마다 출처를 표시한다.

로컬에서 실행하려면 Go 1.27 이상이 필요하다. 웹 UI는 실행 파일에 포함된다. 저장소의 빌드·실행 절차는 다음과 같다.

git clone https://github.com/vid-t/whatsapp-bridge.git && cd whatsapp-bridge
CGO_ENABLED=0 go build -o bin/whatsapp-bridge ./cmd/whatsapp-bridge
./bin/whatsapp-bridge keygen > whatsapp-bridge.env && chmod 600 whatsapp-bridge.env
./bin/whatsapp-bridge serve -env-file whatsapp-bridge.env

이후 http://127.0.0.1:8080에서 whatsapp-bridge.env에 들어 있는 접근 코드를 입력하고 왓츠앱을 연결한다. 이 파일에는 데이터베이스 키가 들어 있다. 키가 없으면 데이터베이스를 읽을 수 없으므로 백업해야 한다.

claude.ai와 ChatGPT는 자체 서버에서 브리지에 접속하므로 공개 HTTPS 주소가 필요하다. Claude Code와 Codex는 localhost나 사설 네트워크에서도 작동한다. 서버 배포에는 cloud-init, Docker Compose, Ubuntu 24.04 또는 Debian 12용 설치 스크립트 경로가 있으며, 도메인을 서버에 연결하고 80·443 포트를 열어야 한다. 각 배포 경로는 Caddy가 자동으로 HTTPS를 설정하는 https://<your domain> 주소로 끝난다. 자세한 내용은 자체 호스팅 안내와 AI 비서 연결 안내에서 확인할 수 있다.

AI 비서는 선택된 대화의 전문 검색, 대화별 시간순 열람, 검색 결과 주변 메시지 확인, 대화 목록 조회, 첨부파일의 파일명·설명 확인, 연결 기기와 데이터 최신 상태 확인 등 읽기 전용 도구 6개를 쓴다. 도구 호출 내역에는 호출자와 사용 도구, 대상 대화, 행 수가 기록되지만 메시지 내용은 저장되지 않는다. AI 제공업체로 메시지가 자동 전송되지는 않으며, 비서가 도구를 호출했을 때 그 결과만 전달된다.

제작자에 따르면 데이터베이스 키를 설정하면 저장 파일은 Adiantum으로 암호화된다. 실행 중인 브리지는 메시지를 메모리에서 복호화하므로 제작자는 사용자가 통제하는 기기에서 실행할 것을 안내한다. 공개 주소에서 실행하려면 접근 코드와 데이터베이스 키가 설정돼야 한다. 연결을 왓츠앱에서 해제하면 브리지 접속도 즉시 끊기며, 휴대전화가 14일간 오프라인이면 왓츠앱이 연결 기기에서 로그아웃시킨다.

이 도구는 비공식 왓츠앱 웹 프로토콜 구현체인 whatsmeow를 사용한다. 왓츠앱은 비공식 클라이언트를 허용하지 않으며, 연결한 계정이 제한될 수 있다. 읽기 전용으로 조용히 작동해도 위험을 없앨 수는 없다고 안내한다. 첨부파일을 내려받거나 그 안의 텍스트를 읽는 기능, 구성원마다 볼 수 있는 대화를 제한하는 기능은 아직 구현되지 않았다. 현재는 모든 구성원이 선택된 대화를 모두 볼 수 있다.

프로젝트는 AGPL-3.0-only 라이선스를 적용한다. 수정한 whatsapp-bridge를 서비스로 운영하면 이용자에게 소스 코드를 제공해야 한다.