Perplexity API su MCP: risposte basate sul web in qualsiasi agente AI

💡 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

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.

Setup

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.

Prerequisiti: PERPLEXITY_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 Perplexity API e inserisci le variabili elencate nei Prerequisiti.

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

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT