HappyCapy를 iMessage에 연결하는 방법: Apple 메시지에서 완전한 AI 에이전트 사용하기
BlueBubbles + HappyCapy의 capy-bridge: Hermes Agent가 사용하는 것과 동일한 스택 — 이제 원클릭 스킬로 제공됩니다.
Apple가 iMessage API를 공개한 적이 없습니다. 2015년에도, 2020년에도, 오늘도 마찬가지입니다. 수년간 iMessage 안에서 작동하는 AI 에이전트를 만들려면 탈옥(jailbreak)을 하거나, 월 200달러짜리 엔터프라이즈 플랜을 이용하거나, 문서화되지 않은 프로토콜을 깊이 이해해야 했습니다. 2026년 6월, 마침내 무료 오픈소스 방식이 안정적으로 작동하게 되었습니다 — 그리고 이는 18만 8천 개의 스타를 받은 Hermes Agent 프로젝트가 프로덕션에서 사용하는 것과 동일한 아키텍처입니다.
iMessage가 가장 까다로운 플랫폼인 이유 (그리고 그것이 중요한 이유)
대부분의 메시징 플랫폼에는 API가 있습니다. Telegram은 2015년에 API를 공개했습니다. Slack은 초창기부터 웹훅을 제공해 왔습니다. WhatsApp은 2018년에 Business API를 개방했습니다. iMessage에는 이런 것이 전혀 없으며, 이는 단순한 실수가 아닙니다.
Apple의 iMessage 프로토콜은 Apple ID와 기기별 키에 직접 연결된 종단간 암호화를 사용합니다. 이 키들은 Apple 하드웨어에서 생성되며 절대 그 밖으로 나가지 않습니다. 모든 메시지는 물리적인 Apple 기기에서 암호화되고 복호화됩니다. 복호화된 콘텐츠를 보유한 서버가 존재하지 않기 때문에 서버 측 API도 존재하지 않습니다. 이는 엄격한 암호학적 제약이지, 보도자료 한 장으로 Apple이 뒤집을 수 있는 정책적 선택이 아닙니다.
실질적인 결과는 이렇습니다. 어떤 Linux 프로세스도, 어떤 Docker 컨테이너도, 어떤 클라우드 VM도 네이티브하게 iMessage를 주고받을 수 없습니다. 루트 권한이 있어도, 유효한 Apple ID가 있어도 마찬가지입니다. 이 프로토콜은 Apple 하드웨어 바깥에서는 아예 작동하지 않습니다.
AI 에이전트 개발자에게 이는 iMessage 연동에는 항상 Mac이 개입해야 함을 의미합니다. 이것이 솔직한 답이며, 이 글의 나머지 부분을 결정짓는 전제입니다.
반대 측면도 사실입니다. Apple 사용자에게 있어 이 아키텍처는 봇이 Messages.app 자체 안에 존재한다는 것을 의미합니다. 설치해야 할 서드파티 앱도 없고, 새로 만들어야 할 계정도 없습니다. AI는 가족과 동료가 이미 사용하고 있는 바로 그 인터페이스를 통해 응답합니다. 연락처에 있는 사람이 당신에게 메시지를 보내면, 그들은 무언가가 바뀌었다는 것을 전혀 알아채지 못합니다 — 그들에게는 당신의 Apple ID로부터 온, 네이티브 iMessage 형식의, 읽음 확인까지 붙은 답장으로 보일 뿐입니다.
수신자 입장에서의 무마찰 경험, 암호학적 프라이버시, 그리고 Apple 사용자들이 이미 신뢰하는 플랫폼이라는 조합 — 이것이 iMessage가 추가적인 복잡성을 감수할 가치가 있는 이유입니다.
실제 작동 방식
무료 오픈소스 솔루션은 BlueBubbles입니다. 이는 MIT 라이선스로 배포되는 Mac 서버 애플리케이션으로, 당신의 Mac에서 실행되어 Apple ID로 등록하고 로컬 REST API를 노출합니다. BlueBubbles는 macOS를 요구하는 iMessage 프로토콜과 HTTP 요청을 보낼 수 있는 모든 외부 서비스 사이의 다리 역할을 합니다.
HappyCapy의 capy-bridge는 그 REST API에 연결됩니다. 당신의 Apple ID로 메시지가 도착하면 정확히 다음과 같은 순서로 진행됩니다.
| 단계 | 무슨 일이 일어나는가 |
|---|---|
| 1. iMessage 수신 | Apple이 표준 iMessage 프로토콜을 통해 당신의 Mac으로 메시지를 전달합니다 |
| 2. BlueBubbles가 가로챔 | 당신의 Mac에서 실행 중인 BlueBubbles 서버가 들어온 메시지를 읽습니다 |
| 3. 웹훅 POST | BlueBubbles가 HappyCapy의 capy-bridge 엔드포인트로 메시지 페이로드를 POST합니다 |
| 4. 브리지 처리 | capy-bridge가 발신자, 메시지 텍스트, 대화 기록을 파싱합니다 |
5. claude --print | 브리지가 전체 도구 접근 권한을 가진 Claude Code CLI를 실행합니다 |
| 6. Claude 실행 | Claude가 도구를 실행합니다 — bash, 웹 검색, 파일 작업, 설치된 모든 Skill |
| 7. 응답 전송 | 답장이 BlueBubbles의 REST API를 통해 원래의 iMessage 스레드로 다시 전송됩니다 |
| 8. iMessage 전달 | 수신자는 몇 초 안에 자신의 Messages.app에서 답장을 확인합니다 |
이는 Hermes Agent가 사용하는 것과 동일한 아키텍처입니다. Nous Research가 만든 Hermes Agent 프로젝트 — 18만 8천 개의 GitHub 스타를 받은 — 는 프로덕션 설정에서 iMessage 연동을 BlueBubbles를 통해 라우팅합니다. 이 아키텍처는 이미 대규모로 검증되었습니다.
5단계에서 핵심은 claude --print입니다. HappyCapy는 당신의 메시지를 텍스트로만 응답하는 챗봇에게 보내는 것이 아닙니다. 전체 도구 접근 권한을 가진 Claude Code CLI를 실행합니다: bash 실행, 파일 읽기/쓰기, 웹 검색, 이미지 생성, 그리고 HappyCapy의 30만 개 이상의 Skills 라이브러리 접근까지 포함됩니다. 이 봇은 단순히 답변만 하는 것이 아니라 실제로 행동합니다.
무엇을 할 수 있는가
브리지가 실행되면, 당신의 Apple ID로 오는 모든 iMessage는 당신의 HappyCapy 샌드박스를 위한 명령 인터페이스가 됩니다.
- 원격으로 작업 실행 — iPhone에서 작업을 보내면 결과와 출력이 완전히 실행된 상태로 돌아옵니다
- 파일 요청 — PDF 보고서, 생성된 이미지, 스크립트를 요청하면 받을 수 있습니다
- 검색 및 요약 — 에이전트에게 웹을 검색하고 구조화된 요약을 반환하도록 요청할 수 있습니다
- 30만 개 이상의 Skills 트리거 — HappyCapy 라이브러리의 모든 Skill을 Messages.app에서 접근할 수 있습니다
- 샌드박스에서 bash 실행 —
run ls /var/log는 당신의 HappyCapy Linux 환경에서 실행되어 출력을 반환합니다 - 연락처별 대화 기록 — 각 Apple ID나 전화번호는 각자의 대화 스레드를 가지며, 컨텍스트는 메시지 간에 이어집니다
- 모든 Apple 기기에서 작동 — iPhone, iPad, Mac, Apple Watch — iMessage를 보낼 수 있는 모든 것이 봇에 도달합니다
장점
- 네이티브 Apple 경험 — 답장은 표준 Messages.app 스레드에 나타나며, 수신자는 아무것도 설치할 필요가 없습니다
- 수신자 기기에 서드파티 앱 불필요 — 봇은 기존 iMessage 인프라를 통해 통신합니다
- 모든 Apple ID와 호환 — 당신에게 iMessage를 보낼 수 있는 모든 연락처가 봇과 상호작용할 수 있습니다
- 종단간 암호화 — BlueBubbles는 Apple의 암호화를 깨지 않으며, 당신의 Mac에서 복호화된 이후의 메시지를 읽습니다
- 무료이자 오픈소스 — BlueBubbles는 MIT 라이선스이며 구독료가 없습니다
- Hermes로 검증된 아키텍처 — 18만 8천 개의 스타를 받은 프로덕션 에이전트 프로젝트를 구동하는 것과 동일한 스택입니다
- 완전한 에이전트 기능 —
claude --print는 봇에게 bash 접근, 웹 검색, 파일 작업, 그리고 30만 개 이상의 Skills를 제공합니다
실제 사용 사례
iPhone을 쓰는 개발자. 노트북에서 떨어져 있는데 크론 작업이 실행되었는지 확인하거나, 로그 파일을 tail 하거나, HappyCapy 샌드박스에서 서비스를 재시작해야 하는 상황입니다. iPhone의 Messages.app에서 명령을 보냅니다. 브리지가 이를 실행하고 결과를 답장으로 반환합니다. SSH 클라이언트도, VPN도, 컨텍스트 전환도 필요 없습니다.
Apple 기기만 쓰는 가정. 배우자, 부모님, 룸메이트가 모두 iMessage만 사용합니다. 그들에게 Telegram을 설치하거나 새로운 인터페이스를 배우라고 요구하는 대신, 기존의 Apple ID에 봇을 연결합니다. 모두가 이미 자신의 기기에 있는 앱을 통해 상호작용합니다.
iMessage로 고객과 소통하는 사업주. 당신은 iMessage로 고객과 소통합니다 — 그것이 고객들이 쓰는 방식이며, 다른 플랫폼으로 옮기게 하는 것은 현실적이지 않습니다. 브리지가 실행 중이면, 긴 대화 스레드를 요약하거나, 당신의 어투로 답장 초안을 작성하거나, 고객의 주문 이력을 조회하거나, 보고서를 뽑아달라고 에이전트에게 요청할 수 있습니다. AI는 관계가 이미 존재하는 채널 안에 머뭅니다.
Mac을 쓰는 연구자. 책상 위에 Mac을 켜 둔 채로 둡니다. 출퇴근 중 iPhone에서, 회의 중 iPad에서, 비상 상황에서 동료의 Mac에서도 언제든 접근 가능한 AI 에이전트를 원합니다. iMessage는 이미 당신이 소유한 모든 Apple 기기 간에 동기화되어 있습니다. 봇은 그 도달 범위를 자동으로 물려받습니다.
Mac 요구사항 — 솔직한 평가
이 설정은 BlueBubbles가 설치되어 실행 중이고, capy-bridge를 통해 HappyCapy에 연결된 Mac을 필요로 합니다. 브리지가 작동하려면 Mac이 깨어 있고 온라인 상태여야 합니다. Mac이 잠들면 봇은 오프라인이 됩니다.
이것은 실질적인 제약입니다. Mac을 소유하고 있지 않거나, 자주 들고 다니며 닫아 두는 노트북형 Mac이라면 iMessage는 당신에게 맞지 않는 채널입니다. HappyCapy의 Telegram과 Slack 연동은 하드웨어 의존성 없이 완전히 Linux 네이티브 인프라에서 작동합니다.
TV 아래에 둔 Mac Mini, 홈 오피스의 Mac Studio, 선반에 꽂아 둔 오래된 MacBook처럼 이미 켜져 있는 Mac을 운영하고 있는 사람이라면, 설정은 한 번만 하면 되고 이후에는 완전히 자동화됩니다. BlueBubbles는 로그인 시 시작됩니다. capy-bridge 데몬도 로그인 시 시작됩니다. Mac이 계속 실행되는 한 봇도 계속 작동합니다.
이 목적을 위해 전용 하드웨어를 고려하고 있다면, 2026년형 Mac Mini M4 베이스 모델(799달러)이 가장 실용적인 선택입니다. 유휴 상태에서 약 6~10와트를 사용하며, 팬 소음 없이 24시간 연속 작동을 지원하고, 페이퍼백 책보다 작은 공간에 들어갑니다. Mac Mini AI 서버 구성에 대한 전체 분석은 Mac Mini as an AI Server in 2026을 참고하세요.
설정 방법
전체 설정은 약 10분이 걸립니다.
- BlueBubbles 다운로드 — bluebubbles.app에서 무료, MIT 라이선스, 오픈소스로 제공됩니다
- 설정 마법사 실행 — Apple ID로 로그인하고 손쉬운 사용(Accessibility) + 전체 디스크 접근(Full Disk Access) 권한을 부여합니다
- BlueBubbles URL과 비밀번호 확인 — BlueBubbles 설정 화면에서 확인합니다
- capy-bridge 설치 — HappyCapy에서
bash /app/export-port.sh 8766을 실행하여 웹훅 URL을 얻은 다음, HappyCapy에서/happycapy-imessageskill을 실행합니다 - HappyCapy 마법사 완료 — BlueBubbles URL, 비밀번호, 웹훅 URL을 붙여넣으면 브리지가 자동으로 등록됩니다
- 테스트 — 다른 기기에서 iMessage를 보내면 몇 초 안에 답장을 받게 됩니다
전체 skill 문서와 소스 코드는 github.com/ndpvt-web/happycapy-imessage에 있습니다.
자주 묻는 질문
Mac을 항상 켜 두어야 하나요? 24시간 이용 가능하려면 그렇습니다. BlueBubbles와 capy-bridge가 들어오는 메시지를 받으려면 Mac이 깨어 있고 온라인 상태여야 합니다. 봇을 언제든 사용 가능하게 하고 싶다면 항상 켜 둘 수 있는 하드웨어를 사용하세요 — Mac Mini나 Mac Studio가 이상적입니다. BlueBubbles 설정에서 "디스플레이 절전 방지"를 활성화하고, macOS 에너지 절약기(전원 어댑터 모드)에서 절전 모드를 비활성화하세요.
SMS도 지원하나요, 아니면 iMessage만 지원하나요? Mac에 iPhone이 연결되어 있고 개인용 핫스팟이 SMS 포워딩을 지원하도록 구성되어 있다면, BlueBubbles는 iMessage(파란 버블)와 SMS(초록 버블) 둘 다 지원합니다. 대부분의 설정에서는 iMessage만 사용하는 것이 더 간단하고 안정적입니다.
Apple이 BlueBubbles를 통해 제 메시지를 볼 수 있나요? 아니요. BlueBubbles는 Apple의 종단간 암호화를 깨지 않습니다. 메시지는 평소와 마찬가지로 로컬 머신에서 macOS에 의해 복호화되며, BlueBubbles는 그 로컬의 복호화된 상태에서 메시지를 읽습니다. Apple의 서버는 평문 콘텐츠를 절대 보지 못합니다 — Messages.app을 평소대로 사용할 때와 동일합니다.
BlueBubbles는 무료인가요? 네. BlueBubbles는 MIT 라이선스이며 무료로 사용할 수 있습니다. 구독료는 없습니다. Mac 서버 앱, 소스 코드, 문서 모두 bluebubbles.app에서 공개적으로 이용 가능합니다.
Mac이 잠들면 어떻게 되나요?
브리지가 오프라인이 됩니다. Mac이 잠든 동안 보낸 메시지는 처리되지 않으며, Mac이 깨어난 후에도 소급해서 응답되지 않습니다. 이를 방지하려면: BlueBubbles에서 "디스플레이 절전 방지"를 활성화하거나, macOS 에너지 절약기에서 전원 어댑터 사용 시 시스템 절전을 비활성화하거나, 터미널에서 caffeinate -di &를 실행하세요. 상시 가동 설정에는 노트북보다 데스크탑 Mac(Mini, Studio, Pro)이 더 적합합니다.
서로 다른 Apple ID를 가진 여러 사람이 봇에게 메시지를 보낼 수 있나요? 네. 브리지는 발신자 핸들별로 별도의 대화 기록을 저장합니다. 각 Apple ID나 전화번호는 자신만의 컨텍스트 창을 갖습니다. 특정 핸들만 허용하는 허용목록(allowlist)을 구성하거나, 들어오는 모든 iMessage에 열어 둘 수 있습니다.
이것이 Apple의 서비스 약관을 위반하나요? BlueBubbles는 회색 지대에 있습니다. Apple은 서드파티 iMessage 브리지를 명시적으로 승인한 적은 없지만, 4년 이상 운영되어 오는 동안 BlueBubbles에 대해 조치를 취한 적도 없습니다. 이 프로젝트는 전체 디스크 접근 권한을 가진 다른 어떤 프로세스와 마찬가지로, 당신 자신의 Mac에서, 당신 자신의 Apple ID로 메시지를 읽습니다. 상업적인 대량 메시징이나 스팸이 아니라 개인적인 자동화를 위해 사용하는 것은 수만 명의 개발자가 이를 사용하는 방식과 일치합니다. Hermes Agent 프로젝트는 2026년 현재 기본 설정에서 BlueBubbles 연동을 제공하고 있습니다.
마치며
HappyCapy가 지원하는 네 가지 메시징 채널 — Telegram, Slack, WhatsApp, iMessage — 중에서 iMessage는 설정하기에 기술적으로 가장 까다롭습니다. Mac, 실행 중인 BlueBubbles 서버, 그리고 당신의 하드웨어와 HappyCapy 샌드박스 사이의 지속적인 연결이 필요합니다. 다른 채널들보다 움직이는 부품이 더 많습니다.
이미 그 생태계 안에서 살고 있는 Apple 사용자에게는 가장 매끄러운 결과이기도 합니다. 연락처들이 매일 사용하는 Messages 앱을 통해 응답하는 완전한 AI 에이전트를, 새로운 앱을 설치하거나 새로운 계정을 만들 필요 없이 얻을 수 있습니다. 이 아키텍처는 이미 검증되었으며 — Hermes Agent의 18만 8천 개 스타 뒤에 있는 것과 동일한 스택입니다 — HappyCapy는 이를 원클릭 skill로 감쌌습니다.
항상 켜져 있는 Mac을 가지고 있다면, 이 10분의 설정은 그만한 가치가 있습니다.
