Come collegare Cloudinary a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, apri Connectors → Cloudinary, installalo, clicca Authorize with Provider e approva in Cloudinary, poi genera una MCP API key. Niente Docker, niente git clone, niente server locale.

Cloudinary + Gemini

Carica immagini e video su Cloudinary e ottieni un URL pubblico, cerca e organizza la tua libreria multimediale, genera immagini con l'AI e crea trasformazioni da Claude, ChatGPT o Copilot tramite il server MCP ufficiale di Cloudinary.

Prerequisiti

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

(nessuna: dopo l'installazione accedi con Cloudinary)

Step 1 — Accedi con Cloudinary

Cloudinary gestisce un proprio server MCP remoto ufficiale per la libreria multimediale, l'Asset Management MCP server all'indirizzo https://asset-management.mcp.cloudinary.com/mcp. Questo connettore lo collega: i tool sono quelli di Cloudinary, e AnythingMCP li mette dietro il tuo server AnythingMCP con OAuth per Claude e ChatGPT, ruoli per tool e audit log.

1. Installa il connettore. Non c'è niente da incollare: nessuna API key, nessun client ID né secret.
2. Nella pagina del connettore clicca Authorize with Provider. AnythingMCP si registra presso Cloudinary e ti porta all'accesso di Cloudinary. Non devi configurare nessun redirect URI.
3. Accedi, scegli il product environment (cloud) che l'AI deve usare e approva. Tornato in AnythingMCP, l'elenco dei tool viene ricaricato dal server di Cloudinary. Cloudinary aggiunge tool nel tempo: Discover tools sul connettore recupera quelli nuovi.
4. Per verificare che funzioni, esegui cloudinary_get_usage_details. Mostra crediti, spazio di archiviazione e banda rispetto al tuo piano.

A cosa serve: molte API accettano un file solo tramite URL pubblico, per esempio la pubblicazione su Instagram e Facebook. cloudinary_upload_asset accetta un URL pubblico, un data URI Base64 o un percorso privato su S3 o Google Cloud Storage e restituisce secure_url, un link HTTPS che chiunque può scaricare. Instagram vuole JPEG, quindi i link per Instagram usano f_jpg invece di f_auto.

Di chi è l'accesso: chi effettua l'accesso diventa l'utente Cloudinary per tutti quelli che usano questo connettore, nel product environment scelto all'accesso. Per un connettore condiviso, accedi con un utente Cloudinary il cui ruolo copra solo ciò che l'AI deve fare. Per cambiare environment, clicca di nuovo Authorize with Provider e scegline un altro.

Pubblico per impostazione predefinita: un file caricato con il delivery type predefinito upload è pubblico per chiunque abbia il suo URL. Per i file riservati imposta type su authenticated o private, oppure usa access_control; quei link richiedono poi una firma e non servono a un'API che scarica i file tramite URL.

Disattivati all'installazione: cloudinary_delete_asset, cloudinary_delete_derived_assets, cloudinary_delete_folder e cloudinary_delete_asset_relations. Caricamenti, rinomine e modifiche a tag e metadati restano attivi. cloudinary_asset_rename cambia l'URL di un asset, quindi i link già condivisi smettono di funzionare.

Piano: il piano gratuito di Cloudinary va bene. Le immagini AI (cloudinary_generate_image, cloudinary_generate_image_from_images) richiedono l'add-on Image Generation e consumano crediti. L'AI non può leggere i file sul tuo computer; cloudinary_sign_upload restituisce i parametri firmati per inviare un file del genere direttamente a Cloudinary.

Senza effettuare l'accesso: il server di Cloudinary accetta anche la API key. Nelle impostazioni del connettore passa l'autenticazione su API key, imposta il nome dell'header su cloudinary-url e incolla la API environment variable da Settings, API Keys nella Cloudinary Console (cloudinary://<api_key>:<api_secret>@<cloud_name>).

Gli altri server MCP di Cloudinary, per la configurazione dell'environment (upload preset, trasformazioni con nome, webhook), i metadati strutturati e l'analisi dei media, non fanno parte di questo connettore; aggiungili come connettori MCP personalizzati se ti servono.

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

Tool disponibili

Esempi di prompt

• "Carica la foto prodotto da questo link nella cartella products/2026, aggiungi il tag summer e dammi l'URL pubblico."
• "Trova tutte le immagini con il tag summer caricate nell'ultima settimana ed elenca public ID e dimensioni dei file."
• "Quanto del nostro piano Cloudinary abbiamo usato finora in crediti, spazio di archiviazione e banda?"
• "Crea un link JPEG quadrato 1080 per 1080 del nostro ultimo hero banner per Instagram e mostramelo prima che lo pubblichi."

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