用途:通过 Rube MCP 调用 Composio 的 HubSpot 工具包,自动化 HubSpot CRM 工作流,包括联系人/公司管理、交易管道跟踪、工单搜索和自定义属性创建。
前提条件:需先连接 Rube MCP(RUBE_SEARCH_TOOLS 可用);通过 RUBE_MANAGE_CONNECTIONS 以 toolkit hubspot 建立有效 HubSpot 连接;每次操作前先调用 RUBE_SEARCH_TOOLS 获取最新工具 schema。
设置:在客户端配置中添加 MCP 服务器 https://rube.app/mcp,无需 API 密钥;确认 RUBE_SEARCH_TOOLS 有响应;调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit hubspot;若连接非 ACTIVE,按返回的授权链接完成 HubSpot OAuth;确认状态为 ACTIVE 后再运行工作流。
核心工作流:
- 联系人:先 HUBSPOT_GET_ACCOUNT_INFO 验证连接,再用 HUBSPOT_SEARCH_CONTACTS_BY_CRITERIA 查重,可选 HUBSPOT_READ_A_CRM_PROPERTY_BY_NAME 检查属性元数据,然后 HUBSPOT_CREATE_CONTACT 创建单个或 HUBSPOT_CREATE_CONTACTS 批量创建(每批最多 100)。
- 公司:HUBSPOT_SEARCH_COMPANIES 搜索,HUBSPOT_CREATE_COMPANIES 批量创建(最多 100),HUBSPOT_UPDATE_COMPANIES 批量更新,可选 HUBSPOT_GET_COMPANY、HUBSPOT_BATCH_READ_COMPANIES_BY_PROPERTIES。
- 交易与管道:先用 HUBSPOT_RETRIEVE_ALL_PIPELINES_FOR_SPECIFIED_OBJECT_TYPE(objectType 设为 deals)映射管道与阶段,再用 HUBSPOT_SEARCH_DEALS 过滤,可选 HUBSPOT_RETRIEVE_PIPELINE_STAGES、HUBSPOT_RETRIEVE_OWNERS、HUBSPOT_GET_DEAL,回退用 HUBSPOT_LIST_DEALS。
- 工单:HUBSPOT_SEARCH_TICKETS 按 filterGroups 搜索,回退 HUBSPOT_READ_ALL_PROPERTIES_FOR_OBJECT_TYPE 发现属性名,可选 HUBSPOT_GET_TICKET、HUBSPOT_GET_TICKETS。
限制与注意:批量操作每批最多 100 条,超出需分块;属性名须用内部名称而非显示标签,否则报 400 或返回零结果;创建前先搜索避免重复;结果常嵌套在 response.data.results,金额与日期多为字符串;分页通过 paging.next.after 直到缺失;日期过滤可能需 epoch 毫秒边界,混用格式会导致不匹配;GET_ACCOUNT_INFO 出现认证错误时后续调用均会失败。其他细节暂未提供。