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密钥。

环境变量

获取零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。

许可证

麻省理工学院