SaaS Brain MCP

Haz preguntas sobre tu negocio SaaS en lenguaje sencillo usando Claude AI.

"¿Quién está a punto de darse de baja?" • "¿Cuáles son mis ingresos esta semana?" • "¿Quiénes son mis mejores clientes?"

Sin paneles de control. Sin SQL. Solo pregunta.

Qué hace

SaaS Brain es un servidor MCP (Model Context Protocol) que conecta Claude AI con tus datos de Stripe y Supabase. Haz preguntas en lenguaje natural y obtén información empresarial inteligente al instante.

Herramientas disponibles

Ejemplos de preguntas que puedes hacer a Claude

• "¿Cuáles son mis ingresos de enero a marzo?"

• "Muéstrame mis 5 mejores clientes por gasto"

• "¿Qué usuarios están en riesgo de darse de baja?"

• "¿Quién paga más pero no ha iniciado sesión recientemente?"

• "Dame un informe de salud completo de mi SaaS"

Related MCP server: indie-metrics-mcp

Stack tecnológico

• Java 17 + Spring Boot

• API de Stripe

• API REST de Supabase

• Docker

• Protocolo MCP (JSON-RPC 2.0)

Requisitos previos

• Java 17+

• Maven

• Una cuenta de Stripe (gratuita, el modo de prueba funciona)

• Un proyecto de Supabase (el nivel gratuito funciona)

• Una cuenta de Claude.ai (el nivel gratuito funciona)

Configuración

1. Clona el repositorio

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

2. Añade tus claves API

Crea 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

Obtén tus claves desde:

• Stripe: dashboard.stripe.com → Developers → API Keys

• Supabase: app.supabase.com → Settings → API → service_role key

3. Ejecuta localmente

mvn spring-boot:run

Prúebalo:

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

Despliegue en Render (gratuito, 24/7)

1. Haz un fork de este repositorio en GitHub

2. Crea un nuevo Web Service en Render

• Ve a render.com → New → Web Service

• Conecta tu repositorio bifurcado

• Lenguaje: Docker

• Rama: main

• Tipo de instancia: Free

3. Añade variables de entorno en Render

4. Despliega

Render construye y despliega automáticamente. Tu servidor estará activo en:

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

Conectar a Claude.ai

1. Ve a claude.ai → Settings → Connectors

2. Haz clic en Add custom connector

3. Nombre: saas-brain

4. URL: https://your-render-url.onrender.com/mcp

5. Guarda y habilita en el chat

Luego, simplemente pregúntale a Claude cualquier cosa sobre tu negocio.

Conectar a Claude Desktop

Añade esto a tu claude_desktop_config.json:

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

Ubicación del archivo:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Notas importantes

• Usa la clave service_role de Supabase (no la clave anon), necesaria para consultar auth.users

• La detección de abandono funciona haciendo coincidir los correos electrónicos entre Stripe y Supabase; asegúrate de que los usuarios se registren con el mismo correo en ambos

• Las instancias gratuitas de Render entran en suspensión tras 15 minutos de inactividad; la primera solicitud puede tardar 30 segundos en despertar

Coste

$0; el modo de prueba de Stripe es gratuito, el nivel gratuito de Supabase es permanente y el nivel gratuito de Render es suficiente para uso personal.

Licencia

MIT; libre de usar, modificar y desplegar.

Creado por

Mohd. Kaif Shaikh GitHub