LeadFunnel MCP — Render

Servidor MCP con la sesión en RAM del proceso. Sin base, sin disco, sin cache.

POST /cargar   →  Salesforce → depura → scorea → RAM
POST /mcp      →  Claude consulta (lee de RAM)
POST /purgar   →  RAM = null
GET  /health   →  ¿está vivo? ¿hay sesión?

Cuando Render apaga el servicio por inactividad, el proceso muere y los datos se van con él. Esa es la garantía de efimeridad — no depende de un TTL.

Deploy

1. Subí este repo a GitHub (privado).

2. Render → New → Web Service → conectá el repo.

3. Configuración:

   • Runtime: Node

   • Build command: npm install

   • Start command: npm start

   • Health check path: /health

Variables de entorno

Related MCP server: Salesforce MCP Server

Prueba

# Salud
curl https://TU-APP.onrender.com/health

# Cargar (tarda: hace todo el pull de Salesforce)
curl -X POST https://TU-APP.onrender.com/cargar \
  -H "Authorization: Bearer $MCP_TOKEN"

# Handshake MCP
curl -X POST "https://TU-APP.onrender.com/mcp?k=$MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

# Purgar
curl -X POST https://TU-APP.onrender.com/purgar \
  -H "Authorization: Bearer $MCP_TOKEN"

El header Accept con text/event-stream es obligatorio en Streamable HTTP. Sin él, el SDK rechaza el request.

Inspector oficial antes de conectar a Claude:

npx @modelcontextprotocol/inspector

Conectar a Claude

claude.ai → Customize → Connectors → + → Add custom connector

URL: https://TU-APP.onrender.com/mcp?k=TU_TOKEN

Flujo de trabajo diario

1. POST /cargar cuando arrancás

2. Consultás desde Claude todo lo que quieras

3. Si te fuiste un rato largo, Render apagó el servicio: volvé a /cargar

Limitaciones conocidas

Cold start. En el free tier, tras ~15 min sin tráfico Render apaga el servicio. La siguiente request lo despierta (~50 s) y la sesión se perdió. Si molesta: plan pago, o un cron que le pegue a /health cada 10 min (aunque eso mantiene los datos vivos en RAM indefinidamente, que es justo lo que no querías).

Token en la URL. La UI de conectores de Claude no permite headers arbitrarios. El token en query param es más débil que un header: queda en la config del conector y potencialmente en logs. El paso siguiente es OAuth 2.0 real, que con el SDK es factible pero es otro proyecto.

RAM. 12k leads ≈ 25 MB en objetos JS. El free tier de Render da 512 MB. Holgado, pero si el dataset creciera mucho habría que paginar.

Qué se guarda

Con ENMASCARAR_PII=false se guardan teléfono y mail completos. Es una decisión de riesgo consciente: con esa variable en false, los datos de contacto de candidatos reales entran al contexto del modelo en cada consulta.