Shipengine 自動化 (Rube MCP 経由)
Composio の Shipengine ツールキットを Rube MCP 経由で操作し、Shipengine の業務を自動化します。
ツールキットドキュメント: composio.dev/toolkits/shipengine
前提条件
- Rube MCP が接続されていること（
RUBE_SEARCH_TOOLSが利用可能） RUBE_MANAGE_CONNECTIONSによる Shipengine コネクションがアクティブであること（ツールキット:shipengine）- 必ず最初に
RUBE_SEARCH_TOOLSを呼び出して最新のツールスキーマを取得すること
セットアップ
Rube MCP を入手: クライアント設定に https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要で、エンドポイントを追加するだけで使用できます。
- Rube MCP が利用可能かどうか、
RUBE_SEARCH_TOOLSが応答することを確認します。 RUBE_MANAGE_CONNECTIONSをツールキットshipengineで呼び出します。- コネクションが ACTIVE でない場合は、返された認証リンクに従ってセットアップを完了します。
- ワークフローを実行する前に、コネクションステータスが ACTIVE であることを確認します。
ツールの発見
ワークフローを実行する前に、必ず利用可能なツールを発見します。
RUBE_SEARCH_TOOLS
queries: [{use_case: "Shipengine 操作", known_fields: ""}]
session: {generate_id: true}
これにより、利用可能なツールスラッグ、入力スキーマ、推奨実行計画、既知の問題点が返されます。
コアワークフローパターン
ステップ 1: 利用可能なツールを発見
RUBE_SEARCH_TOOLS
queries: [{use_case: "実行したい特定の Shipengine タスク"}]
session: {id: "existing_session_id"}
ステップ 2: コネクションの確認
RUBE_MANAGE_CONNECTIONS
toolkits: ["shipengine"]
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 を生成します。
- ページネーション: 応答内のページネーショントークンを確認し、すべてのデータが取得されるまでフェッチを続けてください。
クイックリファレンス
| 操作 | 方法 |
|---|---|
| ツールの検索 | Shipengine 固有のユースケースで RUBE_SEARCH_TOOLS |
| 接続 | ツールキット shipengine で RUBE_MANAGE_CONNECTIONS |
| 実行 | 発見されたツールスラッグで RUBE_MULTI_EXECUTE_TOOL |
| 一括操作 | run_composio_tool() を使用した RUBE_REMOTE_WORKBENCH |
| 完全スキーマ | schemaRef を持つツールで RUBE_GET_TOOL_SCHEMAS |
Powered by Composio