LiveReacting

LiveReacting MCP サーバー

AI エージェントからライブ動画配信を実行できます。動画プレイリストからチャンネルを作成し、開始、スケジュール設定、配信中の視聴、終了後の数値の確認まで、Claude Code、 Codex、Cursor、その他MCPに対応するツールから行えます。

https://mcp.livereacting.com/mcp

ストリーミング可能なHTTP。ステートレス。LiveReacting APIキーで認証します。

すべてのツール、入力、レスポンスフィールド、制限、エラーコードを網羅した完全なリファレンス： developers.livereacting.com/mcp （このリポジトリのREFERENCE.md）。

---

キーを取得する

APIアクセスはすべての有料プランに含まれています。LiveReacting Studioの Developerセクションでキーを作成してください。 キーはlr_で始まります。

APIキーを使用すると、Freeプランのアカウントではすべての呼び出しで403 API_ACCESS_REQUIRES_PAID_PLANが返されます。OAuth（ChatGPT、Claude）ではアカウントを接続できますが、各ツール呼び出しでプランの制限を説明するエラーが返されます。プランにAPIアクセスが含まれるようになると、再接続しなくてもツールが使えるようになります。

---

セットアップ

まずキーを作成し、シェルプロファイルでLIVEREACTING_API_KEYとして設定してから、以下の設定を貼り付けます。

環境変数を読み取れないすべての例では、プレースホルダーとしてlr_…を使用しています。**実際のキーをコミットするファイルに貼り付けないでください。**環境変数または プロンプトに対応するハーネスでは、その方法を設定ブロックで使用しています。

Claude Code

.mcp.jsonに設定します。Claude Codeはリモートサーバーのheaders内の${VAR}を展開するため （ドキュメント）、キーをファイルに記載せずに済みます。

{
  "mcpServers": {
    "livereacting": {
      "type": "http",
      "url": "https://mcp.livereacting.com/mcp",
      "headers": { "Authorization": "Bearer ${LIVEREACTING_API_KEY}" }
    }
  }
}

claude mcp add --transport http livereacting https://mcp.livereacting.com/mcp --header "Authorization: Bearer lr_…"も使えますが、キー自体が保存される設定に書き込まれます。

Codex CLI

~/.codex/config.tomlに設定します。

[mcp_servers.livereacting]
url = "https://mcp.livereacting.com/mcp"
bearer_token_env_var = "LIVEREACTING_API_KEY"

次に、シェルプロファイルでexport LIVEREACTING_API_KEY=lr_…を実行します。キーが設定ファイルに入るhttp_headersより、こちらを推奨します。

Cursor

~/.cursor/mcp.jsonに設定します。Cursorはheaders内の${env:NAME}を解決します （ドキュメント）。

{
  "mcpServers": {
    "livereacting": {
      "url": "https://mcp.livereacting.com/mcp",
      "headers": { "Authorization": "Bearer ${env:LIVEREACTING_API_KEY}" }
    }
  }
}

または、Cursor MarketplaceからLiveReactingプラグインをインストールし、Plugins → ConfigureでLIVEREACTING_API_KEYを設定します。このリポジトリのプラグインは .cursor-plugin/plugin.jsonとmcp.jsonです。

VS Code（GitHub Copilot）

.vscode/mcp.jsonに設定します。inputsブロックを使うと、キーをリポジトリに保存せずに、VS Codeから入力を求められます。

{
  "inputs": [
    {
      "id": "livereacting-key",
      "type": "promptString",
      "description": "LiveReacting API key",
      "password": true
    }
  ],
  "servers": {
    "livereacting": {
      "type": "http",
      "url": "https://mcp.livereacting.com/mcp",
      "headers": { "Authorization": "Bearer ${input:livereacting-key}" }
    }
  }
}

Gemini CLI

拡張機能をインストールします。Gemini CLIはキーの入力を一度だけ求め、システムのキーチェーンに保存します。

gemini extensions install https://github.com/LiveReacting/livereacting-mcp

拡張機能を使わない場合は、~/.gemini/settings.jsonに設定します。Gemini CLIは、検証前にファイル内のすべての文字列で$VARと${VAR}を展開します。ヘッダーも対象です （ドキュメント）。そのため、キーをファイルに記載せずに済みます。

{
  "mcpServers": {
    "livereacting": {
      "httpUrl": "https://mcp.livereacting.com/mcp",
      "headers": { "Authorization": "Bearer ${LIVEREACTING_API_KEY}" }
    }
  }
}

Kiro

このリポジトリをパワーとしてインストールします。Powersパネル → Add Custom Power → Import power from GitHubを選び、https://github.com/LiveReacting/livereacting-mcpを貼り付けます。このパワーは環境変数からLIVEREACTING_API_KEYを読み取ります（mcp.json）。

Zed

Zedのsettings.jsonで、context_serversの下に、URLとAuthorizationヘッダーを指定したHTTPサーバーを追加します。

Goose

Gooseの設定で、URLをhttps://mcp.livereacting.com/mcpにし、カスタムヘッダーAuthorization: Bearer lr_…を指定して、Remote Extension（ストリーミング可能なHTTP）を追加します。

互換性

ハーネス	キーの渡し方
Claude Code	.mcp.json のヘッダーで ${VAR}
Codex CLI	bearer_token_env_var
Cursor	mcp.json のヘッダーで ${env:VAR}
VS Code Copilot	入力を促す headers
GitHub Copilot coding agent	静的なヘッダーシークレットのみ。この製品は OAuth リモートサーバーに対応していないため、ここでは現在も今後もキーを使う方法しかありません
Gemini CLI	settings.json のヘッダーで $VAR
Kiro	power の mcp.json のヘッダーで ${VAR}
Zed	settings.json の headers
Goose	リモート拡張機能のヘッダー
ChatGPT	コネクターは OAuth を使うか、何も使わないかのどちらかで、キーを貼り付ける方法はありません

プロトコルのリビジョン： 2024-10-07 から 2025-11-25 までです。クライアントでバージョンエラーが表示された場合は、まずこれを確認してください。2026-07-28 にはまだ対応していません。これに対応する公開済みの TypeScript SDK はありません。

---

ツール

5 つのツールセットに 30 個のツールがあります。すべての名前に livereacting_ が付いているため、ツールの読み込みを遅延するクライアントでも、検索 1 回でサーバー全体を見つけられます。

account

ツール	説明
list_destinations	接続済みの YouTube、Facebook、Twitch、LinkedIn、X、カスタム RTMP の配信先
validate_destinations	配信先に接続できる状態が維持されているかを、利用する前に確認します

editor

ツール	説明
list_projects	プロジェクトの一覧
get_project	1 つのプロジェクトの設定
create_project	新しいプロジェクトを作成します
update_project	プロジェクトの設定を変更します
get_scenes	プロジェクト内のシーン、または 1 つのシーン
manage_scene	シーンを作成、名前変更、削除します
activate_scene	配信中を含め、アクティブなシーンを切り替えます
create_scene_with_playlist	シーンとその動画プレイリストを 1 回の呼び出しで作成します
add_layer	既存のシーンに、動画プレイリスト、音声プレイリスト、または単一の動画レイヤーを追加します
get_layer	1 つのレイヤーと、コンテキスト用に短縮されたそのプレイリスト
set_playlist	プレイリストの内容を置き換えます

streams

ツール	説明
start_stream	ライブ配信を開始します
stop_stream	配信を終了します
get_stream_status	接続切れを含む、配信先ごとのライブ状態
schedule_stream	指定した時刻にライブ配信を開始します
cancel_schedules	予定されている配信をキャンセルします
sync_stream	エディターの変更を実行中の配信に反映します
list_broadcasts	プロジェクトの過去の配信

media

ツール	説明
list_media	ライブラリ内のファイルとフォルダー
get_media_file	1 つのファイルの詳細
upload_file	ローカルファイルのアップロードを開始します。パートの URL と curl コマンドを返します
complete_upload	すべてのパートの送信後にアップロードを完了します
import_media	Google Drive、Dropbox、YouTube からインポートします
import_from_url	公開ホスト上のメディアファイルへの直接リンクからインポートします
get_import_status	プレイリストのインポートに含まれるすべての動画を含め、インポート状況を確認します
encode_media	ストリーミング用にファイルを再エンコードします
get_encode_status	エンコード状況を確認します

analytics

ツール	説明
get_stream_analytics	YouTube のアナリティクス、または動画ごとのプレイリストアナリティクス（この種類はリクエストに応じて提供）

使用するツールを絞り込む

どちらも URL のクエリパラメーターなので、クライアント側の対応は不要です。

https://mcp.livereacting.com/mcp?toolsets=streams,media
https://mcp.livereacting.com/mcp?read_only=1

read_only=1 を指定すると、変更を伴うすべてのツールが除外されます。ライブ配信に触れてほしくない監視エージェントに便利です。

制限事項について、正直にお伝えします

次のいずれかを約束するエージェントは、お客様に嘘をついています。

• 作成できるのは動画と音声のプレイリストだけです。 テキスト、画像、インタラクティブレイヤーは API で読み取れますが、作成や編集ができるのは LiveReacting Studio のみです。
• 運用にはそのような制限はありません。 Studio で作成したオーバーレイを含む配信は、ここから開始、停止、スケジュール設定、同期、監視ができます。境界となるのは、作成 と 運用 の違いです。
• ローカルファイルのアップロードには、シェルまたは HTTP クライアントが必要です。 upload_file は署名付きパート URL と実行可能な curl コマンドを返します。エージェント自身がバイト列を送信し、その後 complete_upload を呼び出します。
• すべてのプランには配信の最大時間があります。 手動で時間を指定していても、配信は上限に達すると停止します。24 時間 365 日のチャンネルには、24/7 プランのような時間制限のないプランが必要です。
• Facebook のみを使用した 24/7 チャンネルは作成できません。 Facebook のみの配信には、固定の最大時間として 8 時間が設定されています。
• サムネイルとライブ配信の告知には対応していません。
• プレイリスト分析はリクエストに応じて利用できます。 YouTube 分析はすべての有料プランに含まれますが、チャンネルで分析へのアクセスを許可している必要があります。プレイリスト分析については [email protected] までお問い合わせください。

---

レート制限

アカウントあたり毎分 150 リクエストで、API キー間で共有されます。

REST と MCP は別々にカウントされるため、共有の上限ではなく、それぞれ 150 件ずつ利用できます。ただし、これを前提に計画しないでください。これは 2 つのインターフェースの計測方法に関する実装上の詳細であり、保証ではありません。

429 は、モデルが読み取れるように、制限回数と待機時間を示すツールエラーとして返されます。ポーリングツールの get_stream_status、get_import_status、get_encode_status には、それぞれ最小ポーリング間隔が記載されています。それより短い間隔でポーリングしても、何も得られないまま自分の上限を消費するだけです。

---

エージェントが思わぬ事態に直面する前に知っておくべきこと

set_playlist はプレイリスト全体を置き換えます。 末尾に追加する操作ではありません。動画を 1 本追加するには、まずレイヤーを読み取り、完全なリストを送り返してください。書き込みによってプレイリストが短くなる場合はツールが通知しますが、指示どおりに処理は実行されます。

配信の開始と停止は冪等ではありません。 呼び出しがタイムアウトした場合は、get_stream_status で状況を確認してください。再試行しないでください。再試行すると、2 回目の試行が開始される可能性があります。

---

ドキュメント

MCP の完全なリファレンス：developers.livereacting.com/mcp
REST API の完全なリファレンス：developers.livereacting.com
サポート：[email protected]
プライバシーポリシー：livereacting.com/privacy-policy