Come collegare Tavily a Gemini via MCP

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

Tavily + Gemini

Dai alla tua AI una ricerca web in tempo reale pensata per gli agenti, con Tavily: cerca sul web o tra le notizie con una risposta breve e le fonti, leggi le pagine come testo pulito, mappa e scansiona siti web, avvia ricerche più lunghe e controlla i tuoi crediti.

Prerequisiti

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

TAVILY_API_KEY

Step 1 — Ottieni le credenziali

1. Accedi a https://app.tavily.com. Il piano gratuito include 1.000 crediti al mese e non richiede carta.
2. Copia la API key dalla pagina di panoramica (inizia con tvly-) oppure creane una nuova.
3. Incollala in TAVILY_API_KEY così come la mostra Tavily, senza la parola Bearer, e installa il connettore. La chiave viene inviata solo a Tavily.
4. Inizia con tavily_get_usage: mostra i crediti usati dalla tua chiave e dal tuo piano e quanti ne restano.

Addebitato sui tuoi crediti Tavily: ricerche, estrazioni, mappe, crawl e report di ricerca consumano crediti del tuo account Tavily, e ogni risposta indica quanti ne ha usati. Il connettore mantiene le impostazioni predefinite più economiche, a meno che tu non chieda di più:

• Ricerca: 1 credito per una ricerca base, 2 per una avanzata.
• Estrazione: 1 credito ogni 5 pagine, 2 con l'estrazione avanzata.
• Mappa: 1 credito ogni 10 pagine trovate.
• Crawl: la mappa più l'estrazione delle pagine lette.
• Report di ricerca: da 4 a 110 crediti con il modello mini, da 15 a 250 con pro.

Cosa fa: ricerca web, di notizie e finanziaria con fonti ordinate per rilevanza e una breve risposta opzionale, limitata per data o ai domini che scegli tu; il contenuto di un massimo di 20 pagine come markdown pulito, o solo i passaggi che rispondono a una domanda; l'elenco delle pagine di un sito (mappa), oppure mappa ed estrazione in un colpo solo (crawl); e report di ricerca che l'agente di ricerca di Tavily scrive a partire da molte ricerche, e che richiedono da circa 30 secondi a qualche minuto.

Limite di tempo: una chiamata attraverso il connettore si interrompe dopo 30 secondi, quindi crawl e mappe usano limiti bassi per impostazione predefinita. La ricerca approfondita gira in background: l'AI la avvia e ricontrolla finché il report non è pronto.

Contenuti non attendibili: risultati di ricerca e pagine arrivano dal web aperto. L'AI tratta le istruzioni che vi trova come dati, non come ordini.

Errori comuni: 401 significa che la chiave è errata, revocata o mancante. 432: la chiave o il piano ha esaurito i crediti; passa a un piano superiore o alza il limite della chiave nella dashboard di Tavily. 433: è stato raggiunto il limite pay-as-you-go dell'account; alzalo nella dashboard. 429: troppe richieste in poco tempo. 400 o 422: un parametro non è valido, per esempio una data non scritta come YYYY-MM-DD.

Il connettore non trasmette in streaming i report di ricerca, non legge i log delle richieste e non gestisce l'utilizzo e le chiavi dell'organizzazione.

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

Tool disponibili

Esempi di prompt

• "Cerca le notizie dell'ultima settimana sull'applicazione dell'AI Act europeo e fammi un breve riassunto con le fonti."
• "Leggi queste tre pagine prezzi e metti i piani a confronto in una tabella."
• "Mappa la sezione documentazione del nostro sito ed elenca tutte le pagine sull'autenticazione."
• "Prepara un report di ricerca sugli incentivi per le pompe di calore in Germania nel 2026 e dimmi quanti crediti ha usato."

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