ComposioHQ/heyreach-automation

Rube MCP による Heyreach 自動化

Composio の Heyreach ツールキットを Rube MCP 経由で利用して、Heyreach の操作を自動化します。

ツールキットドキュメント: composio.dev/toolkits/heyreach

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が利用可能であること）
• ツールキット heyreach を使用したアクティブな Heyreach 接続が RUBE_MANAGE_CONNECTIONS 経由で確立されていること
• 最新のツールスキーマを取得するため、常に最初に RUBE_SEARCH_TOOLS を呼び出すこと

セットアップ

Rube MCP の取得: クライアント設定に MCP サーバとして https://rube.app/mcp を追加します。API キーは不要で、エンドポイントを追加するだけで機能します。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確認します
2. ツールキット heyreach を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従ってセットアップを完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

ツールの検出

ワークフローを実行する前に、必ず利用可能なツールを検出してください：

RUBE_SEARCH_TOOLS
queries: [{use_case: "Heyreach operations", known_fields: ""}]
session: {generate_id: true}

これにより、利用可能なツールスラッグ、入力スキーマ、推奨実行計画、既知の落とし穴が返されます。

コアワークフローパターン

ステップ 1: 利用可能なツールを検出

RUBE_SEARCH_TOOLS
queries: [{use_case: "your specific Heyreach task"}]
session: {id: "existing_session_id"}

ステップ 2: 接続を確認

RUBE_MANAGE_CONNECTIONS
toolkits: ["heyreach"]
session_id: "your_session_id"

ステップ 3: ツールを実行

RUBE_MULTI_EXECUTE_TOOL
tools: [{
  tool_slug: "TOOL_SLUG_FROM_SEARCH",
  arguments: {/* 検索結果からのスキーマ準拠の引数 */}
}]
memory: {}
session_id: "your_session_id"

既知の落とし穴

• 必ず最初に検索: ツールスキーマは変更されます。RUBE_SEARCH_TOOLS を呼び出さずにツールスラッグや引数をハードコードしないでください
• 接続を確認: ツールを実行する前に RUBE_MANAGE_CONNECTIONS で ACTIVE ステータスを確認してください
• スキーマ準拠: 検索結果のフィールド名とタイプを正確に使用してください
• memory パラメータ: RUBE_MULTI_EXECUTE_TOOL の呼び出しには、空（{}）であっても必ず memory を含めてください
• セッションの再利用: ワークフロー内ではセッション ID を再利用してください。新しいワークフローでは新しい ID を生成してください
• ページネーション: レスポンスにページネーショントークンがある場合は、それを使用してすべてのデータを取得し終えるまで継続的に取得してください

クイックリファレンス

操作	方法
ツールの検索	Heyreach 固有のユースケースで RUBE_SEARCH_TOOLS
接続	ツールキット heyreach で RUBE_MANAGE_CONNECTIONS
実行	検出されたツールスラッグで RUBE_MULTI_EXECUTE_TOOL
一括操作	run_composio_tool() を使用した RUBE_REMOTE_WORKBENCH
全スキーマ	schemaRef を持つツールに対して RUBE_GET_TOOL_SCHEMAS

---

Powered by Composio