Nango 自动化实战通过 Rube MCP 编排 Composio Nango 工具链awesome-codex-skills 指南【免费下载链接】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本文以 nango-automation 技能文档 为核心系统讲解如何在 awesome-codex-skills 项目中通过 Rube MCP 网关自动化 Nango 的集成与同步操作从零接入https://rube.app/mcp、建立 Nango 连接到使用RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL完成「发现工具 → 校验连接 → 执行调用」的完整工作流并规避 Schema 变更、分页截断等高频踩坑点。读完本文你将掌握一套可直接复制到 Codex 会话中的 Nango 自动化调用范式以及它背后的 Schema 驱动设计原理。一、技能定位Codex Skill 与 Rube MCP 的分工在 awesome-codex-skills 仓库中每个技能都是一个独立目录内含带 YAML frontmatter 的SKILL.md——frontmatter 中的name与description决定 Codex 何时自动触发该技能正文则是触发后的执行指引见 README.md 对 Codex Skills 的定义。nango-automation技能就是这样一个指令包其 frontmatter 定义如下--- name: nango-automation description: Automate Nango tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---三个字段各司其职name技能唯一标识安装后对应$CODEX_HOME/skills/nango-automation目录description触发条件声明——当会话请求涉及 Nango 任务时Codex 依据该描述自动匹配本技能同时它内嵌了本技能最重要的一条纪律「Always search tools first for current schemas」永远先搜索工具以获取最新 Schemarequires.mcp声明本技能依赖名为rube的 MCP 服务器Codex 需要该 MCP 可用才能执行后续工具调用。从仓库目录结构看composio-skills/下存在数百个结构完全一致的技能如 composio-automation、composio-search-automationnango-automation是其中之一它不直接编写 Nango 的 REST 调用而是把「如何通过 Rube MCP 正确调用 Composio 的 Nango 工具包」固化成一套可复用的操作规程。技能本身是「说明书」真正的执行能力来自 Rube MCP 暴露的RUBE_*工具族。二、前置条件在使用本技能前需要确认以下三件事同时满足文档「Prerequisites」节Rube MCP 已连接Codex 客户端环境中存在RUBE_SEARCH_TOOLS工具这是整个自动化链路的入口Nango 连接处于 ACTIVE 状态已通过RUBE_MANAGE_CONNECTIONS并指定 toolkit 为nango建立了有效连接永远先搜索工具在任意工作流执行前调用RUBE_SEARCH_TOOLS获取当前工具 Schema不得直接使用硬编码的工具名或参数。其中第 3 点是本技能的灵魂——Composio 的 Nango 工具包是动态演进的工具 slug 与输入字段会随上游 API 更新而变化只有先做一次「工具发现」才能保证后续调用合法。三、Setup接入 Rube MCP 并建立 Nango 连接文档给出的接入方式极为轻量只需在 MCP 客户端配置中添加https://rube.app/mcp作为 MCP 服务器端点无需任何 API Key添加即用。接入后按以下 4 步完成环境验证与连接建立步骤操作校验标准1确认RUBE_SEARCH_TOOLS可正常响应工具存在且返回结果2调用RUBE_MANAGE_CONNECTIONStoolkit 传nango返回连接详情3若连接状态非 ACTIVE跟随返回的授权链接完成设置完成 OAuth/授权流程4再次确认连接状态为 ACTIVE状态为ACTIVE后方可运行工作流值得强调的是步骤 2 与 3Composio 采用「先建连接、再执行工具」的模型Nango 这类第三方集成服务通常需要用户授权。连接建立过程返回的 auth link 就是授权入口跳过授权直接执行工具会因连接未激活而失败。四、工具发现Tool Discovery一切调用的起点文档明确要求执行任何工作流之前必须先做工具发现。标准调用如下RUBE_SEARCH_TOOLS queries: [{use_case: Nango operations, known_fields: }] session: {generate_id: true}参数说明queries描述你的目标场景。use_case用自然语言描述任务如Nango operationsknown_fields可填入你已知的字段名辅助检索未知时留空字符串session.generate_id置为true时由服务端生成新的会话 ID适合新工作流的第一次调用。该调用的返回内容包括四类关键信息可用工具 slug 列表——后续RUBE_MULTI_EXECUTE_TOOL中tool_slug的合法取值来源输入 Schema——每个工具参数的字段名、类型与必填性是构造arguments的唯一依据推荐执行计划——Rube 基于目标场景给出的工具编排建议已知陷阱known pitfalls——针对该场景的注意事项。这套机制的本质是Schema 驱动的动态工具发现开发者无需记忆 Nango 工具包的全部接口把「当前该用什么工具、参数长什么样」的问题交给 Rube 的检索能力解决。这与文档 frontmatter 中「Always search tools first for current schemas」的纪律互为表里。五、核心工作流模式三步完成 Nango 自动化文档将一次完整的 Nango 自动化任务拆解为三个固定步骤以下逐一给出可直接执行的调用模板。Step 1发现可用工具针对你的具体 Nango 任务做定向检索并复用已有会话 ID 保持上下文连续RUBE_SEARCH_TOOLS queries: [{use_case: your specific Nango task}] session: {id: existing_session_id}use_case应替换为具体任务描述例如同步某 SaaS 的客户数据、触发一次 Nango 同步、管理集成配置等session.id传入工作流已建立的会话 ID使检索与执行处于同一上下文。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [nango] session_id: your_session_id注意此处字段名为toolkits复数数组形式与文档正文中的单数描述不同以工具实际 Schema 为准——这正说明了为何必须先执行 Step 1。返回结果中确认连接状态为 ACTIVE否则回到 Setup 阶段完成授权。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关键参数解读tools工具调用数组支持一次提交多个工具。tool_slug必须来自 Step 1 的搜索结果arguments必须严格符合返回 Schema 中的字段名与类型memory必须显式携带即使无状态也要传空对象{}——该字段承载跨工具调用的上下文传递session_id与本工作流 Step 1/2 使用同一 ID保证状态连续性。三步之间是严格的先后依赖发现确定工具→ 校验确认授权→ 执行按 Schema 调用任何一步跳过都会导致后续调用失败。六、已知陷阱清单Known Pitfalls文档总结了 6 条高频踩坑点逐条展开如下永远先搜索工具 Schema 会变化。不经RUBE_SEARCH_TOOLS就硬编码工具 slug 或参数是最大的失败来源——Nango 工具包演进后旧参数可能失效或变更类型先检查连接执行工具前必须通过RUBE_MANAGE_CONNECTIONS确认连接为 ACTIVE未授权或过期的连接会让工具调用直接报错Schema 严格合规arguments中必须使用搜索结果返回的精确字段名与类型大小写、下划线、数组/对象结构都不能自行发挥Memory 参数必填每次RUBE_MULTI_EXECUTE_TOOL调用都要带memory无状态时传{}。缺失该字段可能导致调用被拒或状态丢失会话复用同一工作流内复用会话 ID保证工具发现、连接检查与执行之间上下文连续新工作流应生成新 ID对应RUBE_SEARCH_TOOLS的session: {generate_id: true}分页处理检查响应中的分页令牌pagination tokens有后续页时持续拉取直到数据取完避免结果被截断。七、快速参考表文档末尾的速查表浓缩了五类核心操作可直接作为会话中的操作指引OperationApproachFind toolsRUBE_SEARCH_TOOLSwith Nango-specific use caseConnectRUBE_MANAGE_CONNECTIONSwith toolkitnangoExecuteRUBE_MULTI_EXECUTE_TOOLwith discovered tool slugsBulk opsRUBE_REMOTE_WORKBENCHwithrun_composio_tool()Full schemaRUBE_GET_TOOL_SCHEMASfor tools withschemaRef补充说明Bulk ops批量操作RUBE_REMOTE_WORKBENCH提供远程工作台能力通过其中的run_composio_tool()函数式地批量执行工具适合需要脚本化循环调用 Nango 工具包的场景Full schema完整 Schema当搜索结果中的工具带有schemaRef引用时使用RUBE_GET_TOOL_SCHEMAS获取其完整 Schema 定义用于构造复杂参数结构。八、在 Codex 中安装并使用本技能该技能位于仓库 composio-skills/nango-automation/目录下仅有核心的 SKILL.md 一个文件。安装方式遵循仓库统一约定见 README.md将composio-skills/nango-automation目录复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex 以加载新的技能元数据在会话中自然描述 Nango 相关任务Codex 会依据 frontmatter 中的description自动触发本技能。如需从仓库直接安装也可使用 skill-installer 提供的安装脚本见 install-skill-from-github.py通过--repo、--path、--name、--ref、--dest、--method等参数指定来源与安装目标脚本默认将技能安装到$CODEX_HOME/skills/skill-name其中CODEX_HOME环境变量优先缺省为~/.codex见 install-skill-from-github.py并校验目标目录包含SKILL.md后才执行安装。使用本技能时会话中应同时满足两个运行条件Rube MCP 已配置requires.mcp声明以及 Nango 连接处于 ACTIVE技能文档「Prerequisites」节。技能本身不包含可执行脚本或参考文档全部逻辑都封装在SKILL.md的操作规程中——这也符合仓库对技能「保持上下文精简」的设计取向。九、原理深读为什么这套模式可以跨技能复用对比仓库中 composio-automation、composio-search-automation、remote-retrieval-automation 等同族技能可以发现它们与nango-automation共享完全相同的骨架——同样的requires: mcp: [rube]、同样的 Setup 四步、同样的RUBE_SEARCH_TOOLS → RUBE_MANAGE_CONNECTIONS → RUBE_MULTI_EXECUTE_TOOL三段式工作流、同样的 6 条陷阱清单与速查表差异仅在use_case与 toolkit 名称。这印证了一个设计结论Composio 通过 Rube MCP 提供的是统一的工具编排协议而非为每个服务定制专用接口。Nango、Composio Search、Remote Retrieval 等成百上千个工具包共享同一套RUBE_*工具族区别只在连接时的toolkits参数与检索时的use_case语义。因此掌握本文的 Nango 调用范式后你可以几乎零成本地将其迁移到该仓库composio-skills/下任意其他服务的自动化场景——这正是该技能体系「以 Schema 驱动、以规程复用」的工程价值所在。十、结语本文完整覆盖了nango-automation技能的全部核心内容从 frontmatter 元数据、前置条件与 Rube MCP 接入到工具发现、三步工作流、六条陷阱与速查表再到仓库层面的安装方式与跨技能复用原理。实践中最需要记住的三条纪律是先RUBE_SEARCH_TOOLS再动手、执行前确认连接 ACTIVE、每次调用携带memory并复用会话 ID。遵循这套范式你可以在 Codex 会话中稳定、安全地驱动 Nango 乃至整个 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），仅供参考
Nango 自动化实战：通过 Rube MCP 编排 Composio Nango 工具链（awesome-codex-skills 指南）
Nango 自动化实战通过 Rube MCP 编排 Composio Nango 工具链awesome-codex-skills 指南【免费下载链接】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本文以 nango-automation 技能文档 为核心系统讲解如何在 awesome-codex-skills 项目中通过 Rube MCP 网关自动化 Nango 的集成与同步操作从零接入https://rube.app/mcp、建立 Nango 连接到使用RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL完成「发现工具 → 校验连接 → 执行调用」的完整工作流并规避 Schema 变更、分页截断等高频踩坑点。读完本文你将掌握一套可直接复制到 Codex 会话中的 Nango 自动化调用范式以及它背后的 Schema 驱动设计原理。一、技能定位Codex Skill 与 Rube MCP 的分工在 awesome-codex-skills 仓库中每个技能都是一个独立目录内含带 YAML frontmatter 的SKILL.md——frontmatter 中的name与description决定 Codex 何时自动触发该技能正文则是触发后的执行指引见 README.md 对 Codex Skills 的定义。nango-automation技能就是这样一个指令包其 frontmatter 定义如下--- name: nango-automation description: Automate Nango tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---三个字段各司其职name技能唯一标识安装后对应$CODEX_HOME/skills/nango-automation目录description触发条件声明——当会话请求涉及 Nango 任务时Codex 依据该描述自动匹配本技能同时它内嵌了本技能最重要的一条纪律「Always search tools first for current schemas」永远先搜索工具以获取最新 Schemarequires.mcp声明本技能依赖名为rube的 MCP 服务器Codex 需要该 MCP 可用才能执行后续工具调用。从仓库目录结构看composio-skills/下存在数百个结构完全一致的技能如 composio-automation、composio-search-automationnango-automation是其中之一它不直接编写 Nango 的 REST 调用而是把「如何通过 Rube MCP 正确调用 Composio 的 Nango 工具包」固化成一套可复用的操作规程。技能本身是「说明书」真正的执行能力来自 Rube MCP 暴露的RUBE_*工具族。二、前置条件在使用本技能前需要确认以下三件事同时满足文档「Prerequisites」节Rube MCP 已连接Codex 客户端环境中存在RUBE_SEARCH_TOOLS工具这是整个自动化链路的入口Nango 连接处于 ACTIVE 状态已通过RUBE_MANAGE_CONNECTIONS并指定 toolkit 为nango建立了有效连接永远先搜索工具在任意工作流执行前调用RUBE_SEARCH_TOOLS获取当前工具 Schema不得直接使用硬编码的工具名或参数。其中第 3 点是本技能的灵魂——Composio 的 Nango 工具包是动态演进的工具 slug 与输入字段会随上游 API 更新而变化只有先做一次「工具发现」才能保证后续调用合法。三、Setup接入 Rube MCP 并建立 Nango 连接文档给出的接入方式极为轻量只需在 MCP 客户端配置中添加https://rube.app/mcp作为 MCP 服务器端点无需任何 API Key添加即用。接入后按以下 4 步完成环境验证与连接建立步骤操作校验标准1确认RUBE_SEARCH_TOOLS可正常响应工具存在且返回结果2调用RUBE_MANAGE_CONNECTIONStoolkit 传nango返回连接详情3若连接状态非 ACTIVE跟随返回的授权链接完成设置完成 OAuth/授权流程4再次确认连接状态为 ACTIVE状态为ACTIVE后方可运行工作流值得强调的是步骤 2 与 3Composio 采用「先建连接、再执行工具」的模型Nango 这类第三方集成服务通常需要用户授权。连接建立过程返回的 auth link 就是授权入口跳过授权直接执行工具会因连接未激活而失败。四、工具发现Tool Discovery一切调用的起点文档明确要求执行任何工作流之前必须先做工具发现。标准调用如下RUBE_SEARCH_TOOLS queries: [{use_case: Nango operations, known_fields: }] session: {generate_id: true}参数说明queries描述你的目标场景。use_case用自然语言描述任务如Nango operationsknown_fields可填入你已知的字段名辅助检索未知时留空字符串session.generate_id置为true时由服务端生成新的会话 ID适合新工作流的第一次调用。该调用的返回内容包括四类关键信息可用工具 slug 列表——后续RUBE_MULTI_EXECUTE_TOOL中tool_slug的合法取值来源输入 Schema——每个工具参数的字段名、类型与必填性是构造arguments的唯一依据推荐执行计划——Rube 基于目标场景给出的工具编排建议已知陷阱known pitfalls——针对该场景的注意事项。这套机制的本质是Schema 驱动的动态工具发现开发者无需记忆 Nango 工具包的全部接口把「当前该用什么工具、参数长什么样」的问题交给 Rube 的检索能力解决。这与文档 frontmatter 中「Always search tools first for current schemas」的纪律互为表里。五、核心工作流模式三步完成 Nango 自动化文档将一次完整的 Nango 自动化任务拆解为三个固定步骤以下逐一给出可直接执行的调用模板。Step 1发现可用工具针对你的具体 Nango 任务做定向检索并复用已有会话 ID 保持上下文连续RUBE_SEARCH_TOOLS queries: [{use_case: your specific Nango task}] session: {id: existing_session_id}use_case应替换为具体任务描述例如同步某 SaaS 的客户数据、触发一次 Nango 同步、管理集成配置等session.id传入工作流已建立的会话 ID使检索与执行处于同一上下文。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [nango] session_id: your_session_id注意此处字段名为toolkits复数数组形式与文档正文中的单数描述不同以工具实际 Schema 为准——这正说明了为何必须先执行 Step 1。返回结果中确认连接状态为 ACTIVE否则回到 Setup 阶段完成授权。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关键参数解读tools工具调用数组支持一次提交多个工具。tool_slug必须来自 Step 1 的搜索结果arguments必须严格符合返回 Schema 中的字段名与类型memory必须显式携带即使无状态也要传空对象{}——该字段承载跨工具调用的上下文传递session_id与本工作流 Step 1/2 使用同一 ID保证状态连续性。三步之间是严格的先后依赖发现确定工具→ 校验确认授权→ 执行按 Schema 调用任何一步跳过都会导致后续调用失败。六、已知陷阱清单Known Pitfalls文档总结了 6 条高频踩坑点逐条展开如下永远先搜索工具 Schema 会变化。不经RUBE_SEARCH_TOOLS就硬编码工具 slug 或参数是最大的失败来源——Nango 工具包演进后旧参数可能失效或变更类型先检查连接执行工具前必须通过RUBE_MANAGE_CONNECTIONS确认连接为 ACTIVE未授权或过期的连接会让工具调用直接报错Schema 严格合规arguments中必须使用搜索结果返回的精确字段名与类型大小写、下划线、数组/对象结构都不能自行发挥Memory 参数必填每次RUBE_MULTI_EXECUTE_TOOL调用都要带memory无状态时传{}。缺失该字段可能导致调用被拒或状态丢失会话复用同一工作流内复用会话 ID保证工具发现、连接检查与执行之间上下文连续新工作流应生成新 ID对应RUBE_SEARCH_TOOLS的session: {generate_id: true}分页处理检查响应中的分页令牌pagination tokens有后续页时持续拉取直到数据取完避免结果被截断。七、快速参考表文档末尾的速查表浓缩了五类核心操作可直接作为会话中的操作指引OperationApproachFind toolsRUBE_SEARCH_TOOLSwith Nango-specific use caseConnectRUBE_MANAGE_CONNECTIONSwith toolkitnangoExecuteRUBE_MULTI_EXECUTE_TOOLwith discovered tool slugsBulk opsRUBE_REMOTE_WORKBENCHwithrun_composio_tool()Full schemaRUBE_GET_TOOL_SCHEMASfor tools withschemaRef补充说明Bulk ops批量操作RUBE_REMOTE_WORKBENCH提供远程工作台能力通过其中的run_composio_tool()函数式地批量执行工具适合需要脚本化循环调用 Nango 工具包的场景Full schema完整 Schema当搜索结果中的工具带有schemaRef引用时使用RUBE_GET_TOOL_SCHEMAS获取其完整 Schema 定义用于构造复杂参数结构。八、在 Codex 中安装并使用本技能该技能位于仓库 composio-skills/nango-automation/目录下仅有核心的 SKILL.md 一个文件。安装方式遵循仓库统一约定见 README.md将composio-skills/nango-automation目录复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex 以加载新的技能元数据在会话中自然描述 Nango 相关任务Codex 会依据 frontmatter 中的description自动触发本技能。如需从仓库直接安装也可使用 skill-installer 提供的安装脚本见 install-skill-from-github.py通过--repo、--path、--name、--ref、--dest、--method等参数指定来源与安装目标脚本默认将技能安装到$CODEX_HOME/skills/skill-name其中CODEX_HOME环境变量优先缺省为~/.codex见 install-skill-from-github.py并校验目标目录包含SKILL.md后才执行安装。使用本技能时会话中应同时满足两个运行条件Rube MCP 已配置requires.mcp声明以及 Nango 连接处于 ACTIVE技能文档「Prerequisites」节。技能本身不包含可执行脚本或参考文档全部逻辑都封装在SKILL.md的操作规程中——这也符合仓库对技能「保持上下文精简」的设计取向。九、原理深读为什么这套模式可以跨技能复用对比仓库中 composio-automation、composio-search-automation、remote-retrieval-automation 等同族技能可以发现它们与nango-automation共享完全相同的骨架——同样的requires: mcp: [rube]、同样的 Setup 四步、同样的RUBE_SEARCH_TOOLS → RUBE_MANAGE_CONNECTIONS → RUBE_MULTI_EXECUTE_TOOL三段式工作流、同样的 6 条陷阱清单与速查表差异仅在use_case与 toolkit 名称。这印证了一个设计结论Composio 通过 Rube MCP 提供的是统一的工具编排协议而非为每个服务定制专用接口。Nango、Composio Search、Remote Retrieval 等成百上千个工具包共享同一套RUBE_*工具族区别只在连接时的toolkits参数与检索时的use_case语义。因此掌握本文的 Nango 调用范式后你可以几乎零成本地将其迁移到该仓库composio-skills/下任意其他服务的自动化场景——这正是该技能体系「以 Schema 驱动、以规程复用」的工程价值所在。十、结语本文完整覆盖了nango-automation技能的全部核心内容从 frontmatter 元数据、前置条件与 Rube MCP 接入到工具发现、三步工作流、六条陷阱与速查表再到仓库层面的安装方式与跨技能复用原理。实践中最需要记住的三条纪律是先RUBE_SEARCH_TOOLS再动手、执行前确认连接 ACTIVE、每次调用携带memory并复用会话 ID。遵循这套范式你可以在 Codex 会话中稳定、安全地驱动 Nango 乃至整个 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），仅供参考
