Transloadit MCP Server:エージェント向けアップロードと処理
エージェントはすでにテキストの処理を得意としています。しかし、ファイルのパイプラインとなると、うまくいかないことが多くなります。実際に求められているのは、もっとシンプルなことです。「この動画を HLS に変換して」「Web 用の画像バリエーションを作って」「この PDF に OCR をかけて構造化テキストを返して」「サムネイルを生成して」「すべて S3 にエクスポートして」といった依頼です。
これらはすべて、Transloadit がすでに得意とする処理です。MCP サーバーを使えば、そのツール群をエージェントに渡し、自然言語から実際のメディアワークフローを実行できます。
本日、Transloadit MCP Server をリリースします。この MCP 連携により、エージェントはファイルのアップロード、Assembly の作成、Template の検索、Transloadit からの結果取得を行えます。

Claude Code、Gemini CLI、OpenAI Codex、Cursor でエージェントのワークフローを構築する場合、Transloadit MCP Server は、モデルに小規模で予測しやすいツールインターフェースを提供します。実際には、存在しないエンドポイントの生成が減り、プロンプトが短くなり、ワークフローが最初から最後まで実際に動作するようになります。
Transloadit MCP Server でできること
- ローカルファイルのアップロードと、tus による大容量アップロードの再開
- 完全な処理設定を指定した Assembly の作成と結果の追跡
- 組み込みのものを含む Template の一覧表示と使用
- Assembly の実行前に行う Assembly Instructions の検証と lint
MCP とスキル/CLI の比較
MCP は実行環境に組み込む用途に最適です。長時間稼働する、または自律的に動作するエージェントのパイプラインで、Transloadit による処理(アップロード、Assembly、ポーリング、結果取得)を繰り返し実行する場合に適しています。
スキル/CLI は、人が指示する単発の作業に最適です。連携の設定、Template の生成、コードのひな形作成、リポジトリやツールへの完全なアクセス権を使ったローカルでの単発処理などに適しています。
ただし、これは目安であり、厳密なルールではありません。OpenClaw など、スキルと非常に相性のよいシステムもあります。また、MCP も人が介在する対話型フローで有効です。適切な選択は環境や好みによって異なります。今後も両方をサポートしていきます。
クイックスタート(エージェント)
ローカル(セルフホスト)で利用する場合は、エージェントクライアントに MCP サーバーを追加します。クライアントが npx -y @transloadit/mcp-server stdio を介してサーバーを自動起動します。アカウントにアクセスするツールを使うには、サーバーの環境で
TRANSLOADIT_KEY に Transloadit Auth Key を、TRANSLOADIT_SECRET に Auth Secret を設定してください。Robot ドキュメント用ツールは、これらの認証情報なしで動作します。
Claude、Codex、Gemini、Cursor の設定手順は、MCP Server の README を参照してください。
ホスト型 MCP エンドポイント(https://api2.transloadit.com/mcp)に接続するには、Transloadit を ChatGPT、Claude、Codex に接続する に従って、クライアントの設定とブラウザーでのサインインを行ってください。
ヘッドレスでホスト型サービスにアクセスするには、Transloadit Auth Key と Auth Secret を使い、npx -y @transloadit/node auth token --aud mcp で Bearer トークンを生成してから、Authorization: Bearer <token> ヘッダーで送信します。レスポンスの expires_in の値は、トークンの有効期間を秒単位で示します。
ローカルとホスト型の比較
- ローカル(セルフホスト)MCP は、ローカルファイルのパスを扱います。
- ホスト型 MCP は、公開 URL、ChatGPT の添付ファイル、またはアップロードスロットを使ったサンドボックスからのアップロードを受け付けます。このスロットは、tus 経由でアップロードするための実行可能な
curlコマンドを返します。Transloadit にファイルを送る方法 を参照してください。
今後の予定
Transloadit Agent Skills もリリースしました。これは、再現性のあるメディアワークフローをエージェントに教える、バージョン管理された手順集です。MCP はエージェントにツールを提供し、スキルはそのツールをうまく使う方法を教えます。両者は互いを補完します。
次に取り組むのは、アップロード、lint、Template 検索の改善です。また、実際に構築されるものに応じて、MCP のツールインターフェースを拡充していきます。エージェントのフローを構築していて、公開してほしい機能や改善の要望があれば、ぜひお知らせください。
