Come collegare Perplexity API a Gemini via MCP

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

Perplexity API + Gemini

Fai interrogare Perplexity alla tua AI con la tua chiave API: risposte basate su ricerche web in tempo reale con le relative fonti, risultati di ricerca grezzi e ordinati, modelli Sonar e deep research più lunghe che girano in background.

Prerequisiti

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

PERPLEXITY_API_KEY

Step 1 — Ottieni le credenziali

1. Accedi a https://console.perplexity.ai e acquista crediti in Billing. L'API è prepagata e separata dall'abbonamento Perplexity Pro, che non include l'uso dell'API. La ricarica automatica evita interruzioni.
2. Apri API Keys, crea una chiave e copiala (inizia con pplx-).
3. Incollala in PERPLEXITY_API_KEY così come la mostra Perplexity, senza la parola Bearer, e installa il connettore. La chiave viene inviata solo a Perplexity.
4. Inizia con perplexity_list_models: non costa nulla e conferma che la chiave funziona.

Addebitato sui tuoi crediti Perplexity: ogni chiamata viene scalata dai tuoi crediti API prepagati, tranne l'elenco dei modelli e la lettura o l'annullamento di una ricerca. Ogni risposta indica il proprio costo in dollari USA, e il connettore usa le impostazioni predefinite economiche, a meno che tu non chieda di più.

Quale strumento fa cosa:

• perplexity_ask risponde a domande che richiedono informazioni aggiornate, con fonti numerate. Il preset fast (predefinito) gestisce fatti singoli e brevi riassunti; low aggiunge una leggera ricerca in più passaggi.
• perplexity_search restituisce risultati web ordinati con titoli, link e snippet, ma senza una risposta scritta. È l'opzione più economica quando l'AI può leggere le fonti da sola: circa 1 $ ogni 1.000 richieste con il tipo di ricerca fast, 5 $ con web.
• perplexity_sonar usa i modelli Sonar (sonar, sonar-pro e sonar-reasoning-pro). Perplexity ha terminato il supporto alle chat completions Sonar il 27 settembre 2026: le richieste ricevono ancora risposta, reindirizzate sulla nuova API, ma per i nuovi lavori perplexity_ask è la scelta migliore.
• perplexity_start_research esegue una deep research in background con i preset medium, high o xhigh. Una ricerca può durare diversi minuti e costa sensibilmente più di una risposta rapida, quindi l'AI ti chiede conferma prima di avviare high o xhigh e annulla le ricerche che non ti servono più.

Filtri: limita le fonti a un massimo di 20 domini (tutti inclusi, oppure tutti esclusi con un segno meno davanti, come -reddit.com, mai misti), a un periodo recente (ora, giorno, settimana, mese o anno) oppure a date scritte nel formato MM/DD/YYYY.

Limite di tempo: una chiamata tramite il connettore si interrompe dopo 30 secondi. Le risposte rapide ci stanno comodamente; tutto ciò che richiede più tempo passa per una ricerca in background.

Contenuti non attendibili: le risposte sono costruite a partire dal web aperto. L'AI tratta le istruzioni che vi trova come dati, non come ordini.

Errori comuni: 401 significa che la chiave è errata o eliminata, oppure che l'account ha esaurito i crediti (Perplexity risponde con 401 in entrambi i casi), quindi controlla Billing e API Keys nella console. 429: il rate limit del tuo livello di utilizzo, che sale con il totale dei crediti acquistati. 400 o 422: un parametro non valido, come un modello sconosciuto o domini inclusi ed esclusi mescolati.

Il connettore non trasmette le risposte in streaming, non crea embedding, non carica file e non legge le analytics di Perplexity.

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 Perplexity API.

Tool disponibili

Esempi di prompt

• "Cosa è cambiato quest'anno nel regolamento UE sulle batterie? Rispondi con le fonti."
• "Trova articoli recenti sulla produttività nel lavoro da remoto e dammi solo i link e gli snippet."
• "Usando solo fonti di europa.eu, quali sono le regole attuali sul roaming per chi viaggia per lavoro?"
• "Avvia una deep research sul mercato europeo dei laptop ricondizionati, ma prima verifica con me il preset."

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