awesome-claude-skills 实战：通过 Rube MCP 自动化 Salesmate 客户管理（Composio 工具集）

Salesmate 是面向销售团队的客户关系管理（CRM）平台，本篇文章围绕 composio-skills/salesmate-automation/SKILL.md 这份官方 Skill 文档展开，完整讲解如何在 awesome-claude-skills 仓库中借助 Rube MCP（基于 Composio 的 MCP 网关）自动化 Salesmate 各项业务操作。读完本文，你将掌握从 MCP 端点接入、Salesmate 连接激活、工具发现到批量执行的一整套可落地的自动化流程，并学会规避常见的 Schema 变更、连接失效与分页遗漏等坑点。

一、技能背景与定位

在 awesome-claude-skills 仓库中，composio-skills/ 目录下存放了一批“应用自动化（App Automation）”类 Skill。README.md 明确指出，这些预构建的工作流 Skill 覆盖 78 个 SaaS 应用，均通过 Rube MCP（Composio）提供，每个 Skill 都包含工具调用序列、参数指引、已知陷阱与快速参考表，且全部使用从 Composio API 发现的真实工具 slug。

本篇文章所依据的 salesmate-automation 正是其中之一：它通过 Composio 的 Salesmate 工具集（toolkit）自动执行 Salesmate 操作。该 Skill 的前置元数据（frontmatter）声明为：

• name: salesmate-automation
• description: 通过 Rube MCP（Composio）自动化 Salesmate 任务，并强调“始终先搜索工具以获取当前 Schema”；
• requires.mcp: [rube]：表明该 Skill 依赖名为 rube 的 MCP 服务器。

从机制上看，Rube MCP 相当于一个统一的工具网关：Claude 等 AI 客户端通过标准 MCP 协议连接 Rube，即可按需发现并调用 Composio 已集成的各应用工具，而无需在客户端侧逐个维护各应用的 API 凭证与签名。Skill 文档末尾的 Powered by Composio 也印证了底层能力由 Composio 平台提供。

二、前置条件

在开始任何 Salesmate 自动化工作流之前，需满足以下条件：

前置条件	说明
Rube MCP 已连接	客户端中已配置 Rube MCP，且 RUBE_SEARCH_TOOLS 工具可用
Salesmate 连接已激活	通过 RUBE_MANAGE_CONNECTIONS 并指定 toolkit 为 salesmate 建立连接
先搜索工具	每次执行前必须先调用 RUBE_SEARCH_TOOLS 获取当前工具 Schema

其中“连接状态必须为 ACTIVE”是后续所有执行步骤的前提——如果连接未激活，任何工具调用都会因缺少授权而失败。

三、环境搭建：接入 Rube MCP

接入过程非常轻量，无需申请 API Key：

获取 Rube MCP：在客户端（如 Claude Desktop / Claude Code 等支持 MCP 的配置）中添加 MCP 服务器，地址为 https://rube.app/mcp，无需任何 API Key，添加端点后即可使用。

添加完成后，按以下 4 步完成验证与初始化：

1. 验证 Rube MCP 可用：确认 RUBE_SEARCH_TOOLS 能正常响应；
2. 建立连接：调用 RUBE_MANAGE_CONNECTIONS，指定 toolkit 为 salesmate；
3. 完成授权：若连接状态不是 ACTIVE，则跟随返回的授权链接完成 Salesmate 的 OAuth 授权；
4. 确认状态：在运行任何工作流之前，确认连接状态已显示为 ACTIVE。

四、工具发现：先用 RUBE_SEARCH_TOOLS 获取最新 Schema

这是整个自动化流程的“第一步纪律”：不要硬编码工具 slug 或参数。Composio 的工具集会随上游应用 API 演进而变化，因此每次都应先通过 RUBE_SEARCH_TOOLS 动态发现当前可用的工具。

Skill 文档给出了标准调用示例：

RUBE_SEARCH_TOOLS
queries: [{use_case: "Salesmate operations", known_fields: ""}]
session: {generate_id: true}

参数解读：

• queries：描述你的具体业务用例。示例中使用 use_case: "Salesmate operations" 作为宽泛搜索；实际使用时建议替换为更具体的用例描述（如“创建销售机会”“更新联系人”“查询交易列表”等），以缩小工具候选范围；
• known_fields：若已知部分字段名可在此传入，为空字符串表示不预设；
• session.generate_id: true：让 Rube 自动生成新的会话 ID，适用于开启一个新工作流。

该调用返回的内容包括：可用工具 slug（tool slug）列表、每个工具的输入 Schema（input schemas）、推荐执行计划（recommended execution plans）以及已知陷阱（known pitfalls）。这些返回值就是后续执行步骤中填写参数的唯一事实来源。

五、核心工作流三步走

Skill 文档将完整的自动化流程归纳为三个步骤，每一步都对应一个 Rube MCP 工具调用。

Step 1：发现可用工具

RUBE_SEARCH_TOOLS
queries: [{use_case: "your specific Salesmate task"}]
session: {id: "existing_session_id"}

与初次发现不同，这里使用 session.id 复用已有会话，描述换成你的具体 Salesmate 任务，例如“创建新的销售机会并关联联系人”。返回的 slug 与 Schema 将决定下一步如何填参。

Step 2：检查连接

RUBE_MANAGE_CONNECTIONS
toolkits: ["salesmate"]
session_id: "your_session_id"

此调用确认当前会话对应的 Salesmate 连接是否处于 ACTIVE 状态。如果返回非 ACTIVE，需要先走授权流程（见第三节第 3、4 步）再继续执行。

Step 3：执行工具

RUBE_MULTI_EXECUTE_TOOL
tools: [{
  tool_slug: "TOOL_SLUG_FROM_SEARCH",
  arguments: {/* schema-compliant args from search results */}
}]
memory: {}
session_id: "your_session_id"

参数要点：

• tool_slug：取自 Step 1 搜索结果的真实 slug，严禁凭记忆硬编码；
• arguments：必须与搜索结果返回的 Schema 完全一致（字段名与类型严格匹配）；
• memory：必须始终携带，即使为空也要传 {}；
• session_id：沿用当前工作流的会话 ID，保证操作上下文连贯。

RUBE_MULTI_EXECUTE_TOOL 支持在一次调用中批量执行多个工具（tools 为数组），适合编排“查询联系人 → 创建机会 → 添加任务”等多步销售流程。

六、快速参考：五类核心操作

Skill 文档以一张快速参考表概括了全部操作入口，逐项展开如下：

操作类型	调用方式	用途说明
查找工具	RUBE_SEARCH_TOOLS + Salesmate 相关 use_case	发现可用工具 slug、输入 Schema、推荐执行计划与已知陷阱
建立连接	RUBE_MANAGE_CONNECTIONS + toolkit salesmate	建立 / 检查 Salesmate OAuth 连接，未激活时返回授权链接
常规执行	RUBE_MULTI_EXECUTE_TOOL + 搜索发现的工具 slug	单次或批量执行 Salesmate 操作，需携带 memory 与 session_id
批量操作	RUBE_REMOTE_WORKBENCH + run_composio_tool()	面向大批量数据处理（如批量导入、批量更新）的远程工作台执行方式
获取完整 Schema	RUBE_GET_TOOL_SCHEMAS + 带 schemaRef 的工具	当搜索返回的工具带 schemaRef 引用时，用它拉取完整 Schema

实际使用中可以这样取舍：常规交互任务走 RUBE_MULTI_EXECUTE_TOOL；涉及数千条记录的大规模批量任务交给 RUBE_REMOTE_WORKBENCH；而需要精确构造参数时，先通过 RUBE_GET_TOOL_SCHEMAS 获取完整字段定义。

七、已知陷阱与最佳实践

Skill 文档总结了 6 条关键经验，逐条深化如下：

1. 始终先搜索：工具 Schema 会随上游 API 版本更新而变化。切勿硬编码工具 slug 或参数，任何执行前都先调用 RUBE_SEARCH_TOOLS，用返回结果作为参数依据；
2. 检查连接：执行工具前务必通过 RUBE_MANAGE_CONNECTIONS 确认状态为 ACTIVE。Salesmate 的 OAuth 令牌可能过期，未激活时先跟随返回的授权链接重新授权；
3. Schema 合规：参数必须使用搜索结果中的精确字段名与类型。多传、漏传或类型不符都会导致调用失败，这是 Salesmate 这类强类型 API 最常见的报错来源；
4. memory 参数：RUBE_MULTI_EXECUTE_TOOL 的调用中永远携带 memory，哪怕没有需要传递的记忆状态也要写成 {}，缺少该参数可能导致调用不合法；
5. 会话复用：同一工作流内部复用同一个 session_id，保证多步操作的上下文连续；新工作流则新建会话（使用 session.generate_id: true 或新 ID），避免不同业务场景的状态串扰；
6. 分页处理：检查响应中是否带有分页令牌（pagination token），有则继续拉取直到数据取完。忽略分页会导致列表类操作只拿到第一页结果，产生“数据不全”的假成功。

八、配套资源与延伸阅读

在 awesome-claude-skills 仓库中，与本 Skill 相关的资源还包括：

• README.md：其中的 “App Automation via Composio” 章节列出了 78 个 SaaS 应用的自动化 Skill 全貌，并解释了“真实工具 slug 来自 Composio API 动态发现”的设计原则，可帮助你理解整套 Rube MCP Skill 的通用工作方式；
• connect/SKILL.md：面向开发者的替代/补充方案。它介绍通过 COMPOSIO_API_KEY 环境变量与 pip install composio（Python）或 npm install @composio/core（TypeScript）进行 SDK 级集成，并给出使用 Claude Agent SDK 连接 Composio MCP 会话的完整代码示例。若你需要在自有程序中以编程方式编排 Salesmate 自动化，可参考该文档；
• 仓库中同一目录下的其他 CRM 类 Skill（如 Close、HubSpot、Pipedrive、Salesforce、Zoho CRM 等）采用与本文完全一致的三步工作流与工具命名约定，掌握本 Skill 后可以举一反三。

九、小结

通过 composio-skills/salesmate-automation/SKILL.md，Salesmate 的自动化接入被收敛为一条清晰、可复制的路径：接入 Rube MCP（免 Key）→ 建立并激活 Salesmate 连接 → 动态发现工具 Schema → 按三步工作流执行 → 遵循分页与会话纪律。其核心方法论——“永远先搜索、永远校验连接、永远遵守 Schema”——不仅适用于 Salesmate，也是利用 Composio 生态自动化任意 SaaS 应用的通用准则。