AI 시대의 상담톡,
터미널에서.
TalkBridge CLI × API × MCP
카카오 상담톡을 당신의 터미널, AI 앱, 서버에 잇는 브릿지. 파트너 계약·발송 규격·재시도 같은 채널의 복잡도는 TalkBridge 가 흡수하고, 당신은 수신 웹훅 + 발신 API 두 계약만 다룹니다. AI 와 함께 쓰라고 만든 CLI 가 그 중심에 있습니다.
Get Started
2분이면 첫 답장을 보냅니다
npm install -g @blumn-ai/talkbridge-cli
Node 18+. Windows · macOS(Intel/Apple Silicon) · Linux(x64/arm64) 바이너리가 npm 에 동봉되어 별도 다운로드가 없습니다. 개발자용 dev 채널은 @blumn-dev/talkbridge-cli.
https://mcp.talkbridge.io/mcp
코드 없이. ChatGPT 설정 → 커넥터 → 새로 추가 → MCP 서버, Claude Desktop 설정 → Connectors → Add Custom Connector 에 이 주소를 붙여 넣고 구글 계정으로 한 번 로그인하면 끝. 키·비밀번호가 필요 없습니다. → 연결 가이드
상담 채널은 무겁고, AI 는 이미 빠릅니다.
카카오 상담톡을 직접 붙이려면 파트너 계약, 발송 규격, 세션 제약, 재시도와 순서 보장까지 전부 당신 몫이었습니다. AI 에이전트를 얹기도 전에 지칩니다.
TalkBridge 는 그 복잡도를 브릿지 안에서 흡수합니다. 당신에게 남는 건 두 계약 — 서명된 수신 웹훅과 발신 API. 그리고 그 둘을 터미널·AI 앱·서버 어디서든 같은 브랜드 키로 쓰는 CLI · MCP · API 세 갈래입니다.
CLI 게이트웨이 하나로 노트북에서 띄운 채팅상담 화면 — 샘플 01, 의존성 0개.
How It Works
고객 한 마디가 답장이 되기까지
카카오톡에서 고객이 말을 걸면 TalkBridge 가 서명된 이벤트로 알리고, 사람이든 AI 든 같은 발신 계약으로 답합니다.
TalkBridge
서명 웹훅 · seq 순서
at-least-once 재시도
답할 수 있나?
AI Agent 가 답장
(MCP · 스킬 · API)
상담원에게 이관
(CLI 게이트웨이 → Discord · Slack · 웹)
고객 카카오톡
답장 도착 · agent echo 로
발신 확인 · 그래프에 적재
고객이 말을 건다
카카오톡 상담톡 — 메시지, 상담 연결, 세션 만료
TalkBridge 가 알린다
HMAC 서명 웹훅, seq 순서, at-least-once 재시도
누가 답할지 정한다
AI 가 답할 수 있으면 자동 답장, 아니면 상담원 채널로 이관
고객에게 도착
같은 발신 계약으로 답장, agent echo 로 확인, 지식 그래프에 적재
Sample 04 · Auto-Reply Bot
실채널 · 실발신 실상담 시뮬레이션상담원보다 먼저 받고,
두 번째 답장부터 맥락을 잇는 자동응대봇
응대 규칙은 코드가 아니라 웹 화면에서 만듭니다 — 봇 페르소나, 대응 지식, 그리고 "이런 문의면 이 순서로" 진행하는 간단 시나리오.
CLI 게이트웨이로 받은 고객 메시지를 같은 상담 세션의 이력·진행 상태와 함께 OpenAI 에 넘기고, 답장은 CLI send 로 돌려보냅니다.
아래는 톡브릿지 내부에서 실제 카카오톡 채널로 문의하고 이 샘플이 실발신으로 자동응대한 결과입니다.
요금제 안내 2/3 · 월예상고객수=250명, 오른쪽은 발신됨·응답시간·판단 근거가 쌓이는 봇 활동 로그.규칙은 웹에서
페르소나 · 대응 지식 카드 · 시나리오 플로우(의도 → 단계 → 완료 후 계속/상담원 연결/종료)를 화면에서 편집하고, 카카오 발신 없는 시뮬레이터로 먼저 다듬습니다.
맥락은 매 턴 이어서
"250명정도?" 같은 짧은 답을 직전 질문의 대답으로 받아 다음 단계로. 주제가 바뀌면 시나리오를 전환하고, 이미 받은 정보는 다시 묻지 않습니다. 금액은 지식에 넣은 값만 씁니다.
자동응답 사고를 막는 가드
내 발신 agent echo 무한 루프 차단, 게이트웨이 재기동 시 과거 문의 일괄 답장 차단, 사람이 답하면 그 방의 봇 정지, dry-run 기본. 의존성 0 · 공인 도메인 불필요.
Features
무엇이 들어 있나
브랜드 키 하나, 세 갈래
CLI · MCP · API 가 같은 브랜드 키와 같은 대화 흐름을 씁니다. 터미널에서 검증한 것을 AI 앱에 붙이고, 서버로 옮겨도 모델이 바뀌지 않습니다.
AI 와 쓰는 CLI
전역 --json 으로 REST 와 같은 필드명을 한 줄로 돌려줍니다. 스크립트, 에이전트, Claude Code 같은 코딩 도구가 파싱 없이 바로 씁니다. env --json 이 런처 경로까지 알려줍니다.
MCP — 코드 없이 AI 앱에서
MCP 커넥터 주소 하나를 ChatGPT · Claude 에 붙이고 구글 로그인하면 끝. "지금 상담 중인 고객 보여줘", "그 고객에게 답장 보내줘" 로 채널 연결부터 응대까지 AI 가 수행합니다.
서명 웹훅 · at-least-once
HMAC-SHA256 서명, X-Bridge-Delivery-Id 멱등 키, 단조증가 seq. 호스티드 게이트웨이는 원장에 영속되어 재기동 후에도 재시도합니다. 서버가 해야 할 5단계가 문서에 있습니다.
도메인 없이 수신 — 게이트웨이
talkbridge gateway start 가 내 쪽에서 밖으로 붙어 상담을 Discord · Slack · 로컬 웹훅으로 팬아웃합니다. 공인 도메인·TLS·방화벽 없이 노트북과 사내망에서 바로 상담을 받습니다.
상담지식 온톨로지 · AI 상담원
게이트웨이가 상담을 고객→문의→응답 그래프로 적재하고 knowledge search 로 Cypher·자연어 조회. AI 프로바이더를 켜면 엔티티 추출과 스킬 기반 AI 상담원까지 — 온디바이스로 실험합니다.
Jev 활용 — 쓰지 않고 고르는 AI 로 0.2초 자동응대
TypeSafe 의 System One 모델 Jev 는 답장을 생성하지 않고 FAQ 카드 · 시나리오 선택지 중에서 고릅니다. 고객에게 나가는 글은 전부 웹에서 써 둔 문구라 없는 말을 지어낼 수 없고, 매 턴 주는 확신도로 자동 답변 · 되묻기 · 상담원 연결을 가릅니다. 의도 · 시나리오 대답 · 상담원 요청 · 불만도를 한 번의 요청으로 병렬 판정합니다.
- 98%한국어 의도 판정 · 단계 대답 100%
- 0자동 답변 오답 (평가 67건)
- 205ms턴당 판정 p50 · ≈ $0.00012
월 101~300명 98% 로 분류 · 턴당 0.2초채널 · CRM · AI · 지식은 설치 후 talkbridge setup 에서 켭니다.
Three Ways In
세 갈래, 하나의 브릿지
누가 쓰느냐에 따라 진입점만 다릅니다. 브랜드 키, 대화 흐름, 필드명은 전부 같습니다.
talkbridge CLI
로그인 한 번으로 상담 조회·발신·삭제·차단·설정. 게이트웨이 데몬이 Discord · Slack · 웹훅 · 온톨로지 싱크로 팬아웃. TUI 마법사, --json, 5개 플랫폼 바이너리.
MCP connector
mcp.talkbridge.io/mcp 를 ChatGPT · Claude Desktop 에 붙이면 채널 온보딩, 상담 조회, 답장, 차단을 자연어로. 내 파트너 계정의 브랜드만 봅니다.
Developer API
api.talkbridge.io REST 발신 + 서명 웹훅 수신. 호스티드 게이트웨이가 영속·재시도를 맡고, 파트너는 2xx 와 멱등만 챙기면 됩니다. 스코프별 Agent 키.