Mailsoftly 自动化实战用 Rube MCP 在 Codex 中驱动 Composio Mailsoftly Toolkit【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills本指南基于 awesome-codex-skills 仓库中的 mailsoftly-automation 技能文档系统讲解如何通过 Rube MCPComposio 提供的 MCP 网关在 Codex CLI/API 中自动化 Mailsoftly 邮件营销平台的操作。读完本文你将掌握一套「先搜索工具 → 再检查连接 → 最后执行」的可复现工作流模式以及工具发现、连接管理、批量执行与常见坑位规避的完整实战方案。一、技能概览这个 Skill 解决什么问题mailsoftly-automation是 awesome-codex-skills 仓库composio-skills/目录下的一个 Codex Skill其核心定位是Automate Mailsoftly tasks via Rube MCP (Composio). Always search tools first for current schemas.也就是说它让 Codex Agent 能够真实地操作 Mailsoftly邮件营销与自动化平台——而不是只输出一段你可以这样发邮件的建议文本。技能本身通过 YAML frontmatter 声明元数据Codex 依据description判断何时触发该技能并仅在触发后才加载正文从而保持上下文精简该机制在 README.md 的 What Are Codex Skills? 一节中有说明。技能文件的完整元数据结构如下--- name: mailsoftly-automation description: Automate Mailsoftly tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---其中requires.mcp: [rube]明确声明该技能依赖名为rube的 MCP 服务器这是运行时前置条件缺少它技能将无法工作。仓库中的 composio-skills/composio-automation/SKILL.md 等数百个同类技能遵循完全相同的模板结构——本指南讲解的工作流模式适用于其中任何一个 toolkit如 Gmail、Slack、GitHub 等。二、前置条件Prerequisites在开始任何 Mailsoftly 自动化工作流之前必须满足以下三项前置条件条件说明Rube MCP 已连接确保RUBE_SEARCH_TOOLS工具可用Mailsoftly 连接处于 ACTIVE通过RUBE_MANAGE_CONNECTIONS使用 toolkitmailsoftly建立并激活连接每次先执行工具搜索始终先调用RUBE_SEARCH_TOOLS获取当前工具 schema严禁凭记忆硬编码其中第三条是最关键的原则Composio 的工具 schema 会随上游 API 演化而变动Agent 必须先发现、后执行。三、环境搭建接入 Rube MCPRube MCP 是访问 Composio 各类 toolkit 的统一入口。配置方式极为简单Get Rube MCP: Addhttps://rube.app/mcpas an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.即在 Codex 的 MCP 客户端配置中新增一个 MCP 服务器端点地址为https://rube.app/mcp无需任何 API Key添加端点即可使用。搭建完成后按以下顺序验证与激活连接验证 Rube MCP 可用确认RUBE_SEARCH_TOOLS能够正常响应建立 Mailsoftly 连接调用RUBE_MANAGE_CONNECTIONS传入 toolkitmailsoftly完成授权若连接状态不是ACTIVE按照返回的 auth 链接完成 OAuth 设置确认状态在运行任何工作流之前确认连接状态显示为ACTIVE。从源码结构看该技能依赖的RUBE_MANAGE_CONNECTIONS承担了 OAuth 连接的生命周期管理——连接一旦建立便会持久化后续工作流无需重复授权。四、工具发现永远先搜索Tool Discovery无论任务多么具体执行任何工作流之前都必须先发现可用工具。技能文档给出的标准发现调用如下RUBE_SEARCH_TOOLS queries: [{use_case: Mailsoftly operations, known_fields: }] session: {generate_id: true}该调用的返回值包括可用工具 slugs如发送邮件、管理联系人等操作对应的工具标识输入 schema每个工具参数的字段名、类型、必填项推荐执行计划针对该 use case 的建议调用序列已知坑位该工具集的常见失败模式与规避方式。session: {generate_id: true}表示本次调用会自动生成一个新的会话 ID适合工作流起始阶段而后续步骤应复用该 ID见下文会话管理。五、核心工作流模式三步执行法技能文档定义了一个贯穿始终的三步工作流模式适用于任何 Mailsoftly 任务。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Mailsoftly task}] session: {id: existing_session_id}将use_case替换为你的具体任务描述例如创建邮件活动管理订阅者列表并复用已有会话 ID而不是重新生成。搜索结果中的tool_slug将作为后续执行调用的依据。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [mailsoftly] session_id: your_session_id执行前再次确认mailsoftlytoolkit 的连接为ACTIVE。若为未激活状态跟随返回的授权链接完成设置后再继续。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 的搜索结果不得硬编码arguments必须严格符合搜索结果返回的 schema字段名与类型逐一对应memory参数必须始终携带即使为空也要传{}session_id复用当前工作流的会话 ID。该模式体现了 Rube MCP 设计上的一个重要原则schema 是运行时事实Agent 的职责是先问再干这从根本上避免了因工具参数漂移导致的调用失败。六、会话管理与批量操作会话 ID 的生命周期技能文档明确了两条会话规则工作流内复用同一工作流内的多次调用发现 → 检查 → 执行应复用同一个 session ID保证状态连续性新工作流新建启动一个新的业务工作流时生成新的 session ID如session: {generate_id: true}避免跨任务状态污染。批量操作RUBE_REMOTE_WORKBENCH当需要处理批量任务例如对一批订阅者执行统一操作时可以切换到远程工作台模式RUBE_REMOTE_WORKBENCH在工作台环境中通过run_composio_tool()函数驱动工具执行适合需要循环、条件分支或多步编排的复杂场景。完整 Schema 获取RUBE_GET_TOOL_SCHEMAS当搜索结果中的工具带有schemaRef引用时说明其完整 schema 是延迟加载的此时需要显式调用RUBE_GET_TOOL_SCHEMAS以获取该工具的完整字段定义后再构造arguments。七、已知坑位清单Known Pitfalls技能文档总结了 6 条实战中高频踩坑点务必逐条遵守坑位规避方式跳过工具搜索工具 schema 会变化绝不硬编码 tool slug 或参数必须先调用RUBE_SEARCH_TOOLS连接未激活就执行执行前通过RUBE_MANAGE_CONNECTIONS确认状态为ACTIVESchema 不匹配使用搜索结果中的精确字段名与类型逐字段核对遗漏 memory 参数每次RUBE_MULTI_EXECUTE_TOOL调用都必须携带memory即使为空{}会话管理混乱工作流内复用 session ID新工作流再生成新的分页未处理检查响应中的分页 token持续拉取直至数据完整其中分页问题尤其隐蔽包含大量记录的操作如导出订阅者列表如果忽略响应中的分页 token只会拿到第一页数据导致结果不完整。八、快速参考速查表将整套工作流浓缩为一张速查表便于日常查阅操作方法查找工具RUBE_SEARCH_TOOLS传入 Mailsoftly 相关的 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 为mailsoftly执行工具RUBE_MULTI_EXECUTE_TOOL使用搜索发现的 tool slugs批量操作RUBE_REMOTE_WORKBENCHrun_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS针对带schemaRef的工具九、技能安装与使用方式该技能位于仓库的 composio-skills/mailsoftly-automation/ 目录包含唯一文件 SKILL.md。安装方式参考 README.md 的 Quickstart 与 skill-installer 的说明方式一使用技能安装器推荐git clone https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills.git cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/mailsoftly-automation安装器会将技能放入$CODEX_HOME/skills/mailsoftly-automation默认~/.codex/skills重启 Codex 后生效相关脚本见 skill-installer/scripts/install-skill-from-github.py。方式二手动安装将composio-skills/mailsoftly-automation整个目录复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex 以加载新的元数据在会话中自然描述 Mailsoftly 相关任务Codex 会根据descriptionfrontmatter 自动触发该技能。使用前提技能运行依赖 Rube MCP 服务器requires.mcp: [rube]因此还需按第三节所述完成https://rube.app/mcp的 MCP 端点配置。在 Codex 会话中描述任务如通过 Mailsoftly 发送邮件活动后Codex 将自动触发技能随后按「搜索工具 → 检查连接 → 执行」三步流程完成真实操作。十、总结与最佳实践mailsoftly-automation技能的价值不在于提供某个固定的工具调用序列而在于确立了一套schema 驱动、连接先行、会话收敛的自动化执行纪律以搜索结果为唯一事实来源工具 slug、参数 schema、执行计划全部来自RUBE_SEARCH_TOOLS的运行时返回以连接状态为执行门槛ACTIVE是任何工具调用的前置条件以会话 ID 为状态边界工作流内复用、工作流间新建避免状态泄漏以完整数据为目标始终处理分页 token直到拉取全部数据。这套模式不仅适用于 Mailsoftly在仓库 composio-skills/ 目录下的全部自动化技能如 composio-automation 等中保持一致掌握了它就等于掌握了通过 Rube MCP 驱动任意 Composio toolkit 的通用方法论。本文基于仓库 composio-skills/mailsoftly-automation/SKILL.md 编写由 Composio 提供技术支持。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考