crm-mcp

MCP（模型上下文协议）服务器，用于将 Claude Code 连接到 Rowan Rose CRM。它充当 Claude 的 MCP 工具调用与 CRM 后端现有的 /api/crm/* REST 端点之间的轻量级转换器。

架构

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 凭据。

工具（第一阶段，只读）

工具	用途
`crm_lookup_contact`	通过引用、电子邮件或姓名查找联系人
`crm_get_contact`	获取完整联系人信息及其所有案例
`crm_get_case`	获取完整案例状态（贷款方、状态、日期、扩展字段）
`crm_list_documents`	列出联系人的 S3 文档（按案例/贷款方/类别过滤）
`crm_read_document`	从 PDF/DOCX 中提取文本
`crm_search`	交叉搜索联系人和案例
`crm_get_timeline`	联系人的沟通/操作时间轴
`crm_list_lenders`	已知贷款方目录（规范名称 + 别名）

本地开发

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

生产部署

在专用 EC2（与 CRM 服务器分离）上通过 PM2 运行。

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

Nginx 为 mcp.rowanroseclaims.co.uk 终止 TLS 并代理到 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/ 中。第三阶段将把这些日志迁移到 Postgres 的 mcp_audit_log 表中。

许可证

内部使用 — Rowan Rose / Fast Action Claims。

This server cannot be installed

F

license - not found

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

crm-mcp

crm-mcp

架构

工具（第一阶段，只读）

本地开发

生产部署

在 Claude Code 中注册

环境变量

审计日志

许可证

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API