---

name: pipedrive-automation description: "通过 Rube MCP（Composio）自动化 Pipedrive CRM 操作，包括交易、联系人、组织、活动、备注和管道管理。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Pipedrive 自动化

通过 Composio 的 Pipedrive 工具包自动化 Pipedrive CRM 工作流，包括交易管理、联系人和组织操作、活动调度、备注以及管道/阶段查询。

前提条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用工具包 pipedrive 建立活跃的 Pipedrive 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

获取 Rube MCP：在你的客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥 — 只需添加端点即可使用。

1. 通过确认 RUBE_SEARCH_TOOLS 有响应来验证 Rube MCP 可用
2. 使用工具包 pipedrive 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE 状态，按照返回的认证链接完成 Pipedrive OAuth
4. 在运行任何工作流之前确认连接状态显示 ACTIVE

核心工作流

1. 创建和管理交易

何时使用：用户想要在销售管道中创建新交易、更新现有交易或查看交易详情。

工具序列：

1. PIPEDRIVE_SEARCH_ORGANIZATIONS - 查找要关联到交易的现有组织 [可选]
2. PIPEDRIVE_ADD_AN_ORGANIZATION - 如果未找到则创建组织 [可选]
3. PIPEDRIVE_SEARCH_PERSONS - 查找要关联的现有联系人 [可选]
4. PIPEDRIVE_ADD_A_PERSON - 如果未找到则创建联系人 [可选]
5. PIPEDRIVE_GET_ALL_PIPELINES - 解析管道 ID [前提]
6. PIPEDRIVE_GET_ALL_STAGES - 解析管道内的阶段 ID [前提]
7. PIPEDRIVE_ADD_A_DEAL - 使用标题、金额、org_id、person_id、stage_id 创建交易 [必需]
8. PIPEDRIVE_UPDATE_A_DEAL - 创建后修改交易属性 [可选]
9. PIPEDRIVE_ADD_A_PRODUCT_TO_A_DEAL - 附加行项目/产品 [可选]

关键参数：

• title：交易标题（创建时必需）
• value：交易金额
• currency：3字母 ISO 货币代码（例如 "USD"）
• pipeline_id / stage_id：管道位置的数字 ID
• org_id / person_id：关联到组织和联系人
• status："open"、"won" 或 "lost"
• expected_close_date：格式 YYYY-MM-DD

注意事项：

• title 是 PIPEDRIVE_ADD_A_DEAL 唯一必需的字段；其他都是可选的
• 自定义字段在响应中显示为长哈希键；使用 dealFields 端点映射它们
• PIPEDRIVE_UPDATE_A_DEAL 需要交易的数字 id
• 将 status 设为 "lost" 时还需要提供 lost_reason

2. 管理联系人（个人和组织）

何时使用：用户想要在 Pipedrive 中创建、更新、搜索或列出联系人和公司。

工具序列：

1. PIPEDRIVE_SEARCH_PERSONS - 按姓名、邮箱或电话搜索现有人员 [前提]
2. PIPEDRIVE_ADD_A_PERSON - 如果未找到则创建新联系人 [必需]
3. PIPEDRIVE_UPDATE_A_PERSON - 修改现有联系人详情 [可选]
4. PIPEDRIVE_GET_DETAILS_OF_A_PERSON - 获取完整联系人记录 [可选]
5. PIPEDRIVE_SEARCH_ORGANIZATIONS - 搜索现有组织 [前提]
6. PIPEDRIVE_ADD_AN_ORGANIZATION - 如果未找到则创建新组织 [必需]
7. PIPEDRIVE_UPDATE_AN_ORGANIZATION - 修改组织属性 [可选]
8. PIPEDRIVE_GET_DETAILS_OF_AN_ORGANIZATION - 获取完整组织记录 [可选]

关键参数：

• name：创建个人和组织时都必需
• email：包含 value、label、primary 字段的对象数组（用于个人）
• phone：包含 value、label、primary 字段的对象数组（用于个人）
• org_id：将个人关联到组织
• visible_to：1 = 仅所有者，3 = 整个公司
• term：SEARCH_PERSONS / SEARCH_ORGANIZATIONS 的搜索词（最少2个字符）

注意事项：

• PIPEDRIVE_ADD_AN_ORGANIZATION 可能会自动与现有组织合并；检查 response.additional_data.didMerge
• 邮箱和电话字段是对象数组，不是纯字符串：[{"value": "test@example.com", "label": "work", "primary": true}]
• PIPEDRIVE_SEARCH_PERSONS 不支持通配符如 * 或 @；使用 PIPEDRIVE_GET_ALL_PERSONS 列出全部
• 通过 PIPEDRIVE_DELETE_A_PERSON 或 PIPEDRIVE_DELETE_AN_ORGANIZATION 删除是软删除，保留30天后永久删除

3. 调度和跟踪活动

何时使用：用户想要创建与交易、联系人或组织关联的电话、会议、任务或其他活动。

工具序列：

1. PIPEDRIVE_SEARCH_PERSONS 或 PIPEDRIVE_GET_DETAILS_OF_A_DEAL - 解析关联实体 ID [前提]
2. PIPEDRIVE_ADD_AN_ACTIVITY - 使用主题、类型、截止日期创建活动 [必需]
3. PI