Come collegare Vimeo a Gemini via MCP

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

Vimeo + Gemini

Fai lavorare la tua AI con il tuo account Vimeo: elenca e cerca i tuoi video, leggi dettagli, cartelle, showcase, commenti, sottotitoli e trascrizioni, carica un video da un link e cambia titoli, descrizioni e privacy dopo la tua conferma. Usa un token di accesso personale da una tua app sviluppatore Vimeo.

Prerequisiti

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

VIMEO_ACCESS_TOKEN

Step 1 — Ottieni le credenziali

1. Accedi a developer.vimeo.com/apps con l'account Vimeo con cui l'AI deve lavorare e clicca Create an app. Nome e descrizione sono a piacere; scegli che solo tu accederai all'app e accetta i termini.
2. Nella pagina dell'app apri Generate an access token, scegli Authenticated (you) e spunta gli scope Public, Private, Edit, Upload e Stats. Spunta Delete solo se attiverai vimeo_delete_video. Clicca Generate.
3. Copia il token, che viene mostrato una sola volta, in VIMEO_ACCESS_TOKEN e installa il connettore.
4. Verifica la configurazione con vimeo_get_me: mostra l'account, il piano e la quota di upload.

Il token non scade. Smette di funzionare quando lo elimini nella pagina dell'app o elimini l'app. Non si possono aggiungere scope a un token esistente: generane uno nuovo e sostituisci il vecchio.

Cosa legge: i tuoi video, dai più recenti o tramite ricerca in titolo, descrizione, capitoli e tag, con privacy, stato, riproduzioni e tag; tutti i dettagli di un video; cartelle e showcase con i loro video; i commenti; e sottotitoli, anche quelli generati automaticamente, che l'AI può leggere come trascrizione con i tempi. Sottotitoli e trascrizioni funzionano per i video di proprietà del tuo account.

Chiede prima di ogni modifica: vimeo_upload_video_from_url aggiunge un video al tuo account, e vimeo_update_video cambia titolo, descrizione, lingua, password o privacy. L'AI ti dice cosa cambierà, e per la privacy chi potrà guardare il video, poi aspetta il tuo sì. Le modifiche alla privacy valgono subito per chiunque abbia il link.

Upload da un link: Vimeo scarica il file da solo (pull upload). Il link deve puntare direttamente al file video, non a una pagina web, e restare raggiungibile per 24 ore. Poi Vimeo transcodifica il video, e l'AI può seguire l'avanzamento con vimeo_get_video. Gli upload contano sullo spazio e sulla quota settimanale del tuo piano.

Opzioni di privacy: tutti, non in elenco (chiunque abbia il link), nessuno (solo tu), password, contatti, utenti Vimeo, il tuo team, oppure nascosto su vimeo.com e riproducibile solo dove è incorporato. I piani gratuiti non possono usare tutte le opzioni; in quel caso Vimeo risponde 400 o 403.

Disattivato all'installazione: vimeo_delete_video elimina un video definitivamente. Per usarlo genera un token con lo scope Delete e attiva lo strumento; l'AI chiederà poi un sì esplicito per quel preciso video.

Id: l'id di un video è il numero nel suo link vimeo.com. Nell'API le cartelle si chiamano projects e gli showcase albums; l'AI gestisce la differenza per te.

Errori comuni: 401 (codice di errore 8000 o 8003): il token è sbagliato o è stato eliminato; generane uno nuovo. 403: al token manca uno scope come Upload o Edit, oppure il tuo piano non consente l'azione. 404: il video, la cartella o lo showcase non esiste o appartiene a un altro account. 429: troppe richieste; i limiti dipendono dal piano, quindi aspetta e riprova.

Il connettore non scarica file video e non gestisce eventi live, report di analisi, webhook, capitoli, miniature, player o membri del team.

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 Vimeo.

Tool disponibili

Esempi di prompt

• "Elenca i miei dieci video più recenti con titolo, durata e privacy."
• "Leggi la trascrizione del nostro video Product Launch 2026 e riassumila in un paragrafo con i tre punti principali."
• "Quali video nella cartella Webinar clienti sono ancora pubblici? Rendili non in elenco, ma mostrami prima la lista."
• "Carica il video da https://example.com/files/onboarding-2.mp4 come Onboarding parte 2, visibile solo a me."
• "Riassumi i commenti al mio ultimo video e dimmi quali domande sono emerse più spesso."

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