maintainx-automation

Maintainx Automation — 通过 Rube MCP 实现 Maintainx 工作流自动化

技能概述

Maintainx Automation 是一个通过 Composio 的 Rube MCP 实现 Maintainx 任务自动化的 Claude 技能，支持工具发现、连接管理和批量操作，无需配置 API 密钥即可快速集成。

适用场景

1. 需要 Maintainx 任务自动化的开发与运维场景

当您需要定期创建、更新或管理 Maintainx 中的工作订单、检查清单或资产时，此技能可以通过 RUBE_MULTI_EXECUTE_TOOL 自动执行这些重复性操作，减少手动介入。

2. 批量处理维护记录和报告生成

对于需要一次性处理大量 Maintainx 数据的场景，如批量导出工单、生成维护报告或同步资产状态，可使用 RUBE_REMOTE_WORKBENCH 的 run_composio_tool() 方法进行高效批量操作。

3. 与 Claude 对话流程深度集成的自动化工作流

在 Claude 对话中需要实时调用 Maintainx 能力时，通过 RUBE_SEARCH_TOOLS 动态发现可用工具、RUBE_MANAGE_CONNECTIONS 管理连接状态，实现对话式的维护任务编排与执行。

核心功能

1. 动态工具发现与 Schema 获取

通过 RUBE_SEARCH_TOOLS 实时查询 Maintainx 工具包的可用工具、输入参数和执行计划，避免硬编码过时的工具 slug 或参数。对于需要完整 schema 的工具，可使用 RUBE_GET_TOOL_SCHEMAS 获取详细字段定义。

2. 连接状态管理与无密钥集成

使用 RUBE_MANAGE_CONNECTIONS 检查 Maintainx 连接状态，确保在执行工具前连接为 ACTIVE。添加 Rube MCP 服务器（https://rube.app/mcp）后无需 API 密钥，简化配置流程。

3. 灵活的工具执行与会话复用

通过 RUBE_MULTI_EXECUTE_TOOL 执行一个或多个 Maintainx 工具，支持在同一会话中复用 session_id 以保持上下文，并为新工作流生成新会话。返回结果中包含分页信息时可持续获取完整数据。

常见问题

Maintainx Automation 技能需要 API 密钥吗？

不需要。只需在客户端配置中添加 Rube MCP 服务器地址 https://rube.app/mcp 即可使用，无需配置任何 API 密钥。首次连接时按返回的授权链接完成 Maintainx 账号绑定即可。

为什么必须先调用 RUBE_SEARCH_TOOLS？

Composio 工具包的工具 schema 会动态更新，直接硬编码工具 slug 或参数可能导致调用失败。RUBE_SEARCH_TOOLS 返回当前可用的工具列表、正确的参数字段和已知问题，确保您的调用与最新 schema 兼容。

Maintainx 连接状态不是 ACTIVE 怎么办？

调用 RUBE_MANAGE_CONNECTIONS 检查连接状态。如果状态不是 ACTIVE，按返回的授权链接完成 Maintainx 账号授权。授权完成后，再次调用该工具确认状态变为 ACTIVE，再执行后续工作流。