MonadsAG/capsulecrm-mcp

分类File System
作者Community
星标578
定价Free

简介

这是一个将 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 SettingsAPI
3. ✨ 生成一个新的 API token
4. 💾 复制并安全保存(之后将无法再次查看!)

💡 使用示例

👥 客户管理

  • 🔍 “查找所有在纽约的 VIP 客户”
  • 📅 “显示 30 天内未联系的客户”

💰 销售管线

  • 💎 “目前所有开启机会的总价值是多少?”
  • 📈 “显示本季度结单的交易”
  • 🎯 “为 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 体验了吗?让数据管理变得有趣!🎉🚀*