Mux MCP Server (Official)

Mux MCP Server (Official) とは？

Mux MCP サーバーは、AI ツールを Mux Video と Data プラットフォームに接続するための Mux 公式の手段です。エージェントが自然言語のプロンプトで動画のアップロード、ライブ配信の管理、視聴データの分析を行えるようにします。

Mux は 2 つの方法で提供しています。OAuth ログインに対応した https://mcp.mux.com のホスト型リモートサーバーと、アクセストークンでローカル実行する npm パッケージ @mux/mcp です。パッケージは Apache-2.0 のオープンソースで、muxinc/mux-ts リポジトリ（packages/mcp-server）にあります。エンドポイントごとにツールを用意するのではなく、2 つのツールだけを持つ「Code Mode」設計を採用しています。

Mux MCP Server (Official) の使い方

Mux アカウントが必要です。サーバーにできることは、承認した Mux の環境とアクセストークンによって制限されます。

ホスト型サーバー（推奨）

URL に https://mcp.mux.com を指定して MCP サーバー（Claude や ChatGPT では「connector」）を追加します。OAuth に対応したクライアントでは dashboard.mux.com へのログインと環境の選択を求められ、トークンをコピーする必要はありません。たとえば Claude Code では：

claude mcp add --transport http mux https://mcp.mux.com

クライアントが OAuth に対応していない場合は、Mux Dashboard の Settings → Access Tokens でアクセストークンを作成し、Basic 認証情報（TOKEN_ID:TOKEN_SECRET を base64 エンコードしたもの）として送ります：

{
  "mcpServers": {
    "mux": {
      "url": "https://mcp.mux.com",
      "headers": {
        "Authorization": "Basic <base64 of TOKEN_ID:TOKEN_SECRET>"
      }
    }
  }
}

リモート MCP に対応していないクライアントでは、以下のローカルインストールか mcp-remote を使えます。

ローカルインストール

前提条件：Node.js、Mux のアクセストークン ID とシークレット、Deno 2.9 以降（@mux/mcp はオプションの依存関係として Deno を自動インストールします。できない場合は DENO_PATH を設定します）。必須の環境変数は MUX_TOKEN_ID と MUX_TOKEN_SECRET です。オプションとして MUX_WEBHOOK_SECRET、MUX_SIGNING_KEY、MUX_PRIVATE_KEY（署名付き再生用）、MUX_AUTHORIZATION_TOKEN があります。

Claude Code

claude mcp add mux --env MUX_TOKEN_ID="your_access_token_id" MUX_TOKEN_SECRET="your_secret_key" -- npx -y @mux/mcp@latest

Claude Desktop

mux-ts の最新リリースから mux.mcpb をダウンロードし、Claude Desktop で開いてインストールします（先に Deno をインストールし、バンドルの DENO_PATH を設定してください）。または、以下を claude_desktop_config.json に追加して再起動します：

{
  "mcpServers": {
    "mux": {
      "command": "npx",
      "args": ["-y", "@mux/mcp@latest"],
      "env": {
        "MUX_TOKEN_ID": "your_access_token_id",
        "MUX_TOKEN_SECRET": "your_secret_key"
      }
    }
  }
}

Cursor

同じ mcpServers ブロックを ~/.cursor/mcp.json に追加します（ファイルがなければ作成します）。

VS Code

MCP: Open User Configuration を開き（ワークスペース単位なら .vscode/mcp.json）、"servers" の下に同じ command、args、env でサーバーを追加して、Start をクリックします。

動作確認には「Give me the details for the most recently created Mux Video asset (using the Mux tool)」と聞いてみてください。

Mux MCP Server (Official) の主な機能

• Mux SDK を全面的にカバー：Mux Video（アセット、ダイレクトアップロード、再生 ID、トラック、ライブ配信）、Mux Data（メトリクス、ディメンション、リアルタイムデータ、視聴、エクスポート）、Mux Robots、署名キー、Webhook。
• Code Mode：エージェントが @mux/ts SDK に対して TypeScript を書くため、複数ステップの作業を 1 回の呼び出しで処理でき、コンテキストウィンドウも小さく保てます。
• サンドボックス実行：ホスト型では呼び出しごとに新しく隔離された Mux 管理のサンドボックスで実行され、ローカルでは Mux API ホストにのみアクセスできる Deno サンドボックスで実行されます。
• ホスト型サーバーは OAuth 対応：ログインして環境を選ぶだけで、設定ファイルにシークレットは不要です。
• メソッドの許可・ブロックリスト：ローカルではフラグでサーバーを読み取り専用にしたり、特定の SDK メソッドに限定したりできます。
• 公式かつオープンソース：Mux が Apache-2.0 で公開しています。

Mux MCP Server (Official) のツール

サーバーが公開するツールは 2 つです：

• search_docs は Mux の API と SDK のドキュメントを検索します。
• execute はエージェントが書いた TypeScript を Mux SDK 全体に対して実行し、コードが返した値や出力した内容を返します。

ローカルでは @mux/mcp@latest の後にフラグを付けて範囲を絞れます：--no-tools=code（ドキュメントのみ）または --no-tools=docs、--code-allow-http-gets（読み取り専用）、--code-allowed-methods=<regex> と --code-blocked-methods=<regex>（例：--code-blocked-methods=delete ですべての削除メソッドをブロック）。

Mux MCP Server (Official) のユースケース

• 動画の管理：「すべての動画アセットと現在のステータスを一覧にして。」
• 再生リンクの取得：「Mux アカウントに最後にアップロードした動画の再生 URL を教えて。」
• アクセシビリティ対応：「アセット ID ASSET_ID の字幕トラックを生成して。」
• Mux Robots の利用：「このアセットのチャプターを生成する Robots ジョブを実行して」、または動画を要約してタグを提案させます。
• パフォーマンス分析：「先月、動画配信のパフォーマンスが最も良かった国は？」や「アカウントで最も多い動画エラーは？」
• 機能の構築：「Mux に動画をアップロードできる Web ページを作って。」

Mux MCP Server (Official) と代替ツールの比較

• ホスト型とローカル：ホスト型サーバーが最も手早く使えます（OAuth、インストール不要、Mux が運営するサンドボックス）。クライアントがリモート MCP に対応していない場合や、フラグでツールや SDK メソッドを制限したい場合は、@mux/mcp をローカルで実行します。
• MCP と SDK の直接利用：決まった本番ワークフローには、自分のコードから @mux/ts や Mux API を呼び出してください。MCP サーバーはエージェント主導のアドホックな作業や調査向けです。
• 無関係な「mux」プロジェクト：検索結果には McpMux や mcp-mux などの MCP マルチプレクサーも出てきます。これらは MCP サーバーを束ねるもので、Mux Video とは関係ありません。

Mux MCP Server (Official) のトラブルシューティング

• execute が Deno のエラーで失敗する：Deno がない、または古いことがローカルで最も多い原因です（search_docs は引き続き動作します）。Deno 2.9 以降をインストールし、deno --version で確認して、クライアントの env で DENO_PATH に which deno の出力を設定します。
• サーバーが起動しない：サポートされている Node.js がインストールされ、PATH 上で npx -v が動くことを確認します。Mise を使っている場合は、mise x node@20 -- npx -y @mux/mcp@latest のようにコマンドをラップします。
• 接続できない・認証エラー：トークン ID とシークレットを確認し、余分な空白を取り除き、トークンがその環境で必要な権限を持っているか確かめます。
• Claude Desktop にツールが表示されない：最新版に更新し、JSON が正しいか確認して、アプリを完全に再起動します。