Server MCP

Lascia che un agente IA gestisca le tue dirette.

Collega Claude Code, Codex, Cursor o un altro client MCP che accetti una chiave API. L’agente crea una diretta da una playlist, la avvia, la programma e poi legge lo storico delle trasmissioni.

https://mcp.livereacting.com/mcp

Streamable HTTP, solo POST, nessuna sessione. La chiave va nell’header Authorization come token Bearer.

  • Incluso in ogni piano a pagamento
  • 27 strumenti, con modalità di sola lettura
  • Niente da installare

Questa pagina in Markdown

Configurazione

Collega il tuo client.

Un solo URL e un solo header Authorization per ogni client. È la stessa chiave lr_ che usa l’API REST, quindi funziona anche una chiave che hai già.

Se non hai ancora una chiave, creane una nella sezione Developer di LiveReacting Studio. Impostala come variabile d’ambiente LIVEREACTING_API_KEY e riavvia il client. VS Code invece ti chiede la chiave.

Claude Code

In .mcp.json nella root del progetto. La chiave resta fuori dal file, quindi puoi committarlo senza rischi.

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

Codex CLI

In ~/.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

In ~/.cursor/mcp.json.

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

VS Code (GitHub Copilot)

In .vscode/mcp.json. Il blocco inputs fa sì che VS Code ti chieda la chiave invece di salvarla nel repository.

{
  "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}" }
    }
  }
}
Aggiungi a VS Code

Gemini CLI

In ~/.gemini/settings.json.

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

Qualsiasi client che supporti Streamable HTTP e un header Bearer usa lo stesso URL e lo stesso header.

Prima prova in sicurezza

Aggiungi ?read_only=1 all’URL e al client vengono offerti solo gli strumenti di lettura. Nessuno strumento chiamato dall’agente può modificare un progetto o una trasmissione.

Strumenti

Cosa può chiamare l’agente.

Ogni nome inizia con livereacting_, così in un client che carica gli strumenti su richiesta basta una ricerca per trovare tutto il server.

Strumento Cosa fa Accesso
Account Le destinazioni che hai già collegato.
livereacting_list_destinations I tuoi account YouTube, Facebook, Twitch, LinkedIn e X collegati, e i tuoi server Sola lettura
livereacting_validate_destinations Verifica che il login a YouTube, Facebook o Twitch funzioni ancora prima di contarci. Le destinazioni personalizzate non vengono contattate Sola lettura
Editor Progetti, scene e le playlist video e audio al loro interno.
livereacting_list_projects I tuoi progetti, dal più recente Sola lettura
livereacting_get_project Un progetto completo: formato, durata, destinazioni e stato della diretta Sola lettura
livereacting_create_project Crea un progetto vuoto, il primo passo per costruire una diretta Scrittura
livereacting_update_project Modifica le impostazioni di un progetto Scrittura
livereacting_get_scenes Le scene di un progetto, con un riepilogo di cosa c’è in ciascuna Sola lettura
livereacting_manage_scene Crea, rinomina o elimina una scena Distruttivo
livereacting_activate_scene Cambia la scena in onda, anche mentre la diretta è in corso Scrittura
livereacting_create_scene_with_playlist Aggiungi una scena e riempila con una playlist video in una sola chiamata Scrittura
livereacting_add_layer Aggiungi una playlist video, una playlist audio o un singolo video a una scena già esistente Scrittura
livereacting_get_layer Leggi una playlist e i suoi video, cinquanta alla volta Sola lettura
livereacting_set_playlist Sostituisci tutto il contenuto di una playlist video o audio Distruttivo
Dirette Andare in diretta, programmare e seguire una trasmissione mentre è in corso.
livereacting_start_stream Vai in diretta ora Distruttivo
livereacting_stop_stream Termina la trasmissione in corso Distruttivo
livereacting_get_stream_status Cosa sta facendo la diretta in questo momento, e lo stato di ogni destinazione Sola lettura
livereacting_schedule_stream Vai in diretta in uno o più orari nei prossimi 28 giorni Scrittura
livereacting_cancel_schedules Annulla una trasmissione programmata, o tutte le programmazioni di un progetto Distruttivo
livereacting_sync_stream Applica alla diretta in corso le modifiche che hai appena fatto Scrittura
livereacting_list_broadcasts Trasmissioni passate: quando è andata in onda ciascuna, per quanto tempo e il picco di spettatori Sola lettura
Media La libreria video da cui si costruiscono le playlist.
livereacting_list_media I file e le cartelle della tua libreria Sola lettura
livereacting_get_media_file Un singolo file, con i dettagli tecnici se li chiedi Sola lettura
livereacting_import_media Importa un file da un URL di Google Drive, Dropbox o YouTube Scrittura
livereacting_get_import_status A che punto è un’importazione, e se il file può già essere trasmesso Sola lettura
livereacting_encode_media Metti in coda i file per la codifica, così potranno essere trasmessi Scrittura
livereacting_get_encode_status A che punto è la codifica Sola lettura
Statistiche I numeri prodotti da una trasmissione conclusa.
livereacting_get_stream_analytics Le statistiche delle trasmissioni di YouTube su ogni piano a pagamento, e le statistiche per singolo video della playlist su richiesta Sola lettura

Lo schema di input di ogni strumento arriva da tools/list una volta collegato il client, e la sua descrizione dice cosa chiamare dopo e quanto aspettare tra un polling e l’altro. Leggili lì; non dedurli dai nomi qui sopra.

Aggiungi ?toolsets= con uno o più tra account, editor, streams, media e analytics, separati da virgola, e al client vengono offerti solo quei gruppi. Il filtro lo fa il server, quindi funziona con qualsiasi client, e un nome che non riconosce viene rifiutato.

Esempi di prompt

Cosa chiedi, e cosa fa l’agente.

Di’ a parole semplici cosa deve fare la diretta. L’agente sceglie gli strumenti dalla tabella qui sopra e li chiama nell’ordine che il lavoro richiede.

  • “Ecco tre link a video su Google Drive. Usali per creare una diretta 24/7 sul mio canale YouTube e avviala.”

    Importa i tre file, aspetta che possano essere trasmessi, riempie una playlist in loop e va in diretta.

  • “Programma in diretta la registrazione del webinar della settimana scorsa per venerdì alle 3 del pomeriggio.”

    Trova la registrazione nella tua libreria, crea un progetto che la riproduce una volta e programma quell’unico orario di inizio.

  • “Siamo in diretta. Passa alla scena dell’intervallo.”

    Attiva la scena dell’intervallo e applica la modifica alla trasmissione in corso. La diretta resta in onda.

  • “Come sono andate le trasmissioni della settimana scorsa?”

    Scorre i tuoi progetti, elenca le trasmissioni di ciascuno con il relativo picco di spettatori, poi legge le loro statistiche di YouTube.

Limiti

Cosa decidere prima di collegare un agente.

  • Solo piani a pagamento

    Il piano Free non include l’accesso alle API. Ogni richiesta viene rifiutata con 403 API_ACCESS_REQUIRES_PAID_PLAN, compresa la prima, quindi il client non riesce a connettersi. Un abbonamento in pausa riceve lo stesso codice.

  • La chiave equivale al tuo account

    L’agente arriva ovunque arrivi la chiave. Creala nella sezione Developer dello Studio, e revocala lì nel momento in cui vuoi che l’agente si fermi.

  • Dai all’agente meno strumenti

    Aggiungi ?read_only=1 per gli strumenti di lettura, oppure ?toolsets=streams,media per i gruppi che indichi. Il server rifiuta un valore non riconosciuto invece di ignorarlo.

  • Cosa non può ancora fare

    Non può caricare un file dal tuo computer, importare una playlist di YouTube né creare un overlay di testo, immagine o interattivo. Questi li crei nello Studio, e l’agente può comunque gestire una diretta che li contiene.

Regole che l’agente deve conoscere

  • Resta sotto le 150 chiamate agli strumenti al minuto. Il conteggio è per account, e l’handshake di initialize e tools/list non viene conteggiato. Una singola chiamata oltre il limite torna come HTTP 200 con un errore dello strumento che dice quanto aspettare, così lo legge il modello, invece di un client che ritenta da solo dopo un 429. Un batch viene rifiutato con un vero 429, e può contenere al massimo 20 messaggi.
  • set_playlist sostituisce l’intera lista. Non aggiunge in coda. Per aggiungere un video, leggi prima ogni pagina di get_layer, poi rimanda la lista completa.
  • Controlla prima di ritentare una scrittura. Dopo un timeout, chiedi a get_stream_status, o allo strumento che elenca ciò che stavi creando, se la scrittura è andata a buon fine prima di richiamarla. Un secondo create_project crea un secondo progetto, e un secondo add_layer aggiunge un secondo livello.
  • Le etichette di accesso sono indicazioni, non blocchi. Ogni strumento che scrive o elimina riporta l’annotazione, e un client può usarla per chiederti conferma prima della chiamata. Il protocollo non lo obbliga a chiedere, quindi controlla l’impostazione del tuo client.
  • Una diretta 24/7 ha bisogno di una destinazione che la consenta. Facebook limita a otto ore una diretta solo su Facebook, quindi una diretta 24/7 ha bisogno di YouTube, di un tuo server o di una seconda destinazione oltre a Facebook.
  • Revisioni del protocollo dalla 2024-10-07 alla 2025-11-25. Un client fissato sulla 2026-07-28 non riesce a connettersi, ed è la prima cosa da controllare quando un client non si collega.

Domande

L’agente può eliminare qualcosa?

Sì. Può eliminare una scena, sostituire un’intera playlist, fermare una trasmissione e annullare una programmazione, e la tabella qui sopra contrassegna ciascuno di questi strumenti come “Distruttivo”. Con ?read_only=1 nell’URL il server non ne offre nessuno.

Funziona con Claude Desktop o ChatGPT?

Non ancora. Entrambi richiedono OAuth per un server remoto, mentre questo server si autentica con la tua chiave API. Claude Code, Codex CLI, Cursor, VS Code e Gemini CLI accettano tutti una chiave, e per ciascuno trovi una configurazione in questa pagina.

L’agente può caricare un video dal mio computer?

No. I video arrivano dalla tua libreria di LiveReacting, oppure l’agente importa un file alla volta da un link di Google Drive, Dropbox o YouTube. Per caricare dal tuo disco, usa LiveReacting Studio.

Dov’è la documentazione completa?

Ogni strumento, ogni input, ogni campo di risposta e ogni codice di errore è nella documentazione di riferimento MCP. L’API REST su cui si basa è documentata lì accanto.

Inizia con un account gratuito.

Crea la tua diretta nello studio con il piano Free, che non scade. Passa a un qualsiasi piano a pagamento quando sei pronto ad affidarla a un agente: la chiave API è inclusa.

  • Nessuna carta di credito
  • 4.8 in base a 633 recensioni

Vuoi vedere prima i numeri? Vedi piani e prezzi