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.
Configurazione guidata
Collega Google Gemini API a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Google Gemini API con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
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 + Microsoft Copilot
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.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
GEMINI_API_KEY
Step 1 — Ottieni le credenziali
- 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.
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 Microsoft Copilot
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 mostraYOUR_SERVER_ID.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Gemini API. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
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."
FAQ
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?