MonadsAG/capsulecrm-mcp
简介
这是一个将 Capsule CRM 接入 AI 客户端的 MCP 服务端实现。它打破了 CRM 数据与 AI 聊天的隔阂,让开发者无需手动导出数据,即可通过 Claude Desktop 等支持 MCP 的工具直接查询、管理客户联系人、销售机会和待办任务。对于需要快速同步 CRM 状态或利用 AI 进行客户分析的用户来说,它将 CRM 从单纯的记录本变成了 AI 的实时知识库。上手门槛低,配置完成后即可通过自然语言指令完成原本繁琐的 CRM 操作。
核心亮点
- 实现 AI 对 Capsule CRM 数据的实时读写
- 支持管理联系人、销售机会与任务清单
- 兼容 Claude Desktop,配置简单快速上手
- 将 CRM 转化为 AI 的外部增强上下文
完整文档
🚀 CapsuleCRM MCP Server
用 AI 变革你的 CRM 工作流!🤖✨ 将 Claude 直接连接到你的 CapsuleCRM 账户,实现自然语言的客户与销售管理。
🎯 功能特性
- 🗣️ 使用自然语言与 CRM 交互 - 例如 “显示上个月的所有 VIP 客户”
- 🔍 智能搜索与过滤 - 通过强大的查询精准找到所需内容
- 📊 获取即时洞察 - 查询销售管线、客户数据和任务
- ⚡ 自动化常规任务 - 通过对话创建、更新和管理 CRM 数据
🎉 安装步骤
🖥️ Claude Desktop
1. 📥 下载capsulecrm-mcp.dxt 文件
2. 👆 双击安装至 Claude Desktop
3. 🔑 根据提示输入你的 CapsuleCRM API key
4. 🎊 开始使用自然语言 CRM 命令!
🔑 获取 API Key
1. 🌐 登录你的 CapsuleCRM 控制面板
2. ⚙️ 前往 Account Settings → API
3. ✨ 生成一个新的 API token
4. 💾 复制并安全保存(之后将无法再次查看!)
💡 使用示例
👥 客户管理
- 🔍 “查找所有在纽约的 VIP 客户”
- 📅 “显示 30 天内未联系的客户”
- ➕ “创建新联系人:John Smith, [email protected]”
💰 销售管线
- 💎 “目前所有开启机会的总价值是多少?”
- 📈 “显示本季度结单的交易”
- 🎯 “为 Acme Corp 创建一个价值 $25,000 的新机会”### ✅ 任务管理
- ⏰ “哪些任务已过期?”
- 👩💼 “显示所有分配给 Sarah 的任务”
- 📝 “为下周五创建一个跟进任务”
🔮 高级筛选
询问复杂问题,例如:- 💵 “查找金额超过 $50,000 且处于 proposal 阶段的机会”
- 🏷️ “显示过去 30 天内添加且带有 hot-lead 标签的客户”
- 👥 “列出分配给我团队的所有过期任务”
🎪 功能能力
👥 客户管理 (Parties)
- 👀 查看、创建、更新人员和组织
- 🔎 按姓名、电子邮件、电话、地址搜索
- 🏷️ 按标签、位置、联系信息筛选
💼 销售管线 (Opportunities)
- 📊 跟踪交易及其在各阶段的进展
- 🎲 自动计算概率加权值
- 🔍 全面的筛选与搜索
- 💰 营收洞察与报表
✅ 任务管理
- 📋 创建、查看和更新任务
- 🎯 按状态、负责人、截止日期筛选
- 🔗 将任务链接到客户和交易
🎯 管线配置
- 📈 查看所有管线里程碑
- 🚀 跟踪机会在各阶段的进展
🔧 搜索运算符
- 🔍
contains- 查找部分匹配
- 🎯
starts with/ends with- 前缀/后缀匹配
- 📅
is after/is before- 日期比较
- 📊
is greater than/is less than- 数值筛选
- ⏰
is within last- 最近时间段
🚨 故障排除
🚫 扩展无法启动:
- ✅ 验证 API key 是否正确
- 🌐 检查与 CapsuleCRM 的网络连接
- 🐍 确保已安装 Python 3.11+📦 "No module found" 错误:
- 🎁 依赖项已捆绑在扩展中
- 🔄 尝试重新安装扩展
⚠️ API 错误:
- 🔐 验证 CapsuleCRM 中的 API key 权限
- 🚦 检查是否超过 rate limits
🐛 Debug 模式:
设置环境变量 LOG_LEVEL=DEBUG 以获取详细日志。
🛡️ 安全与隐私
- 🔐 使用带有安全 token 认证的官方 CapsuleCRM API
- 🚫 无数据存储 - 作为实时桥接运行
- 🔒 使用环境变量安全存储 token
- ✅ 拥有在 CapsuleCRM 中配置的完整读写权限
📄 许可证
MIT License - 详情请参阅 LICENSE 文件。
🏢 关于
由 Monads AG 开发 - AI 自动化与业务流程优化专家。
---
*准备好改变您的 CRM 体验了吗?让数据管理变得有趣!🎉🚀*