Close Crm

mcp-close-crm

Close CRM MCP 包 — 封装 Close（close.com）API v1。

属于 Pipeworx — 一个将 AI Agent 连接到 1875+ 个实时数据源的 MCP 网关。这是一个独立、非官方的集成，与上游提供商无关联、未获其认可，也未由其发布。

工具

工具	描述
close_me	获取所提供 API 密钥对应的当前 Close 用户和组织。返回用户 ID、姓名、电子邮件，以及该密钥可访问的组织（含 ID）。可用于验证密钥是否有效，并了解你的组织上下文。
close_search_leads	使用 Close 查询语言搜索或列出潜在客户（Close 中的公司／账户）。返回包含潜在客户的 data 数组（含 id、display_name、联系人、状态、自定义字段），以及 has_more 和 total_results。query 参数接受 Close 搜索语法，例如 name:"Acme"、status_label:"Potential"、email_address:@example.com、lead_created_within:7d 或自由文本。省略 query 可列出所有潜在客户。使用 _limit（最多 200）和 _skip 分页。
close_get_lead	根据 Close 潜在客户 ID（格式为 lead_...）获取单个潜在客户。返回完整详情：显示名称、描述、状态、联系人、地址、商机、自定义字段和时间戳。
close_list_opportunities	列出 Close 中的商机（销售管道交易）。返回包含商机的 data 数组，含 id、lead_id、状态、价值、货币、置信度和预期成交日期，以及 has_more / total_results。传入 lead_id 可限定为单个潜在客户，省略则列出整个组织中的商机。使用 _limit / _skip 分页。
close_list_contacts	列出 Close 中的联系人（人员）。返回包含联系人的 data 数组，含 id、lead_id、姓名、职务、电子邮件和电话号码，以及 has_more / total_results。可选用 lead_id 筛选单个潜在客户。使用 _limit / _skip 分页。
close_list_activities	列出某个潜在客户的活动 — 通话、电子邮件、备注、短信、会议和状态变更。返回 data 数组（含 id、_type、type、date_created 和特定类型字段），以及 has_more / total_results。需要提供 lead_id。使用 _limit / _skip 分页浏览潜在客户的时间线。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "close-crm": {
      "url": "https://gateway.pipeworx.io/close-crm/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/close-crm/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 的共享元工具 — ask_pipeworx、 discover_tools、search_within、remember/recall 和网关全局工具集中的其他工具。因此，你看到的工具数量会多于此表所列：目前，单包端点会列出大约 30 个共享工具，以及该包自身的工具。连接的 initialize 响应会说明其确切范围，也是当天查询时的权威答案。

这是有意为之，并非意外的多路复用。元工具让受限连接也能回答此包未涵盖的问题 — 通过 ask_pipeworx 路由至整个目录 — 无需添加第二个 MCP 服务。目前无法挂载不含这些元工具的包端点；如果额外的架构定义占用的上下文超过路由带来的价值，请连接一次完整网关，而不是连接多个包端点。

或者连接完整的 Pipeworx 网关，直接列出所有包的工具，而不只是此包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

这两个 URL 都连接到同一个网关和相同的 1875+ 个数据源。唯一的区别是，哪个包的工具会被直接列出；通过任一端点，ask_pipeworx 都可以访问全部工具。

没有 MCP 客户端？通过 HTTP 调用

此包需要使用你自己的 API 密钥（_apiKey）— 我们不会为它代持密钥，因此没有不带密钥即可运行的 curl 命令。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/close_me。查找工具：使用 {"query":"..."} 向 POST https://gateway.pipeworx.io/v1/tools/search_packs 发送请求。

独立运行（无需 gateway 账号）

此软件包也可作为本地 stdio MCP 服务运行，无需 Pipeworx 账号，也无需经过网关往返：

{
  "mcpServers": {
    "close-crm": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-close-crm"]
    }
  }
}

或者直接运行，确认它可以启动：

npx -y @pipeworx/mcp-close-crm

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call，仅提供此软件包中的工具，不包含上方网关连接额外提供的任何共享元工具。使用相同的源代码和工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗的英语提问，而不是直接调用工具——这既适用于上方的软件包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Close Crm data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT