LiveReacting

npx add-mcp 'https://mcp.livereacting.com/mcp'

MCP server

让 AI 代理运行你的直播。

将 ChatGPT 或 Claude 与你的 LiveReacting 账户连接，或通过 API 密钥连接 Claude Code、Codex、Cursor 及其他 MCP 客户端。代理会根据播放列表构建直播流、启动直播、安排直播时间，并在直播结束后读取广播历史记录。

https://mcp.livereacting.com/mcp 复制

Streamable HTTP，仅支持 POST，无会话。API 密钥放在 Authorization 头中作为 Bearer 令牌。ChatGPT 和 Claude 则通过 OAuth 登录。

获取 API 密钥 配置你的客户端

• 所有付费套餐均包含
• 30 个工具，支持只读模式
• 无需安装任何内容

本页面的 Markdown 版本

设置

连接你的客户端。

以下每个客户端都使用同一个 URL 和一个 Authorization 头。密钥就是 REST API 使用的 lr_ 密钥，因此你已有的密钥在这里同样适用。

如果你还没有密钥，请在 LiveReacting Studio 的 Developer 部分创建一个。将其设置为 LIVEREACTING_API_KEY 环境变量并重启客户端。VS Code 会改为要求你输入密钥。

Claude Code Codex CLI Cursor VS Code (GitHub Copilot) Gemini CLI

Claude Code

在项目根目录的 .mcp.json 中。密钥不会写入文件，因此可以安全提交。

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

复制

Codex CLI

在 ~/.codex/config.toml 中。

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

# Then, in your shell profile:
# export LIVEREACTING_API_KEY=lr_...

复制

Cursor

在 ~/.cursor/mcp.json 中。

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

复制

添加到 Cursor

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}" }
    }
  }
}

复制

添加到 VS Code

Gemini CLI

在 ~/.gemini/settings.json 中。

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

复制

任何支持 Streamable HTTP 和 Bearer 头的客户端都可以使用相同的 URL 和相同的头。

先安全测试

在 URL 中添加 ?read_only=1，客户端将只能看到只读工具。代理调用的任何操作都无法更改项目或广播。

工具

代理可以调用什么。

每个名称都以 livereacting_ 开头，因此在按需加载工具的客户端中，一次搜索即可找到整个服务器。

工具	功能	访问权限
账户 你已连接的目标平台。
livereacting_list_destinations	你已连接的 YouTube、Facebook、Twitch、LinkedIn、X 以及你自己的服务器	只读
livereacting_validate_destinations	在依赖之前检查 YouTube、Facebook 或 Twitch 登录是否仍然有效。不会联系自定义目标平台	只读
编辑器 项目、场景以及其中的视频和音频播放列表。
livereacting_list_projects	你的项目，最新的优先	只读
livereacting_get_project	单个项目的完整信息：格式、时长、目标平台和直播状态	只读
livereacting_create_project	创建空项目，这是构建直播流的第一步	写入
livereacting_update_project	更改项目设置	写入
livereacting_get_scenes	项目的场景，以及每个场景内容的摘要	只读
livereacting_manage_scene	创建、重命名或删除场景	破坏性
livereacting_activate_scene	切换正在播出的场景，包括直播运行期间	写入
livereacting_create_scene_with_playlist	一次调用即可添加场景并用视频播放列表填充	写入
livereacting_add_layer	向已有场景添加一个视频播放列表、音频播放列表或单个视频	写入
livereacting_get_layer	读取一个播放列表及其中的视频，每次五十个	只读
livereacting_set_playlist	替换视频或音频播放列表中的所有内容	破坏性
直播 开始直播、安排直播以及直播运行期间观看广播。
livereacting_start_stream	立即开始直播	破坏性
livereacting_stop_stream	结束正在运行的广播	破坏性
livereacting_get_stream_status	直播当前的状态，以及每个目标平台的状态	只读
livereacting_schedule_stream	在未来 28 天内的一个或多个时间点开始直播	写入
livereacting_cancel_schedules	取消一个已安排的广播，或项目上的所有安排	破坏性
livereacting_sync_stream	将你刚刚所做的编辑推送到正在运行的直播	写入
livereacting_list_broadcasts	过去的广播：每次运行的时间、时长和峰值观众数	只读
媒体 构建播放列表所依据的视频库。
livereacting_list_media	你库中的文件和文件夹	只读
livereacting_get_media_file	单个文件，按需提供其技术细节	只读
livereacting_import_media	从 Google Drive、Dropbox 或 YouTube URL 导入一个文件	写入
livereacting_import_from_url	从公共网站的直接链接导入一个视频、音频或图片文件	写入
livereacting_get_import_status	导入进度，以及文件是否已可直播	只读
livereacting_upload_file	从你的电脑开始上传。代理会按照收到的命令发送文件	写入
livereacting_complete_upload	完成上传并将文件添加到你的库中	写入
livereacting_encode_media	将文件加入编码队列以便直播	写入
livereacting_get_encode_status	编码进度	只读
分析 已完成广播产生的数据。
livereacting_get_stream_analytics	所有付费套餐的 YouTube 广播数据，以及按需提供的每个视频播放列表数据	只读

每个工具的输入模式在你连接后来自 tools/list，其描述会说明下一步该调用什么以及轮询之间应等待多久。请在那里阅读这些信息；不要根据上面的名称推断。

在 URL 中添加 ?toolsets= 并附上 account、editor、streams、media 和 analytics 中的任意组合（逗号分隔），客户端将只能看到这些组。过滤由服务器完成，因此任何客户端都可以使用，并且服务器会拒绝无法识别的名称。

示例提示

你提出什么要求，代理就做什么。

用简单的语言说明直播应该做什么。代理会从上面的表格中选择工具，并按任务需要的顺序调用它们。

• “这里有三个 Google Drive 视频链接。用它们在我的 YouTube 频道上构建一个 24/7 直播流并启动它。”

  它会导入这三个文件，等待它们可以直播，填充循环播放列表并开始直播。

• “把上周的网络研讨会录像安排在周五下午 3 点直播。”

  它会在你的库中找到该录像，构建一个播放一次的项目，并安排该开始时间。

• “我们正在直播。切换到间隔场景。”

  它会激活间隔场景并将更改推送到正在运行的广播。直播保持在线。

• “上周的广播表现如何？”

  它会浏览你的项目，列出每个项目运行的广播及其峰值观众数，然后读取 YouTube 的相关数据。

限制

在连接代理之前需要决定的事项。

• 仅限付费套餐

  免费套餐和暂停的订阅不包含 API 访问权限。使用 API 密钥时，每个请求都会被拒绝并返回 403 API_ACCESS_REQUIRES_PAID_PLAN。通过 ChatGPT 或 Claude 连接账户后，每次工具调用都会返回该错误，直到套餐包含 API 访问权限。

• 密钥代表你的账户

  密钥能访问的任何内容，代理都能访问。请在 Studio 的 Developer 部分创建密钥，并在希望代理停止时立即在那里撤销。

• 给代理更少的工具

  添加 ?read_only=1 以仅提供只读工具，或添加 ?toolsets=streams,media 以仅提供你指定的组。服务器会拒绝无法识别的值，而不是忽略它。

• 目前无法做到的事情

  它无法导入 YouTube 播放列表，也无法构建文本、图片或交互式叠加层。你需要在 Studio 中构建这些内容，代理仍然可以运行包含这些内容的直播。

代理应了解的规则

• 每分钟保持低于 150 次工具调用。 按账户计数，initialize 和 tools/list 握手免费。单次超限调用会以 HTTP 200 返回，并附带说明需要等待多久的工具错误，因此模型会读取该错误，而不是客户端自行重试 429。批量请求会被真正的 429 拒绝，且每个批次最多携带 20 条消息。
• set_playlist 会替换整个列表。 它不是追加操作。要添加一个视频，请先读取 get_layer 的每一页，然后发送完整的列表。
• 重试写入操作前先检查。 超时后，先通过 get_stream_status 或你正在创建的对象的列表工具确认写入是否已完成，然后再调用一次。第二次 create_project 会创建第二个项目，第二次 add_layer 会添加第二层。
• 访问标签是提示，不是锁。 每个执行写入或删除操作的工具都带有该注释，客户端可以用它来在调用前询问你。协议不会强制客户端询问，因此请检查客户端自身的设置。
• 24/7 直播需要允许这样做的平台。 Facebook 将仅限 Facebook 的直播限制为八小时，因此 24/7 直播需要 YouTube、你自己的服务器，或 Facebook 之外的第二个目标平台。
• 协议修订版本 2024-10-07 至 2025-11-25。 固定到 2026-07-28 的客户端无法连接，这是客户端无法连接时首先要检查的事项。

常见问题

代理可以删除内容吗？

可以。它可以删除场景、替换整个播放列表、停止广播和取消安排，上表中的每个此类工具都标记为“破坏性”。在 URL 中添加 ?read_only=1 后，服务器不会提供任何此类工具。

它适用于 ChatGPT 和 Claude 吗？

适用。在 ChatGPT 中，打开 Plugins，选择 Add，然后选择 Create MCP App，并输入上面的服务器 URL。在 Claude 中，打开 Customize，然后选择 Connectors，选择 Add custom connector，并输入相同的 URL。两者都会要求你登录 LiveReacting 账户。Claude Code、Codex CLI、Cursor、VS Code 和 Gemini CLI 使用 API 密钥连接，每个客户端在本页都有相应的配置。

代理可以从我的电脑上传视频吗？

可以，前提是代理可以在你的电脑上运行命令。它会向 LiveReacting 请求上传链接，使用 curl 发送文件，文件将加入你的库。每个文件的大小上限取决于你的套餐。没有终端的代理可以一次从公共直接链接导入一个文件，或从 Google Drive、Dropbox 或 YouTube 导入。

完整的参考文档在哪里？

每个工具、每个输入、每个响应字段和每个错误代码都在 MCP 参考文档中。其底层的 REST API 在 旁边的文档中有说明。

从免费账户开始。

在免费套餐的 Studio 中构建你的直播流，该套餐不会过期。当你准备好交给代理时，升级到任何付费套餐，API 密钥会随之提供。

创建免费账户

• 无需信用卡
• 633 条评价中评分 4.8

想先了解数据？查看套餐和定价

[{"@context":"https://schema.org","@type":"WebPage","name":"LiveReacting MCP server | Live streaming for AI agents","url":"https://www.livereacting.com/mcp","inLanguage":"en","description":"Connect ChatGPT, Claude Code or Cursor to LiveReacting. The agent builds a stream from a playlist, starts it and schedules it. Included with every paid plan.","about":{"@type":"SoftwareApplication","name":"LiveReacting MCP server","applicationCategory":"DeveloperApplication","operatingSystem":"Web","url":"https://www.livereacting.com/mcp"}},{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://www.livereacting.com/"},{"@type":"ListItem","position":2,"name":"API","item":"https://www.livereacting.com/api"},{"@type":"ListItem","position":3,"name":"MCP server","item":"https://www.livereacting.com/mcp"}]},{"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Can the agent delete something?","acceptedAnswer":{"@type":"Answer","text":"Yes. It can delete a scene, replace a whole playlist, stop a broadcast and cancel a schedule, and the table above marks each of those tools Destructive. With ?read_only=1 on the URL the server offers none of them."}},{"@type":"Question","name":"Does it work with ChatGPT and Claude?","acceptedAnswer":{"@type":"Answer","text":"Yes. In ChatGPT, open Plugins, choose Add and then Create MCP App, and enter the server URL above. In Claude, open Customize, then Connectors, choose Add custom connector, and enter the same URL. Both then ask you to sign in to your LiveReacting account. Claude Code, Codex CLI, Cursor, VS Code and Gemini CLI connect with an API key, and each has a configuration on this page."}},{"@type":"Question","name":"Can the agent upload a video from my computer?","acceptedAnswer":{"@type":"Answer","text":"Yes, when the agent can run commands on your computer. It asks LiveReacting for upload links, sends the file with curl, and the file joins your library. Each file can be as large as your plan allows. An agent without a terminal can import one file at a time from a direct public link, or from Google Drive, Dropbox or YouTube."}},{"@type":"Question","name":"Where is the full reference?","acceptedAnswer":{"@type":"Answer","text":"Every tool, every input, every response field and every error code is in the MCP reference. The REST API it sits on is documented beside it."}}]}]