pdf-co-automation

PDF co Automation - Rube MCP 集成指南

技能概述

通过 Rube MCP 自动化执行 PDF.co 任务，支持工具动态发现和模式验证，无需管理 API 密钥即可集成完整的 PDF 处理工作流。

适用场景

PDF 批量处理需求：需要对多个 PDF 文件执行转换、合并、分割等批量操作时，通过 Rube MCP 的多工具执行能力一次性完成任务。

动态工具集成：当 PDF.co 工具模式频繁变化时，使用自动工具发现机制确保工作流始终使用最新的工具定义，避免硬编码导致的失效问题。

简化认证管理：不想在本地存储 API 密钥或管理复杂的认证流程，通过 Rube MCP 的连接管理功能集中处理 PDF.co 的授权状态。

核心功能

自动工具发现：通过 RUBE_SEARCH_TOOLS 动态获取可用的 PDF.co 工具列表、输入模式、推荐执行计划和已知陷阱，确保工作流与最新工具定义保持同步。

连接状态管理：使用 RUBE_MANAGE_CONNECTIONS 实时检查 PDF.co 工具包的连接状态，在执行任何工作流前验证连接是否激活，避免执行失败。

多工具执行：通过 RUBE_MULTI_EXECUTE_TOOL 在单次调用中执行多个 PDF.co 操作，支持批量处理、会话复用和内存传递，提升复杂工作流的执行效率。

常见问题

如何通过 Rube MCP 连接 PDF.co？

将 https://rube.app/mcp 添加为 MCP 服务器后，首先调用 RUBE_SEARCH_TOOLS 验证连接可用性，然后使用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit 为 pdf_co。如果连接状态不是 ACTIVE，按照返回的授权链接完成设置，确认状态变为 ACTIVE 后即可开始执行工作流。

为什么要先搜索工具再执行？

PDF.co 的工具模式会定期更新，直接硬编码工具定义会导致工作流失效。通过 RUBE_SEARCH_TOOLS 获取最新的工具模式和推荐执行计划，可以确保工作流始终使用正确的字段名称和类型，同时还能获得官方推荐的执行流程和常见陷阱提醒。

工具执行失败如何排查？

首先确认 RUBE_MANAGE_CONNECTIONS 返回的连接状态为 ACTIVE，然后检查 RUBE_SEARCH_TOOLS 返回的输入模式是否与实际使用的参数完全匹配（字段名和类型必须一致）。如果多工具执行失败，确保在 RUBE_MULTI_EXECUTE_TOOL 中包含了 memory 参数（即使为空 {}），并验证会话 ID 是否在整个工作流中保持一致。