LeadFunnel MCP — Render

세션이 프로세스 RAM에 저장되는 MCP 서버. 데이터베이스 없음, 디스크 없음, 캐시 없음.

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

Render가 비활성 상태로 서비스를 종료하면 프로세스가 죽고 데이터도 함께 사라집니다. 이것이 휘발성의 보장입니다 — TTL에 의존하지 않습니다.

배포

1. 이 저장소를 GitHub에 올립니다(비공개).

2. Render → New → Web Service → 저장소를 연결합니다.

3. 설정:

   • Runtime: Node

   • Build command: npm install

   • Start command: npm start

   • Health check path: /health

환경 변수

Related MCP server: Salesforce MCP Server

테스트

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

Streamable HTTP에서 text/event-stream이 포함된 Accept 헤더는 필수입니다. 이것이 없으면 SDK가 요청을 거부합니다.

Claude에 연결하기 전에 공식 Inspector를 먼저 사용하세요:

npx @modelcontextprotocol/inspector

Claude에 연결

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

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

일일 작업 흐름

1. 시작할 때 POST /cargar 호출

2. Claude에서 원하는 모든 것을 조회

3. 오랫동안 자리를 비웠다면 Render가 서비스를 종료했을 수 있음: /cargar로 다시 호출

알려진 제한 사항

콜드 스타트. 무료 티어에서는 약 15분간 트래픽이 없으면 Render가 서비스를 종료합니다. 다음 요청이 서비스를 깨우지만(~50초) 세션은 이미 손실되었습니다. 불편하다면: 유료 플랜을 사용하거나, 10분마다 /health를 호출하는 cron을 사용하세요(단, 이렇게 하면 데이터가 RAM에 무기한 유지되어 원치 않던 상황이 됩니다).

URL의 토큰. Claude의 커넥터 UI는 임의의 헤더를 허용하지 않습니다. 쿼리 파라미터의 토큰은 헤더보다 약합니다: 커넥터 설정에 남고 잠재적으로 로그에도 남습니다. 다음 단계는 실제 OAuth 2.0이며, SDK로 구현 가능하지만 별도의 프로젝트입니다.

RAM. 12k 리드 ≈ JS 객체 기준 약 25MB. Render 무료 티어는 512MB를 제공합니다. 넉넉하지만, 데이터셋이 크게 늘어나면 페이지네이션이 필요합니다.

저장되는 항목

ENMASCARAR_PII=false로 설정하면 전화번호와 이메일이 전체로 저장됩니다. 이는 의식적인 위험 결정입니다: 해당 변수가 false이면 실제 지원자의 연락처 데이터가 모든 조회에서 모델 컨텍스트에 포함됩니다.