Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Google Gemini API con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
Fai usare alla tua AI Google Gemini con la tua API key: fai domande ai modelli Gemini, analizza immagini e PDF da un link, conta i token, crea embedding e genera o modifica immagini con Nano Banana che compaiono direttamente nella chat.
Prova a chiedere
Prompt di esempio per Google Gemini API
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Google Gemini API, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Gemini API
Fai usare alla tua AI Google Gemini con la tua API key: fai domande ai modelli Gemini, analizza immagini e PDF da un link, conta i token, crea embedding e genera o modifica immagini con Nano Banana che compaiono direttamente nella chat.
Setup
- Apri Google AI Studio su
https://aistudio.google.com/apikeye accedi con il tuo account Google. - Clicca su Create API key, scegli o crea un progetto Google Cloud e copia la chiave. Di solito inizia con
AIza. - Incollala in
GEMINI_API_KEYe installa il connettore. La chiave viene inviata solo a Google. - Per generare immagini, o per avere limiti più alti, attiva la fatturazione per il progetto della chiave in AI Studio (Get API key, poi Set up billing). I modelli di immagini non hanno un free tier.
- Esegui
gemini_list_modelsper vedere quali modelli può usare la tua chiave. Non costa nulla.
Fatturazione: la Gemini API funziona con la tua chiave. Ogni chiamata, tranne l'elenco dei modelli, la Files API e il conteggio dei token, viene addebitata al progetto della chiave o conteggiata nel suo free tier. Nel free tier i modelli di testo e di embedding sono gratuiti entro limiti al minuto e al giorno, e Google può usare i prompt del free tier per migliorare i suoi prodotti. L'AI usa modelli predefiniti economici e veloci (gemini-3.1-flash-lite per il testo, gemini-embedding-001 per gli embedding) finché non chiedi un modello più potente, e gemini_count_tokens stima gratis un prompt lungo prima che tu lo invii.
Le immagini costano: gemini_generate_image e gemini_edit_image creano o modificano immagini con Nano Banana e le mostrano direttamente nella chat. Il modello di immagini predefinito costa circa 0,034 $ per immagine, il più potente circa 0,13 $, quindi l'AI ti chiede conferma prima di ogni immagine. Le immagini oltre 4 MB non vengono restituite: chiedi una dimensione più piccola.
File tramite link: gemini_analyze_file_url risponde a domande su un'immagine, un PDF, un file di testo o CSV o un breve video raggiungibile tramite un link HTTPS pubblico, fino a 15 MB. Gemini apre il link da solo, quindi deve funzionare senza login. I tool della Files API elencano e leggono i file salvati nel progetto, che scadono dopo 48 ore. gemini_delete_file è disattivato all'installazione.
Errori comuni: 400 con chiave non valida: la chiave è sbagliata o è stata eliminata, quindi creane una nuova in AI Studio. 403: la chiave è limitata ad altre API (nella Google Cloud console, in Credentials, API restrictions, consenti la Generative Language API), l'API è disattivata nel suo progetto, oppure un link a un file non è pubblico. 404: il codice del modello non esiste, controllalo con gemini_list_models. 429: è stato raggiunto un limite del free tier o del piano a pagamento, oppure è stato chiamato un modello di immagini senza fatturazione; aspetta o attiva la fatturazione. Un 400 che dice che il free tier non è disponibile significa che non è offerto nella tua regione: attiva la fatturazione. Una richiesta bloccata dai filtri di sicurezza di Google torna come errore e non viene ripetuta.
Il connettore non carica file, non trasmette audio o video in streaming (Live API), non genera voce o video (Veo) e non gestisce context caching, job batch, modelli ottimizzati o file search store.
Prerequisiti: GEMINI_API_KEY
Installazione locale del connettore
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
Apri http://localhost:3000/connectors/store, scegli Google Gemini API e inserisci le variabili elencate nei Prerequisiti.
Tool disponibili
| Tool | What it does |
|---|---|
gemini_list_models | List the Gemini models this API key can use, with their input and output token limits, whether they think, and the methods they support… |
gemini_get_model | Read one Gemini model: display name, description, version, input and output token limits, default temperature, top-p and top-k, whether it… |
gemini_generate_text | Ask a Gemini model one question and get its text answer (generateContent) |
gemini_generate_content | Full generateContent call for conversations and mixed input. contents is the list of turns: [{"role": "user", "parts": [{"text": "..."}]}… |
gemini_analyze_file_url | Ask a Gemini model about a file on the web: an image, a PDF, a text or CSV file or a short video, given by its public HTTPS link (up to 15… |
gemini_count_tokens | Count how many input tokens a text is for a Gemini model, to estimate cost or check it fits the context window before a long call |
gemini_embed_text | Turn one text into an embedding vector (embedContent) for semantic search, clustering or similarity |
gemini_batch_embed_texts | Embed up to 20 texts in one call (batchEmbedContents); the vectors come back in the order given |
gemini_generate_image | Create a picture from a text description with a Gemini image model (Nano Banana) and return it as an image the user can see |
gemini_edit_image | Change an existing picture with a Gemini image model: describe the edit ("replace the sky with a sunset", "remove the person on the left"… |
gemini_list_files | List the files stored in the project's Gemini Files API (uploaded for prompts, or generated), newest first, with name, display name, MIME… |
gemini_get_file | Read one file of the Gemini Files API: display name, MIME type, size, state (PROCESSING, ACTIVE or FAILED), uri to use in… |
gemini_delete_file | Delete a file from the Gemini Files API before it expires |
Esempi di prompt
- "Leggi il PDF con il listino prezzi del fornitore al link che incollo qui sotto ed elenca ogni prodotto con il suo prezzo."
- "Chiedi a Gemini di riscrivere questa descrizione prodotto per il nostro shop online in modo più breve e cordiale."
- "Quanti token è questa offerta per Gemini, e quanto costerebbe riassumerla con il modello predefinito?"
- "Crea con Nano Banana una foto prodotto della nostra tazza in ceramica blu su un tavolo di legno, ma dimmi prima il costo e aspetta il mio OK."
Prossimi passi
Questa guida ti è stata utile?
