crm-mcp

MCP-сервер (Model Context Protocol), который связывает Claude Code с CRM Rowan Rose. Выступает в роли легкого транслятора между вызовами инструментов MCP в Claude и существующими REST-эндпоинтами /api/crm/* на бэкенде CRM.

Архитектура

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

Три независимых границы аутентификации; этот сервер не хранит учетные данные БД или S3.

Инструменты (Фаза 1, только чтение)

Локальная разработка

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)

Проверка работоспособности:

curl http://127.0.0.1:5050/healthz

Развертывание в продакшн

Запускается через PM2 на выделенном EC2 (отдельно от сервера CRM).

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

Nginx завершает TLS для mcp.rowanroseclaims.co.uk и проксирует запросы на 127.0.0.1:5050.

Регистрация в Claude Code

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

Переменные окружения

См. .env.example. Никогда не добавляйте .env в репозиторий.

Журнал аудита

Каждый вызов инструмента записывает структурированную строку лога через pino. Логи сохраняются в /home/ubuntu/crm-mcp/logs/. В фазе 3 они будут перенесены в таблицу mcp_audit_log в Postgres.

Лицензия

Внутреннее использование — Rowan Rose / Fast Action Claims.