crm-mcp

Servidor MCP (Model Context Protocol) que conecta Claude Code con el CRM de Rowan Rose. Actúa como un traductor ligero entre las llamadas a herramientas MCP de Claude y los endpoints REST /api/crm/* existentes en el backend del CRM.

Arquitectura

Claude Code  ──HTTPS+Bearer──▶  mcp.rowanroseclaims.co.uk  ──HTTPS+x-api-key──▶  crm.rowanroseclaims.co.uk/api/crm/*
                                (this server, EC2)                              (existing CRM, EC2)

Tres límites de autenticación independientes; este servidor no almacena credenciales de DB ni de S3.

Related MCP server: MCP ERPNext Plugin

Herramientas (Fase 1, solo lectura)

Desarrollo local

cp .env.example .env
# fill in CRM_API_KEY (from CRM .env) and MCP_API_KEY (generate)
npm install
npm run build
npm start            # HTTP transport on :5050
npm run start:stdio  # stdio transport (for direct Claude Code stdio use)

Verificación de estado:

curl http://127.0.0.1:5050/healthz

Despliegue en producción

Se ejecuta bajo PM2 en una instancia EC2 dedicada (separada del servidor del CRM).

git pull
npm ci
npm run build
pm2 reload ecosystem.config.cjs
pm2 save

Nginx termina TLS para mcp.rowanroseclaims.co.uk y realiza el proxy hacia 127.0.0.1:5050.

Registro en Claude Code

claude mcp add --transport http crm \
  https://mcp.rowanroseclaims.co.uk/mcp \
  --header "Authorization: Bearer <MCP_API_KEY>" \
  --scope user

Variables de entorno

Ver .env.example. Nunca subas .env al repositorio.

Registro de auditoría

Cada llamada a una herramienta escribe una línea de registro estructurada a través de pino. Los registros se guardan en /home/ubuntu/crm-mcp/logs/. La Fase 3 moverá estos registros a una tabla mcp_audit_log en Postgres.

Licencia

Interna — Rowan Rose / Fast Action Claims.