Cómo conectar Twitch a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Twitch, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Twitch + Gemini

Deja que tu IA trabaje con Twitch: consulta canales, directos, vídeos, clips, categorías y horarios de emisión, busca canales, mira el número de seguidores y la configuración del chat, y tras tu confirmación crea clips o cambia el título, la categoría y las etiquetas de tu directo. Inicio de sesión mediante una aplicación de desarrollador de Twitch propia.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

TWITCH_CLIENT_ID, TWITCH_CLIENT_SECRET

Paso 1 — Obtener credenciales

1. Activa la autenticación en dos pasos en tu cuenta de Twitch (Configuración → Seguridad y privacidad). Twitch la exige para registrar aplicaciones.
2. Abre dev.twitch.tv/console/apps y haz clic en Register Your Application. Escribe cualquier nombre y añade como OAuth Redirect URL https://cloud.anythingmcp.com/api/mcp-oauth/callback. Si alojas AnythingMCP por tu cuenta, usa https://your-anythingmcp-host/api/mcp-oauth/callback. Elige una categoría como Other, selecciona Client Type: Confidential y haz clic en Create.
3. Haz clic en Manage en la nueva aplicación. Copia el Client ID en TWITCH_CLIENT_ID, haz clic en New Secret y cópialo en TWITCH_CLIENT_SECRET. El secret se muestra una sola vez, y uno nuevo sustituye al anterior.
4. Instala el conector, haz clic en Authorize with Provider en la página del conector, inicia sesión en Twitch y confirma el acceso.
5. Comprueba la configuración con twitch_get_users sin argumentos: devuelve tu propia cuenta y el user id que piden las demás herramientas.

Es gratis y lleva unos 5 minutos.

Client ID en cada llamada: Twitch quiere el Client ID de la aplicación en una cabecera Client-Id junto al token en cada petición. El conector lo añade por ti, así que el Client ID debe ser de la misma aplicación con la que iniciaste sesión.

Qué lee: usuarios y canales con título, categoría, etiquetas e idioma; directos con número de espectadores; emisiones pasadas, destacados y subidas; clips; categorías y las más vistas en este momento; búsqueda de canales y categorías; número de seguidores; horarios de emisión y configuración del chat. Son datos públicos y funcionan con cualquier canal. La lista de seguidores en sí solo se muestra para tu canal o uno que moderes; en los demás obtienes el total.

Pregunta antes de cada cambio: twitch_create_clip crea un clip de un canal que está en directo ahora mismo, y twitch_update_channel cambia el título, la categoría, el idioma o las etiquetas de tu directo. Los espectadores ven ambos cambios al instante, así que la IA te muestra exactamente qué va a pasar y espera tu sí. Solo se puede cambiar tu propio canal. Un clip se crea en segundo plano: la IA lo comprueba con twitch_get_clips al cabo de unos segundos, y Twitch devuelve un enlace de edición válido durante 24 horas.

Desactivada al instalar: twitch_send_chat_announcement publica un mensaje destacado que ve todo el chat. Para usarla, añade el scope moderator:manage:announcements en los ajustes OAuth del conector, autoriza de nuevo y activa la herramienta. También pregunta antes.

Scopes: moderator:read:followers, clips:edit y channel:manage:broadcast. Todo lo demás es público y no necesita scope.

Ids, no nombres: la mayoría de las herramientas piden user ids numéricos, no nombres de usuario. La IA los busca con twitch_get_users o twitch_search_channels, y los ids de categoría con twitch_search_categories.

Seguir conectado: los access tokens duran unas horas y se renuevan solos. La sesión termina si desconectas la aplicación en Configuración → Conexiones o cambias la contraseña de Twitch; entonces vuelve a hacer clic en Authorize with Provider.

Errores habituales: 401: la sesión ha caducado, o el Client ID no es de la aplicación que emitió el token; autoriza de nuevo y, si cambiaste el Client ID o el secret, actualízalos antes. 401 Missing scope: añade el scope que indica el mensaje y autoriza de nuevo. 400: un parámetro incorrecto, o un título rechazado por AutoMod. 404: el canal no tiene horario, o no está en directo al crear un clip. 429: unas 800 llamadas por minuto y usuario; espera a que pase el minuto.

El conector no lee ni envía mensajes de chat o susurros, no modera y no gestiona suscripciones, bits, encuestas, predicciones, puntos de canal, raids, EventSub, claves de transmisión ni el borrado de vídeos.

Paso 2 — Instalar el 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

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

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

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Twitch.

Herramientas disponibles

Ejemplos de prompts

• "¿Quién está en directo ahora en la categoría Just Chatting? Muestra los 10 directos más grandes con título y espectadores."
• "¿Cuándo es mi próximo directo programado y cómo se llama?"
• "Busca los clips más vistos de mi canal en los últimos 30 días."
• "Pon como título de mi directo Ranked hasta Diamante y como categoría Valorant. Enséñame el cambio antes."
• "¿Cuántos seguidores tiene el canal shroud, y está en directo ahora?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT