Saas Brain Mcp

SaaS Brain MCP

Claude AI を使って、平易な英語で SaaS ビジネスについて質問できます。

「解約しそうな顧客は誰ですか？」• 「今週の売上はいくらですか？」• 「最も優良な顧客は誰ですか？」

ダッシュボードも SQL も不要です。質問するだけです。

できること

SaaS Brain は、Claude AI を Stripe と Supabase のデータに接続する MCP（Model Context Protocol）サーバーです。自然な言葉で質問すると、ビジネスに関するインサイトをすぐに得られます。

利用可能なツール

ツール	回答する内容
getRevenue	任意の期間の総売上
getTopCustomers	支出額が最も多い顧客
getActiveSubscriptions	すべての有効なサブスクリプション登録者とプラン情報
getInactiveUsers	N 日間ログインしていないユーザー
getUserActivity	特定のユーザーの最終ログインとアクティビティ
getChurnRiskUsers	利用が停止している有料ユーザー
getHighValueUsers	支出額が指定のしきい値を超える顧客
getHighValueAtRiskUsers	支出額が多く、現在は利用が停止している顧客

Claude に質問できる例

• 「1 月から 3 月までの売上はいくらですか？」
• 「支出額の多い上位 5 人の顧客を表示してください」
• 「解約するリスクがあるユーザーは誰ですか？」
• 「最も多く支払っているのに、最近ログインしていないのは誰ですか？」
• 「SaaS の健全性に関する詳細なレポートを作成してください」

技術スタック

• Java 17 + Spring Boot
• Stripe API
• Supabase REST API
• Docker
• MCP Protocol (JSON-RPC 2.0)

前提条件

• Java 17+
• Maven
• Stripe アカウント（無料。テストモードを利用できます）
• Supabase プロジェクト（無料プランを利用できます）
• Claude.ai アカウント（無料プランを利用できます）

セットアップ

1. リポジトリをクローンする

git clone https://github.com/Mohd16kaif/saas-brain-mcp.git
cd saas-brain-mcp

2. API キーを追加する

src/main/resources/application.properties を作成します。

server.port=8080
spring.application.name=saas-brain-mcp

stripe.api.key=sk_test_YOUR_STRIPE_KEY
supabase.url=https://YOUR_PROJECT.supabase.co
supabase.key=YOUR_SERVICE_ROLE_KEY

キーは次の場所で取得できます。

• Stripe：dashboard.stripe.com → Developers → API Keys
• Supabase：app.supabase.com → Settings → API → service_role key

3. ローカルで実行する

mvn spring-boot:run

動作を確認します。

curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Render にデプロイする（無料、24 時間 365 日稼働）

1. GitHub でこのリポジトリをフォークする

2. Render で新しい Web Service を作成する

• render.com → New → Web Service に移動します
• フォークしたリポジトリを接続します
• 言語：Docker
• ブランチ：main
• インスタンスタイプ：Free

3. Render で環境変数を追加する

キー	値
STRIPE_API_KEY	Stripe キー
SUPABASE_URL	Supabase プロジェクトの URL
SUPABASE_KEY	Supabase の service_role キー

4. デプロイする

Render が自動的にビルドしてデプロイします。サーバーは次の URL で稼働します。

https://your-service-name.onrender.com

Claude.ai に接続する

1. claude.ai → Settings → Connectors に移動します
2. Add custom connector をクリックします
3. 名前：saas-brain
4. URL：https://your-render-url.onrender.com/mcp
5. 保存して、チャットで有効にします

これで、ビジネスについて Claude に何でも質問できます。

Claude Desktop に接続する

claude_desktop_config.json に次の内容を追加します。

{
  "mcpServers": {
    "saas-brain": {
      "type": "http",
      "url": "https://your-render-url.onrender.com/mcp"
    }
  }
}

ファイルの場所：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

重要な注意事項

• auth.users をクエリするには、Supabase の service_role キーを使用してください（anon キーではありません）
• 解約の検出では、Stripe と Supabase のメールアドレスを照合します。両方で同じメールアドレスを使って登録するようにしてください
• Render の無料インスタンスは、15 分間操作がないとスリープします。最初のリクエストでは、起動まで 30 秒かかる場合があります

費用

$0 Stripe のテストモードは無料で、Supabase の無料プランは恒久的に利用でき、Render の無料プランは個人利用に十分です。

ライセンス

MIT 無料で利用、変更、デプロイできます。

制作

Mohd. Kaif Shaikh GitHub