如何通过 MCP 将 Twitch 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Twitch、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Twitch + Gemini

让你的 AI 使用 Twitch：查看频道、正在进行的直播、视频、剪辑、分类和直播日程，搜索频道，查看关注者数量和聊天设置，并在你确认后创建剪辑，或修改你的直播标题、分类和标签。通过你自己的 Twitch 开发者应用登录。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

TWITCH_CLIENT_ID, TWITCH_CLIENT_SECRET

步骤 1 — 获取凭证

1. 为你的 Twitch 账号开启双重验证（设置 → 安全和隐私）。Twitch 要求开启后才能注册应用。
2. 打开 dev.twitch.tv/console/apps，点击 Register Your Application。输入任意名称，在 OAuth Redirect URL 中添加 https://cloud.anythingmcp.com/api/mcp-oauth/callback。如果你自行托管 AnythingMCP，请使用 https://your-anythingmcp-host/api/mcp-oauth/callback。选择一个分类，例如 Other，选择 Client Type: Confidential，然后点击 Create。
3. 在新应用上点击 Manage。把 Client ID 复制到 TWITCH_CLIENT_ID，点击 New Secret 并把它复制到 TWITCH_CLIENT_SECRET。密钥只显示一次，新密钥会替换旧密钥。
4. 安装连接器，在连接器页面点击 Authorize with Provider，登录 Twitch 并确认授权。
5. 不带参数调用 twitch_get_users 检查设置：它会返回你自己的账号，以及其他工具需要的用户 ID。

完全免费，大约需要 5 分钟。

每次调用都带 Client ID：Twitch 要求每个请求在令牌之外，还要在 Client-Id 请求头中带上应用的 Client ID。连接器会自动添加，因此 Client ID 必须属于你登录时使用的同一个应用。

可以读取的内容：用户和频道，包括标题、分类、标签和语言；正在进行的直播及观众人数；过往直播、精彩片段和上传的视频；剪辑；分类以及当前观看人数最多的分类；频道和分类搜索；关注者数量；直播日程和聊天设置。这些都是公开数据，适用于任何频道。关注者名单本身只对你自己的频道或你担任管理员的频道显示；其他频道只能看到总数。

每次更改前都会询问：twitch_create_clip 会从正在直播的频道创建剪辑，twitch_update_channel 会修改你的直播标题、分类、语言或标签。观众会立即看到这两种变化，所以 AI 会准确说明将发生什么，并等你同意。只能修改你自己的频道。剪辑在后台生成：AI 会在几秒后用 twitch_get_clips 检查，Twitch 会返回一个 24 小时内有效的编辑链接。

安装时默认关闭：twitch_send_chat_announcement 会发送一条聊天中所有人都能看到的高亮公告。如需使用，请在连接器的 OAuth 设置中添加 scope moderator:manage:announcements，重新授权并启用该工具。它同样会先询问你。

Scopes：moderator:read:followers、clips:edit 和 channel:manage:broadcast。其他内容都是公开的，不需要 scope。

用 ID，不用名字：大多数工具需要数字用户 ID，而不是登录名。AI 会用 twitch_get_users 或 twitch_search_channels 查到 ID，用 twitch_search_categories 查分类 ID。

保持登录：访问令牌有效期为几个小时，会自动续期。当你在设置 → 连接中断开该应用，或修改 Twitch 密码时，登录就会失效；这时请再次点击 Authorize with Provider。

常见错误：401：登录已过期，或者 Client ID 不属于签发令牌的应用；请重新授权，如果改过 Client ID 或密钥，请先更新。401 Missing scope：添加消息中提到的 scope 并重新授权。400：参数错误，或标题被 AutoMod 拒绝。404：该频道没有直播日程，或者创建剪辑时频道未在直播。429：每个用户每分钟约 800 次调用；请等到下一分钟。

连接器不会读取或发送聊天消息和私信，不做管理操作，也不处理订阅、Bits、投票、预测、频道积分、Raid、EventSub、推流密钥或删除视频。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 Twitch 的工具。

可用工具

示例提示

• “现在 Just Chatting 分类里谁在直播？列出观众最多的 10 个直播，附上标题和观众人数。”
• “我下一场计划中的直播是什么时候？标题是什么？”
• “找出我频道过去 30 天里观看次数最多的剪辑。”
• “把我的直播标题改成冲分到钻石，分类改成 Valorant。先给我看看要改的内容。”
• “shroud 的频道有多少关注者？他现在在直播吗？”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT