CRM集成协议服务器

一个开源的MCP(模型上下文协议)服务器,用于Cloze CRM,使AI代理能够访问联系人、公司、交易、元数据和时间线。

  • by Purple-Horizons
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Purple-Horizons/cloze-mcp

使用说明

阻塞MCP服务器

开源 MCP(模型上下文协议) 服务器 堵塞CRM.让像克劳德这样的人工智能代理访问您的联系人、公司、交易、元数据和时间线。

特性

  • 🔍 搜索和检索 --查找人员、公司和项目(基本+高级过滤器+提要)
  • 🧠 元数据洞察 --获取阶段、分段、步骤、自定义字段、团队成员/角色和保存的视图
  • 📝 时间线写入 --直接从代理创建待办事项并记录通信
  • 📊 交易管道 --按阶段和范围查询项目和交易
  • 🔒 安全 -您的API密钥保持本地,从不发送给第三方
  • ✅ 已测试 --Vitest单元测试包括工具布线+验证(运行 npm test)

快速开始

1.获取Cloze API密钥

首选 堵塞设置→ API 并创建API密钥。

2.配置您的MCP客户端

克劳德桌面版 (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "cloze": {
      "command": "npx",
      "args": ["-y", "@purplehorizons/cloze-mcp"],
      "env": {
        "CLOZE_API_KEY": "your-api-key-here"
      }
    }
  }
}

莫尔特博特 (~/.clawdbot/config/mcporter.json):

{
  "mcpServers": {
    "cloze": {
      "command": "npx",
      "args": ["-y", "@purplehorizons/cloze-mcp"],
      "env": {
        "CLOZE_API_KEY": "your-api-key-here"
      }
    }
  }
}

3.开始使用它

问你的AI助手一些事情,比如:

  • “向我展示分配给科莱特的未来阶段的所有买家”
  • “列出项目段的管道步骤”
  • “创建一个提醒,明天给Sabor Havana打电话”
  • “流式传输自上周以来公司的最新变化”

可用工具

核心查找

工具 说明
cloze_find_people, cloze_get_person 基本联系人搜索+详细信息
cloze_find_companies, cloze_get_company 公司搜索+详情
cloze_find_projects, cloze_get_project 项目/交易搜索+详细信息
cloze_get_profile 验证API连接/用户信息

元数据/分类

工具 说明
cloze_get_custom_fields 列出自定义字段(可选按关系类型)
cloze_get_people_stages, cloze_get_project_stages 阶段分类法
cloze_get_people_segments, cloze_get_company_segments, cloze_get_project_segments 分段列表
cloze_get_steps 管道步骤(按段/级过滤)
cloze_get_views 保存的视图/受众
cloze_list_team_members, cloze_list_team_roles 团队名单+角色标签

高级查找+订阅源

工具 说明
cloze_people_find_advanced GET/v1/people/find,带分页、过滤器、排序
cloze_companies_find_advanced 公司也是如此
cloze_projects_find_advanced 项目/交易也是如此
cloze_people_feed 基于光标的人员更改订阅源(支持修改后,包括审核后的更改)
cloze_companies_feed 公司动态
cloze_projects_feed 项目饲料

时间线写入

工具 说明
cloze_create_todo 创建待办事项/提醒(主题+可选时间/参与者/受让人)
cloze_log_communication 将电话、短信、电子邮件、会议等记录到时间线上

发展

# Clone the repo
git clone https://github.com/Purple-Horizons/cloze-mcp.git
cd cloze-mcp

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Run locally (after build)
CLOZE_API_KEY=your-key node dist/index.js

环境变量

变量 必填 描述
CLOZE_API_KEY 是 您的Cloze API密钥

路线图

  • [x] MVP:读取操作(查找/获取)
  • [x] 元数据助手(阶段、分段、自定义字段、步骤、团队)
  • [x] 高级搜索+订阅源
  • [x] 时间线写入(待办事项+通信)
  • []分析查询
  • []Webhook订阅
  • []用于公共集成的OAuth 2.0

贡献

欢迎投稿!请阅读我们的 贡献指南 第一。

许可证

MIT© 紫色地平线


内置于❤️ 通过 紫色地平线 对于AI代理社区来说。