crm-mcp MCP 服务说明文档-尧图网站建设

📅 发布时间：2026/7/16 5:44:57

1. 服务概述

一句话简介：连接Claude Code到Rowan Rose CRM的MCP服务器，作为MCP工具调用和CRM REST端点之间的轻量级翻译器。

服务名称：crm-mcp
版本号：Phase 1 (只读版本)
开发者/提供方：RRS-repositories (Rowan Rose / Fast Action Claims)
协议类型：MCP (Model Context Protocol)

2. 核心功能

该MCP服务提供的主要功能点（Phase 1，只读工具）：

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：已知贷款人目录（规范名称+别名）

3. 使用场景

该服务适合在以下情况下使用：

CRM系统管理：通过Claude Code管理和查询Rowan Rose CRM系统中的数据
联系人查询：快速查找和获取联系人详细信息及其关联案例
案例管理：查看案例状态、时间线和相关文档
文档管理：浏览和读取存储在S3中的CRM文档
贷款人管理：查询和管理贷款人信息

4. 接入方式

4.1 服务端点

该服务支持多种传输方式：

HTTP传输：本地开发环境运行在localhost:5050
stdio传输：用于直接Claude Code stdio使用
生产环境：mcp.rowanroseclaims.co.uk（HTTPS）

4.2 认证与权限

服务采用三层独立认证边界：

Claude Code → MCP服务器：HTTPS + Bearer Token (MCP_API_KEY)
MCP服务器 → CRM后端：HTTPS + x-api-key (CRM_API_KEY)
安全设计：MCP服务器不持有数据库或S3凭证

4.3 数据格式

服务使用以下数据格式进行通信：

通信协议：MCP JSON-RPC
传输方式：HTTP或stdio
数据序列化：JSON格式
后端API：REST API (/api/crm/*)

4.4 服务器配置

在Claude Code中注册MCP服务器：

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

5. 接口定义

该服务提供以下主要工具接口：

工具名称	描述	主要参数
crm_lookup_contact	查找联系人	reference, email, 或 name
crm_get_contact	获取联系人详情	contact_id
crm_get_case	获取案例详情	case_id
crm_list_documents	列出文档	contact_id, case_id, lender, category (可选)
crm_read_document	读取文档内容	document_id
crm_search	跨搜索	query
crm_get_timeline	获取时间线	contact_id
crm_list_lenders	列出贷款人	无

6. 快速开始

6.1 环境要求

Node.js：v16或更高版本
TypeScript：用于编译和运行
PM2：生产环境进程管理
Nginx：生产环境TLS终止和反向代理
CRM API密钥：从CRM系统获取

6.2 本地开发

# 克隆仓库 git clone https://github.com/RRS-repositories/MCP cd MCP # 配置环境变量 cp .env.example .env # 编辑.env文件，填入CRM_API_KEY和MCP_API_KEY # 安装依赖 npm install # 构建项目 npm run build # 启动HTTP服务器 npm start # HTTP传输，监听:5050 # 或启动stdio服务器 npm run start:stdio # stdio传输

6.3 健康检查

# 检查服务是否正常运行 curl http://127.0.0.1:5050/healthz

6.4 生产环境部署

# 在EC2上部署（PM2管理） git pull npm ci npm run build pm2 reload ecosystem.config.cjs pm2 save

6.5 使用示例

# 在Claude Code中使用 @crm-mcp look up contact Jane Doe @crm-mcp get case details for case #12345 @crm-mcp list documents for contact John Smith

7. 注意事项

内部许可证：该服务为Rowan Rose / Fast Action Claims内部使用，非开源项目
只读模式：当前Phase 1版本仅支持只读操作，不支持写入
安全架构：采用三层独立认证边界，MCP服务器不持有数据库或S3凭证
审计日志：每个工具调用都会通过pino写入结构化日志，存储在/home/ubuntu/crm-mcp/logs/
环境变量：切勿提交.env文件到版本控制系统
生产环境：运行在独立的EC2实例上，与CRM服务器分离
未来计划：Phase 3将把审计日志迁移到Postgres mcp_audit_log表

系统架构

Claude Code ──HTTPS+Bearer──▶ mcp.rowanroseclaims.co.uk ──HTTPS+x-api-key──▶ crm.rowanroseclaims.co.uk/api/crm/* (MCP服务器, EC2) (现有CRM, EC2)

crm-mcp MCP 服务说明文档