crm-mcp

MCP-Server (Model Context Protocol), der Claude Code mit dem Rowan Rose CRM verbindet. Er fungiert als schlanker Übersetzer zwischen den MCP-Tool-Aufrufen von Claude und den bestehenden /api/crm/* REST-Endpunkten im CRM-Backend.

Architektur

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

Drei unabhängige Authentifizierungsgrenzen; dieser Server speichert keine DB- oder S3-Anmeldedaten.

Tools (Phase 1, schreibgeschützt)

Lokale Entwicklung

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)

Gesundheitsprüfung:

curl http://127.0.0.1:5050/healthz

Produktionseinsatz

Läuft unter PM2 auf einer dedizierten EC2-Instanz (getrennt von der CRM-Box).

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

Nginx terminiert TLS für mcp.rowanroseclaims.co.uk und leitet an 127.0.0.1:5050 weiter.

Registrierung bei Claude Code

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

Umgebungsvariablen

Siehe .env.example. Committe niemals .env.

Audit-Log

Jeder Tool-Aufruf schreibt eine strukturierte Log-Zeile über pino. Die Logs landen in /home/ubuntu/crm-mcp/logs/. In Phase 3 werden diese in eine Postgres-Tabelle mcp_audit_log verschoben.

Lizenz

Intern — Rowan Rose / Fast Action Claims.