MCP 経由で使う Transloadit
Model Context Protocol サーバーを提供しています。エージェントは動画のエンコード、画像のリサイズ、ドキュメントの変換を実行し、その結果を読み取れます。API と同じ基盤で動作し、パイプラインはエージェント自身が組み立てます。

エージェントでできること
ツールの役割は 4 つに分かれます。MCP Server ドキュメントに、すべてのツールとそれぞれに必要な権限を記載しています。
- 利用できる機能の把握。
transloadit_list_robotsは各 Robot の概要を含むカタログを返し、transloadit_get_robot_helpは指定した Robot のパラメーターを返します。ドキュメントを学習していないエージェントでも、サービスを正しく使えます。 - 費用が発生する前の検証。
transloadit_lint_assembly_instructionsは Assembly を作成せずに Assembly Instructions を検証し、問題を文章ではなく構造化データとして返します。 - 処理の実行。
transloadit_create_assemblyは Assembly を作成または再開します。指示すれば、ファイルのアップロードと結果の待機も行います。 - 完了までの追跡。
transloadit_get_assembly_statusとtransloadit_wait_for_assemblyは実行中の Assembly を追跡し、transloadit_list_templatesは既存の Template を再利用します。
費用をかける前の機能探索
機能探索と lint による検証では、Assembly は作成されません。エージェントはすべての Robot を一覧表示し、使いたい Robot のパラメーターを読み取り、何も実行しないうちに設定案を検証できます。誤りのある Step の lint を依頼すると、その誤りが返されます。
{
"severity": "error",
"path": "instructions",
"message": "Path `steps.resized` has unrecognized keys: `widht`"
}
ホスト型エンドポイントでは、機能探索や lint を含め、どのツールを実行するにも事前のサインインが必要です。アカウントなしでこれらを使うには、サーバーをセルフホストしてください。Template の一覧表示と Assembly の作成には、セルフホストのサーバーでも常に認証情報が必要です。
Assembly の作成によって、課金対象の処理が始まる場合があります。transloadit_create_assembly には破壊的操作のフラグが付いていますが、呼び出しごとに確認を求められるかどうかはクライアントによって異なります。その確認には頼らず、接続する前にエージェントの権限と再試行ポリシーを設定してください。
エージェントに API キーを渡すより優れている理由
REST API を使うエージェントは、あらかじめその構造を知っている必要があります。パラメーター名を推測してリクエストを送り、処理が失敗して初めて間違いに気づくと、少なくとも通信の往復が無駄になり、場合によってはエンコード料金まで発生します。
Assembly Instructions は宣言的な JSON で、エージェントが得意とする形式です。機能探索とリンターを組み合わせることで、実行前に検証まで完結できます。利用できる機能を問い合わせ、Step を記述し、検証を受けてから初めて Assembly を作成します。処理自体は当社のインフラストラクチャ上で行われるため、FFmpeg のインストールは不要で、ローカルディスクが埋まることもありません。
接続方法
エージェントクライアントには、ホスト型エンドポイントの追加をお勧めします。
https://api2.transloadit.com/mcp
続いてブラウザーでアクセスを承認し、エージェントに使用を許可する Workspace を選びます。インストールもキーのコピーも不要です。
機能を検出するクライアントは、/.well-known/mcp/server-card.jsonにある機械可読のカードを読み取れます。カードにはツールとその入力スキーマが記載されています。
ブラウザーで承認できる人がいない CI などのクライアントや、サーバーをセルフホストする場合は、接続方法の選択をご覧ください。MCP Server ドキュメントには、クライアントごとの設定も記載しています。
対応範囲と制約
- Transloadit の処理を連携させるものであり、API と Robot が対応していないことは実行できません。
- エンコードには通常どおり料金がかかります。エージェントの再試行回数と同時実行数を制限し、必要な Workspace だけを接続してください。エージェント用に作成する Auth Key の権限範囲は最小限に絞り、Workspace の使用量を監視してください。認証もクライアントの確認プロンプトも、支出の上限にはなりません。
- ツールは Assembly、Robot、Template を扱い、接続先の Workspace を識別できます。アカウント管理、請求、認証情報は、意図的に対象外としています。
- 自分でパイプラインを設計する場合に、Robot ドキュメントを読む代わりになるものではありません。エージェントが設計する場合に使うものです。
無料の Workspace を作成してエージェントを接続するか、まずは MCP Server ドキュメントをご覧ください。