LeadFunnel MCP — Render

MCP-Server mit der Sitzung im Prozess-RAM. Keine Datenbank, keine Festplatte, kein 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?

Wenn Render den Dienst wegen Inaktivität herunterfährt, stirbt der Prozess und die Daten gehen mit ihm verloren. Das ist die Garantie der Flüchtigkeit — sie hängt nicht von einem TTL ab.

Bereitstellung

1. Lade dieses Repo auf GitHub hoch (privat).

2. Render → New → Web Service → verbinde das Repo.

3. Konfiguration:

   • Runtime: Node

   • Build command: npm install

   • Start command: npm start

   • Health check path: /health

Umgebungsvariablen

Related MCP server: Salesforce MCP Server

Test

# 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"

Der Accept-Header mit text/event-stream ist bei Streamable HTTP obligatorisch. Ohne ihn lehnt das SDK die Anfrage ab.

Offizieller Inspector vor dem Verbinden mit Claude:

npx @modelcontextprotocol/inspector

Mit Claude verbinden

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

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

Täglicher Arbeitsablauf

1. POST /cargar beim Start

2. Frag von Claude aus alles ab, was du willst

3. Wenn du längere Zeit weg warst, hat Render den Dienst heruntergefahren: ruf /cargar erneut auf

Bekannte Einschränkungen

Cold Start. Im Free-Tier fährt Render den Dienst nach ~15 Minuten ohne Traffic herunter. Die nächste Anfrage weckt ihn wieder (~50 s) und die Sitzung ist verloren. Wenn das stört: kostenpflichtiger Plan oder ein Cron, der /health alle 10 Minuten aufruft (auch wenn das die Daten dauerhaft im RAM hält, was genau das ist, was du nicht wolltest).

Token in der URL. Die Connector-UI von Claude erlaubt keine beliebigen Header. Das Token im Query-Parameter ist schwächer als ein Header: Es bleibt in der Connector-Konfiguration und möglicherweise in Logs. Der nächste Schritt ist echtes OAuth 2.0, das mit dem SDK machbar ist, aber ein anderes Projekt wäre.

RAM. 12k Leads ≈ 25 MB in JS-Objekten. Das Free-Tier von Render bietet 512 MB. Ausreichend, aber wenn der Datensatz stark wächst, müsste paginiert werden.

Was gespeichert wird

Mit ENMASCARAR_PII=false werden Telefon und E-Mail vollständig gespeichert. Das ist eine bewusste Risikoentscheidung: Mit dieser Variable auf false gelangen die Kontaktdaten echter Kandidaten bei jeder Abfrage in den Kontext des Modells.