AI导哈

CRM集成服务器

Zero MCP Server是一个用于集成Zero CRM与Claude Desktop及其他MCP兼容客户端的模型上下文协议服务器，提供对公司、联系人和交易的全面CRUD操作。

  • by san2uu
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 san2uu/Zero-MCP

使用说明

零MCP服务器

用于集成的MCP（模型上下文协议）服务器 零CRM Claude Desktop和其他MCP兼容客户端。

特性

  • 16工具 用于对公司、联系人和交易进行完整的CRUD操作
  • 单工作区模式 -自动缓存工作区ID
  • 智能过滤 -使用JSON where 用于强大查询的子句
  • 分页 -内置 limit/offset 支持
  • 格式化输出 -Markdown响应以提高可读性

安装

npm install
npm run build

配置

克劳德桌面版

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "zero": {
      "command": "node",
      "args": ["/path/to/zero-api/dist/index.js"],
      "env": {
        "ZERO_API_KEY": "your-api-key-here",
        "ZERO_WORKSPACE_NAME": "My Workspace"
      }
    }
  }
}

替换 /path/to/zero-api 并添加您的Zero API密钥。

环境变量

变量 必填 描述
ZERO_API_KEY 是 您的Zero API密钥
ZERO_WORKSPACE_NAME 无 要使用的工作区名称（默认为第一个工作区）

获取零API密钥

向Zero团队请求API密钥。自助式API密钥生成尚不可用。

可用工具

工作区

  • zero_get_workspace -获取并缓存默认工作区

公司

  • zero_list_companies -使用筛选功能列出/搜索公司
  • zero_get_company -按ID获取公司
  • zero_create_company -创建新公司
  • zero_update_company -更新公司字段
  • zero_delete_company -存档或删除公司

联系人

  • zero_list_contacts -使用筛选功能列出/搜索联系人
  • zero_get_contact -通过ID获取联系方式
  • zero_create_contact -创建新联系人
  • zero_update_contact -更新联系人字段
  • zero_delete_contact -存档或删除联系人

交易

  • zero_list_deals -列出/搜索与过滤有关的交易
  • zero_get_deal -通过ID获取交易
  • zero_create_deal -创建新交易
  • zero_update_deal -更新交易字段
  • zero_delete_deal -存档或删除交易

使用示例

配置后，您可以询问Claude：

  • “我连接到了哪个工作区？”
  • “列出我的所有公司”
  • “在谈判中展示超过5万美元的交易”
  • “为Acme Corp创建联系人”
  • “将交易X更新为‘封闭式韩元’”

过滤

工具支持JSON where MongoDB风格的子句 $-前缀运算符：

{"name": {"$contains": "Acme"}}
{"value": {"$gte": 50000}}
{"value": {"$between": [1000, 5000]}}
{"stage": {"$in": ["stage-id-1", "stage-id-2"]}}
{"closeDate:month": "2026-01"}
{"ownerIds": {"$includes": "user-id"}}
{"location.city": "San Francisco"}

发展

npm run dev    # Watch mode
npm run build  # Build for production

api参考

该服务器与Zero的REST API集成。看 src/api-reference.ts 用于记录端点。

注： 零处于测试阶段。当他们更新API时，相应地更新此MCP。

许可证

麻省理工学院

相关 MCP