contentful-graphql-automation

Contentful Graphql 自动化技能

技能概述

通过 Rube MCP（Composio）自动执行 Contentful GraphQL 操作，无需 API 密钥即可实现工具发现、连接管理和多工具协同工作流。

适用场景

内容工作流自动化

需要定期批量创建、更新或发布 Contentful 内容的场景，如内容迁移、批量元数据更新、定时发布流程等。通过 RUBE_MULTI_EXECUTE_TOOL 可在一次会话中串联多个操作，显著提升效率。

AI 技能集成

为 Claude 技能或 AI 代理添加 Contentful 数据操作能力时，使用该技能可快速完成工具发现和调用封装，避免直接处理 GraphQL 查询语法和认证逻辑。

动态 Schema 环境

当 Contentful 环境的模型结构频繁变化时，该技能强制要求的工具发现流程确保每次执行前获取最新架构，避免硬编码导致的调用失败。

核心功能

动态工具发现

通过 RUBE_SEARCH_TOOLS 实时获取当前可用的 Contentful 工具列表、输入架构和推荐执行计划。该功能解决了工具架构变化导致硬编码调用失效的问题，返回结果包含工具 slug、参数 schema 和已知陷阱。

连接状态管理

使用 RUBE_MANAGE_CONNECTIONS 验证和管理 Contentful Graphql 连接状态。支持检查连接是否激活、获取认证链接、确认连接可用性，确保工具执行前准备工作完成。

多工具协同执行

RUBE_MULTI_EXECUTE_TOOL 支持在单个会话中执行多个工具，自动处理会话 ID 复用和 memory 参数传递。配合 RUBE_REMOTE_WORKBENCH 可实现更复杂的批量操作和自定义工作流。

常见问题

Rube MCP 需要配置 API 密钥吗？

不需要。只需在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器端点即可使用。连接 Contentful Graphql 时，通过 RUBE_MANAGE_CONNECTIONS 返回的认证链接完成授权，无需手动管理 API 密钥。

为什么每次执行前都要调用 RUBE_SEARCH_TOOLS？

Composio 的工具架构会随 Contentful 平台更新而变化。硬编码工具 slug 和参数容易导致调用失败。强制搜索工具确保每次执行都使用最新的架构定义，这是该技能的核心设计原则。

会话 ID 可以重复使用吗？

在同一工作流内应复用会话 ID 以保持上下文连续性。但启动新的独立工作流时应生成新会话 ID。RUBE_SEARCH_TOOLS 的 session.generate_id: true 可创建新会话，后续步骤使用返回的 session.id 即可。