用途

CapsuleCRM MCP Server 将 Claude 直接连接到 CapsuleCRM 账户，使用户可以用自然语言进行客户和销售管理。用户可以用平实的英语与 CRM 交互，例如“显示上个月所有 VIP 客户”，并完成搜索、筛选、查询、创建、更新等操作。

主要能力

客户管理（Parties）：查看、创建、更新个人和组织；按姓名、邮箱、电话、地址搜索；按标签、位置、联系信息筛选。
销售管道（Opportunities）：跟踪交易及其阶段进展；自动计算概率加权价值；全面的筛选和搜索；收入洞察与报告。
任务管理：创建、查看、更新任务；按状态、负责人、截止日期筛选；将任务关联到客户和交易。
管道配置：查看所有管道里程碑；跟踪机会在各阶段的进展。
搜索运算符：contains（部分匹配）、starts with / ends with（前缀/后缀匹配）、is after / is before（日期比较）、is greater than / is less than（数值筛选）、is within last（最近时间段）。
高级筛选：可提出复杂问题，例如“查找金额超过 $50,000 且处于提案阶段的销售机会”、“显示过去 30 天添加且带有 hot-lead 标签的客户”、“列出分配给我团队的所有逾期任务”。
使用示例：客户管理如“查找纽约的所有 VIP 客户”、“显示我们 30 天未联系的客户”、“创建新联系人：John Smith, john@acme.com”；销售管道如“我们开放机会的总价值是多少？”、“显示本季度成交的交易”、“为 Acme Corp 创建价值 $25,000 的新机会”；任务管理如“哪些任务逾期了？”、“显示分配给 Sarah 的所有任务”、“为下周五创建跟进任务”。

Claude Desktop：下载 capsulecrm-mcp.dxt 文件，双击在 Claude Desktop 中安装，按提示输入 CapsuleCRM API 密钥，然后即可使用自然语言 CRM 命令。
命令行（uvx）：通过 stdio 运行服务器而无需 .dxt，例如用于 MCP hub。可固定标签或提交：uvx --from . capsulecrm-mcp。若没有 CAPSULECRM_ACCESS_TOKEN，服务器将以代码 1 退出。
获取 API 密钥：登录 CapsuleCRM 仪表板，进入 Account Settings → API，生成新 API 令牌，安全复制并存储（不会再显示）。
调试模式：设置环境变量 LOG_LEVEL=DEBUG 可获取详细日志。

适用于需要快速查询和管理 CapsuleCRM 中客户、销售机会和任务的用户，尤其是希望通过自然语言对话完成 CRM 操作、减少手动点击的场景。

使用官方 CapsuleCRM API 和安全的令牌认证；不存储数据，仅作为实时桥接；通过环境变量安全存储令牌；读写权限与 CapsuleCRM 中配置的一致。
故障排除：扩展无法启动时，验证 API 密钥正确、检查与 CapsuleCRM 的网络连接、确保已安装 Python 3.11+；“No module found”错误时，依赖已捆绑在扩展中，可尝试重新安装扩展；验证 CapsuleCRM 中的 API 密钥权限；检查是否超出速率限制。
采用 MIT 许可证，详见 LICENSE 文件。由 Monads AG 开发。