AI
고객 대화를 Claude에게 물어보세요: MCP로 AI 클라이언트를 인박스에 연결하기
WhatsApp, Instagram, Messenger 대화에는 "이번 주 고객 불만은 무엇이었나?"에 대한 답이 있습니다. MCP로 연결된 AI 클라이언트가 이를 대신 읽어 줍니다. MonoChat MCP 서버가 허용하는 것, 허용하지 않는 것, 관리자가 통제하는 방법을 소개합니다.
MonoChat 팀 업데이트: 3 분 소요
MonoChat MCP 서버를 사용하면 Claude Code나 Cursor 같은 AI 클라이언트가 Model Context Protocol로 고객 대화를 읽을 수 있습니다. 프로필에서 액세스 키를 만들어 클라이언트에 추가하고 자연어로 물어보면 됩니다. “이번 주 배송 관련 문의를 요약해 줘”, “환불이 언급된 대화를 찾아 줘”, “세일을 언급하는 WhatsApp 템플릿은?”. 클라이언트는 읽기 전용 도구 6가지를 호출하며, 본인의 MonoChat 사용자가 볼 수 있는 범위만 봅니다.
해외 고객과 WhatsApp으로 소통하는 K-뷰티·역직구 판매자라면 영어, 아랍어, 스페인어 대화에서 문의 경향을 한국어로 정리해 달라고 할 수 있습니다.
MCP의 두 방향
MCP는 AI 앱이 다른 시스템의 도구를 찾아 호출하는 개방형 프로토콜입니다. 고객 응대에서는 두 방향이 있습니다. 고객에게 답하는 AI 에이전트가 CRM이나 캘린더를 호출하는 방향(고객 메시징에서의 MCP 참고)과, 여러분이 쓰는 AI 앱(Claude Code 등)이 메시징 플랫폼을 호출해 대화를 읽는 방향입니다. 후자가 MonoChat 서버의 역할입니다. Meta의 WhatsApp Business Tools MCP는 플랫폼 설정용이며 팀 대화를 읽지 않습니다.
실제로 물어볼 수 있는 것
| 작업 | AI 클라이언트의 동작 |
|---|---|
| ”이번 주 고객 불만은?” | 최근 세션을 나열하고 메시지를 읽어 주제별로 정리 |
| ”이 고객과의 통화를 준비해 줘” | 고객을 검색하고 최근 대화를 읽음 |
| ”AI가 상담원에게 넘긴 이유는?” | 세션과 메시지를 읽고 패턴을 찾음 |
| ”실제 질문으로 지식 베이스 초안 작성” | 반복 질문을 추출 |
| ”이 WhatsApp 번호의 템플릿은?” | 한 채널의 메시지 템플릿을 나열 |
6가지 도구
list_tenants(접근 가능한 조직), list_sessions(조직의 세션을 최신순으로, 진행 중·할당됨·종료만 선택 가능), get_session(세션 1개), list_messages(세션의 메시지), search_customers(키워드로 고객 검색), list_message_templates(한 채널의 템플릿). 모두 읽기만 합니다. 연결에는 읽기 전용(기본) 또는 읽기 및 쓰기 범위가 있으며, 읽기 전용 연결에는 데이터를 바꾸는 도구가 보이지 않습니다.
Claude Code·Cursor 연결 방법
- 2단계 인증 켜기(이메일 또는 인증 앱): 프로필 보안 설정에서 켭니다. 필수입니다.
- 연결 만들기: 프로필의 MCP 연결 탭에서 이름, 범위 읽기 전용, 유효 기간(기본 90일, 최대 365일)을 정합니다. 6자리 확인 코드를 입력하고 키를 복사하세요. 키는 한 번만 표시되며
mcp_sk_로 시작합니다. 활성 연결은 최대 10개입니다. - 클라이언트에 추가: 서버 주소는
https://app.monochat.ai/api/mcp-server이며 키를 bearer token으로 받습니다. Claude Code에서는:
claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
--header "Authorization: Bearer <액세스 키>"Cursor에서는 같은 URL과 헤더로 monochat 항목을 ~/.cursor/mcp.json에 추가합니다.
- 좁게 시작: 조직 하나, 일주일, 주제 하나로 시작하고 인용된 대화 몇 개는 직접 확인하세요.
제한
분당 연결당 60회, 계정당 300회, 조직당 600회이며 연결당 동시 호출은 최대 4개입니다. 초과하면 서버는 429 상태와 Retry-After 헤더를 반환합니다.
보안과 통제
- 본인으로 동작: 연결은 본인 역할이 허용하는 범위만 봅니다. 팀 인박스의 역할과 권한 참고.
- 개인·범위·기한이 있는 키: MCP 연결 탭의 취소로 즉시 차단되며, 취소되거나 만료된 키는 다시 쓸 수 없습니다.
- 관리자가 끌 수 있음: 설정 › 조직 › MCP 서버의 이 조직의 MCP 액세스 끄기는 모든 MCP 호출을 거부합니다.
- 모든 호출 기록: MCP 호출 목록에 사용자, 연결, 도구, 상태, IP, 시간이 표시되며 MonoChat 3.8.39(2026년 10월)에 추가되었습니다.
- 고객 텍스트는 데이터이지 지시가 아님: Claude Code 문서는 외부 콘텐츠를 가져오는 서버에서 프롬프트 인젝션 위험이 있다고 경고합니다. 범위는 읽기 전용으로 유지하세요.
연결 전에 개인정보 보호법(PIPA)과 국외 이전 규정에 비추어 개인정보 처리방침과 계약이 AI 서비스의 고객 메시지 처리를 어떻게 다루는지 확인하세요. 확인할 질문은 AI 챗봇 데이터 프라이버시 가이드에 정리되어 있습니다.
시작하기
app.monochat.ai에서 무료 계정을 만들고 채널을 연결한 뒤, 이미 쓰고 있는 AI 클라이언트에 서버를 추가하세요. 반대 방향은 MCP 연동, API는 개발자 페이지에서 볼 수 있습니다.
출처
- MonoChat 도움말 센터: AI 앱 연결(MCP)
- MonoChat 도움말 센터: 프로필 설정, MCP 연결
- Claude Code 문서: MCP로 도구 연결 (
claude mcp add --transport http와--header, 프롬프트 인젝션 경고; 2026년 10월 31일 확인) - MonoChat 변경 기록 3.8.37·3.8.39