retain-so

Retain MCP サーバー

AI エージェントが解約の可能性がある顧客を把握し、対処できるようにします。

@retain-so/mcp-server は、Retain をあらゆる MCP クライアント（Claude Code、Claude Desktop、Cursor、Windsurf など）に接続します。自然な言葉でリスクのある顧客を尋ねたり、顧客のヘルスプロフィール全体を取得したり、リスクにさらされている MRR を確認したり、アプローチを記録したりできます。ダッシュボードを開く必要はありません。

Retain は、AI ファーストの解約防止および顧客分析プラットフォームです。このサーバーは、エージェントと Retain のデータをつなぐ橋渡しをします。

エージェントに依頼できること

読み取り：

• 「今週、特にリスクの高い顧客は誰ですか？」
• 「リスクの高い顧客を MRR 順に表示してください。」
• 「リスクレベル別に、リスクにさらされている MRR の合計を教えてください。」
• 「Acme Inc. のプロフィール全体を取得してください。」
• 「まだ連絡していないアクティブなアラートを一覧表示してください。」
• 「今月の解約指標と純収益維持率を要約してください。」

操作（読み取り・書き込みキーが必要です）：

• 「Globex のアラートを連絡済みとしてマークしてください。」
• 「解決済みの Initech のアラートをアーカイブしてください。」

セットアップ（5 分以内）

1. Retain で、Settings → Agent keys に移動してキーを作成します。クエリのみの場合は read を、エージェントに操作を許可する場合は read & write を選択します。キーをコピーします（キーは一度しか表示されません）。
2. 以下から、お使いのクライアント用のスニペットを追加します。
3. クライアントを再起動して、最初の質問をしてみましょう。

Claude Code

claude mcp add retain --env RETAIN_API_KEY=rk_agent_xxx -- npx -y @retain-so/mcp-server

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "retain": {
      "command": "npx",
      "args": ["-y", "@retain-so/mcp-server"],
      "env": { "RETAIN_API_KEY": "rk_agent_xxx" }
    }
  }
}

Cursor / Windsurf（.cursor/mcp.json または ~/.codeium/windsurf/mcp_config.json）

{
  "mcpServers": {
    "retain": {
      "command": "npx",
      "args": ["-y", "@retain-so/mcp-server"],
      "env": { "RETAIN_API_KEY": "rk_agent_xxx" }
    }
  }
}

ツール

ツール	種類	機能
get_at_risk_customers	読み取り	解約リスク（Critical／High／Stable／Healthy）別に顧客を表示し、MRR 順に並べます。デフォルトは Critical と High です。
get_customer_details	読み取り	ID または名前で指定した 1 人の顧客のプロフィール全体を表示します。
get_mrr_at_risk	読み取り	リスクにさらされている MRR の合計と、リスクレベル別のアクティブなアラート数を表示します。
get_active_alerts	読み取り	優先度別にアクティブなアラートを表示し、リスク要因とアプローチ状況も示します。
get_churn_metrics	読み取り	解約率、解約された MRR、拡大／縮小、純収益維持率を表示します。
mark_alert_contacted	書き込み	アラートを連絡済みとしてマークします。
archive_alert	書き込み	解決済みのアラートをアーカイブします。

近日公開：send_retention_email（テンプレートを使った顧客維持メールを送信します）。

会話の例

あなた： 解約しそうな顧客は誰で、どれくらいの金額がリスクにさらされていますか？

エージェント： （get_mrr_at_risk を呼び出してから、get_at_risk_customers を呼び出します） 7 件のアクティブなアラートで、4,200 ドルの MRR がリスクにさらされています。特に大きいのは、Acme Inc.（900 ドル、重大、18 日間非アクティブ）と Globex（650 ドル、高）です。

あなた： 今日 Acme にメールしました。アラートを連絡済みとしてマークしてください。

エージェント： （mark_alert_contacted を呼び出します） 完了しました。Acme のアラートは連絡済みとしてマークされました。

設定

変数	必須	デフォルト	説明
RETAIN_API_KEY	はい	（なし）	Settings → Agent keys で取得したエージェントキーです。
RETAIN_API_URL	いいえ	https://api.retain.so	API のベース URL を上書きします（セルフホスト／ステージング）。

開発

npm install
npm run dev        # run from source with tsx
npm run build      # bundle to dist/
npm run typecheck

サーバーにはビジネスロジックもデータベースもありません。MCP ツールの呼び出しを、Retain のパブリックな /agent/* API に対する HTTP リクエストに変換するだけです。貢献や新しいツールの追加を歓迎します。

ライセンス

MIT