Rube MCP を介した Heyreach 自動化
Composio の Heyreach ツールキットを Rube MCP 経由で操作し、Heyreach の処理を自動化します。
ツールキットドキュメント: composio.dev/toolkits/heyreach
前提条件
- Rube MCP が接続されていること(
RUBE_SEARCH_TOOLSが利用可能) - ツールキット
heyreachを指定したRUBE_MANAGE_CONNECTIONSによるアクティブな Heyreach 接続 - 常に最初に
RUBE_SEARCH_TOOLSを呼び出し、最新のツールスキーマを取得すること
セットアップ
Rube MCP を入手: クライアント設定に MCP サーバーとして https://rube.app/mcp を追加します。API キーは不要です。エンドポイントを追加するだけで動作します。
RUBE_SEARCH_TOOLSが応答することを確認し、Rube MCP が利用可能であることを確認- ツールキット
heyreachを指定してRUBE_MANAGE_CONNECTIONSを呼び出す - 接続が ACTIVE でない場合は、返された認証リンクに従ってセットアップを完了
- ワークフローを実行する前に、接続ステータスが 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 ステータスになっていることを確認してください。 - スキーマに従う: 検索結果から返された正確なフィールド名と型を使用してください。
- メモリパラメータ:
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