crm-mcp MCP 服务说明文档

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:5050stdio传输用于直接Claude Code stdio使用生产环境mcp.rowanroseclaims.co.ukHTTPS4.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格式后端APIREST API (/api/crm/*)4.4 服务器配置在Claude Code中注册MCP服务器claude mcp add --transport http crm \ https://mcp.rowanroseclaims.co.uk/mcp \ --header Authorization: Bearer \ --scope user5. 接口定义该服务提供以下主要工具接口工具名称描述主要参数crm_lookup_contact查找联系人reference, email, 或 namecrm_get_contact获取联系人详情contact_idcrm_get_case获取案例详情case_idcrm_list_documents列出文档contact_id, case_id, lender, category (可选)crm_read_document读取文档内容document_idcrm_search跨搜索querycrm_get_timeline获取时间线contact_idcrm_list_lenders列出贷款人无6. 快速开始6.1 环境要求Node.jsv16或更高版本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/healthz6.4 生产环境部署# 在EC2上部署PM2管理 git pull npm ci npm run build pm2 reload ecosystem.config.cjs pm2 save6.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 Smith7. 注意事项内部许可证该服务为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 ──HTTPSBearer──▶ mcp.rowanroseclaims.co.uk ──HTTPSx-api-key──▶ crm.rowanroseclaims.co.uk/api/crm/* (MCP服务器, EC2) (现有CRM, EC2)相关资源GitHub仓库RRS-repositories/MCP生产环境https://mcp.rowanroseclaims.co.uk