@retainq/mcp

RetainQ MCP Server — AIアシスタントを解約防止プラットフォームに接続します。

これは何ですか？

これは Model Context Protocol (MCP) サーバーであり、RetainQ 向けのサーバーです。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 ダッシュボードの Settings → API Keys から 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