@retainq/mcp

RetainQ MCP Server — AI 어시스턴트를 이탈 감소 플랫폼에 연결하세요.

이건 무엇인가요?

이것은 RetainQ를 위한 Model Context Protocol (MCP) 서버입니다. AI 어시스턴트(Claude, Cursor, Kiro 등)가 여러분의 RetainQ 워크스페이스와 상호작용할 수 있게 해 줍니다 — 리텐션 지표 조회, 플로우 관리, 이탈 데이터 분석 등.

Related MCP server: Attio MCP Server

설치

npx @retainq/mcp

또는 전역으로 설치하려면:

npm install -g @retainq/mcp

구성

환경 변수

RetainQ API 키를 설정하세요:

export RETAINQ_API_KEY=rq_live_your_key_here

RetainQ 대시보드의 설정 → API 키에서 API 키를 발급받으세요.

MCP 클라이언트 설정

MCP 클라이언트 설정에 추가하세요(예: Claude Desktop, Kiro, Cursor):

{
  "mcpServers": {
    "retainq": {
      "command": "npx",
      "args": ["@retainq/mcp"],
      "env": {
        "RETAINQ_API_KEY": "rq_live_your_key_here"
      }
    }
  }
}

사용 가능한 도구 (32)

분석

• get_retention_stats — 워크스페이스 지표 개요

• get_recent_sessions — 결과가 포함된 최신 플로우 세션

• get_top_churn_reasons — 빈도순으로 정렬된 이탈 사유

• get_high_risk_customers — 이탈 위험 임계값을 초과한 고객

• get_offer_performance — 오퍼 수락률 및 수익

플로우

• list_flows — 모든 플로우 목록 조회

• get_flow — 플로우 세부 정보 조회

• create_flow — 새 플로우 생성(간편 또는 고급)

• update_flow — 플로우 메타데이터 업데이트

• delete_flow — 플로우 보관

• configure_simple_flow — 간편 플로우 구성 설정(설문, 오퍼, 피드백, 디자인)

• set_advanced_flow_schema — 노드 기반 플로우 스키마 설정

• publish_flow — 게시 및 라이브 전환

• get_flow_schema — 현재 게시된 스키마 조회

오퍼

• list_offers — 모든 리텐션 오퍼 목록 조회

• create_offer — 새 오퍼 생성

• update_offer — 오퍼 업데이트

• delete_offer — 오퍼 보관

고객

• list_customers — 이탈 점수가 있는 고객 목록 조회

• get_customer — 이메일로 고객 조회

• get_customer_sessions — 고객의 세션 이력 조회

기회

• list_opportunities — 리텐션 기회 목록 조회

• confirm_opportunity — 기회 확인/이행

• reject_opportunity — 기회 거부

AI 인텔리전스

• run_churn_analysis — AI 기반 이탈 분석 실행

• ask_ai — 데이터에 대해 RetainQ AI에 질문

알림

• list_notifications — 최근 알림 조회

• get_notification_preferences — 알림 설정 조회

• update_notification_preferences — 알림 설정 업데이트

피드백

• list_feedback — 세션 피드백/응답 조회

• export_feedback_csv — 피드백을 CSV로 내보내기

API 기본 URL

기본적으로 https://app.retainq.com/api/v1/public에 연결됩니다. 다음과 같이 재정의하세요:

export RETAINQ_API_URL=http://localhost:3000/api/v1/public

라이선스

MIT