Come collegare Twitch a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Twitch, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Twitch + Gemini

Fai lavorare la tua AI con Twitch: consulta canali, dirette, video, clip, categorie e programmazione delle live, cerca canali, guarda il numero di follower e le impostazioni della chat, e dopo la tua conferma crea clip o cambia titolo, categoria e tag della tua live. Accesso tramite una tua applicazione sviluppatore Twitch.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

TWITCH_CLIENT_ID, TWITCH_CLIENT_SECRET

Step 1 — Ottieni le credenziali

1. Attiva l'autenticazione a due fattori sul tuo account Twitch (Impostazioni → Sicurezza e privacy). Twitch la richiede per registrare applicazioni.
2. Apri dev.twitch.tv/console/apps e clicca Register Your Application. Inserisci un nome qualsiasi e aggiungi come OAuth Redirect URL https://cloud.anythingmcp.com/api/mcp-oauth/callback. Se ospiti AnythingMCP da solo, usa https://your-anythingmcp-host/api/mcp-oauth/callback. Scegli una categoria come Other, imposta Client Type: Confidential e clicca Create.
3. Clicca Manage sulla nuova applicazione. Copia il Client ID in TWITCH_CLIENT_ID, clicca New Secret e copialo in TWITCH_CLIENT_SECRET. Il secret viene mostrato una sola volta, e un nuovo secret sostituisce il precedente.
4. Installa il connettore, clicca Authorize with Provider nella pagina del connettore, accedi a Twitch e conferma l'accesso.
5. Verifica la configurazione con twitch_get_users senza argomenti: restituisce il tuo account e lo user id che gli altri strumenti chiedono.

È gratuito e richiede circa 5 minuti.

Client ID in ogni chiamata: Twitch vuole il Client ID dell'applicazione in un header Client-Id accanto al token in ogni richiesta. Il connettore lo aggiunge per te, quindi il Client ID deve appartenere alla stessa applicazione con cui hai effettuato l'accesso.

Cosa legge: utenti e canali con titolo, categoria, tag e lingua; dirette con il numero di spettatori; trasmissioni passate, momenti salienti e caricamenti; clip; categorie e le categorie più seguite in questo momento; ricerca di canali e categorie; numero di follower; programmazione delle live e impostazioni della chat. Sono dati pubblici e funzionano per qualsiasi canale. L'elenco dei follower vero e proprio è disponibile solo per il tuo canale o per uno che moderi; per gli altri canali ottieni il totale.

Chiede prima di ogni modifica: twitch_create_clip crea una clip da un canale in diretta in quel momento, e twitch_update_channel cambia titolo, categoria, lingua o tag della tua live. Gli spettatori vedono entrambe le cose subito, quindi l'AI ti mostra esattamente cosa succederà e aspetta il tuo sì. Si può modificare solo il tuo canale. Una clip viene creata in background: l'AI la controlla con twitch_get_clips dopo qualche secondo, e Twitch restituisce un link di modifica valido per 24 ore.

Disattivato all'installazione: twitch_send_chat_announcement pubblica un messaggio evidenziato che tutti in chat vedono. Per usarlo aggiungi lo scope moderator:manage:announcements nelle impostazioni OAuth del connettore, autorizza di nuovo e attiva lo strumento. Anche questo chiede prima.

Scope: moderator:read:followers, clips:edit e channel:manage:broadcast. Tutto il resto è pubblico e non richiede scope.

Id, non nomi: la maggior parte degli strumenti vuole user id numerici, non nomi di login. L'AI li cerca con twitch_get_users o twitch_search_channels, e gli id delle categorie con twitch_search_categories.

Restare collegati: gli access token durano qualche ora e vengono rinnovati automaticamente. L'accesso termina quando scolleghi l'applicazione in Impostazioni → Connessioni o cambi la password di Twitch; a quel punto clicca di nuovo Authorize with Provider.

Errori comuni: 401: l'accesso è scaduto, oppure il Client ID non appartiene all'applicazione che ha emesso il token; autorizza di nuovo, aggiornando prima Client ID o secret se li hai cambiati. 401 Missing scope: aggiungi lo scope indicato nel messaggio e autorizza di nuovo. 400: un parametro sbagliato, o un titolo rifiutato da AutoMod. 404: il canale non ha una programmazione, oppure non è in diretta quando crei una clip. 429: circa 800 chiamate al minuto per utente; aspetta che il minuto finisca.

Il connettore non legge né invia messaggi in chat o sussurri, non modera e non gestisce abbonamenti, bit, sondaggi, previsioni, punti canale, raid, EventSub, chiavi di streaming o l'eliminazione di video.

Step 2 — Installa l'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

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

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

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Twitch.

Tool disponibili

Esempi di prompt

• "Chi è in diretta adesso nella categoria Just Chatting? Mostra le 10 live più seguite con titolo e numero di spettatori."
• "Quando è la mia prossima live in programma, e come si chiama?"
• "Trova le clip più viste del mio canale negli ultimi 30 giorni."
• "Imposta il titolo della mia live su Ranked fino a Diamante e la categoria su Valorant. Mostrami prima la modifica."
• "Quanti follower ha il canale shroud, ed è in diretta adesso?"

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT