Aggiunta di connettori remoti personalizzati

I connettori remoti personalizzati ti consentono di estendere Perplexity collegandolo ad altre sorgenti di dati e strumenti oltre ai connettori integrati (di prima parte). Con il Model Context Protocol (MCP), puoi integrare Perplexity con praticamente qualsiasi servizio compatibile, sia che venga eseguito in locale sul tuo computer sia su un server remoto.

Aggiunta di connettori remoti personalizzati

I membri dell’organizzazione possono aggiungere connettori remoti personalizzati se gli amministratori li abilitano per l’organizzazione.

Il modo in cui aggiungi un connettore remoto dipende dal fatto che un amministratore lo aggiunga per l’intera organizzazione oppure che un utente (inclusi gli amministratori) lo aggiunga per il proprio account.

In entrambi i casi, i passaggi sono in gran parte gli stessi. La differenza principale è che solo gli amministratori possono condividere i connettori con l’intera organizzazione.

Come aggiungere un connettore remoto

Vai alla pagina delle impostazioni corretta:
- Per il tuo account: Impostazioni account → Connettori
- Per l’organizzazione (solo amministratori): Impostazioni Enterprise → Autorizzazioni → Autorizzazioni connettori
Fai clic su + Connettore personalizzato nell’angolo in alto a destra.
Nel popup modale, seleziona Remoto.
Compila i campi richiesti:
- Nome — Un nome visualizzato per il tuo connettore (ad es. "Acme CRM").
- URL del server MCP — L’URL del server MCP remoto (ad es., https://myapp.com/sse). È richiesto HTTPS.
Facoltativamente, compila questi campi aggiuntivi:
- Descrizione — Una breve spiegazione di cosa fa il connettore.
- Autenticazione — Scegli tra OAuth, API Key, oppure Nessuna (vedi la sezione Autenticazione qui sotto).
- Trasporto — Scegli tra Streamable HTTP o SSE.
- Icona — Scegli un’icona per il connettore. Nota: La dimensione massima dell’immagine è 128 KB.
Seleziona la casella di conferma per attestare che comprendi i rischi dei connettori personalizzati.
Fai clic su Aggiungi. Il connettore apparirà nella schermata Connettori nelle Impostazioni account.
Fai clic sulla scheda del connettore per avviare il flusso di autenticazione e abilitarlo. Per modificare o rimuovere il connettore in seguito, fai clic sui puntini di sospensione (⋮) e scegli l’opzione appropriata.

I connettori condivisi a livello di organizzazione aggiunti dagli amministratori potrebbero non apparire subito agli altri membri dell’organizzazione.

Chi crea il connettore deve condividerlo con l’organizzazione dalla schermata Autorizzazioni nella Impostazioni Enterprise prima che altri possano accedervi.

Opzioni di autenticazione

I connettori remoti personalizzati supportano tre metodi di autenticazione:

Nessuna — Nessuna autenticazione richiesta. Il server MCP è accessibile senza credenziali.
API Key — Autenticati usando una API Key statica fornita durante la configurazione.
OAuth 2.0 — Autenticati usando il protocollo OAuth 2.0. Potrebbe essere necessario fornire un Client ID e Client Secret se il server MCP non supporta la registrazione dinamica del client. Se il server supporta il discovery OAuth (tramite /.well-known/oauth-authorization-server), endpoint e scope possono essere rilevati automaticamente.

Per i connettori con ambito organizzazione che usano OAuth, un amministratore può autenticarsi una sola volta per conto dell’intera organizzazione oppure richiedere a ogni membro di autenticarsi individualmente.

URL di reindirizzamento OAuth del connettore personalizzato

Quando crei un’app OAuth in un sistema esterno per un connettore personalizzato, il percorso di callback/reindirizzamento è sempre /rest/connections/oauth_callback.

L’URL di reindirizzamento da registrare è: https://www.perplexity.ai/rest/connections/oauth_callback

Per le organizzazioni nel sottodominio Enterprise, usa: https://enterprise.perplexity.ai/rest/connections/oauth_callback

Cloudflare Access (Accesso di rete)

Se il tuo server MCP remoto si trova dietro Cloudflare Access, puoi autenticare Perplexity verso il tuo edge zero trust prima che venga eseguita qualsiasi autenticazione a livello applicativo. Questo si configura tramite il nuovo Accesso di rete menu a tendina nella + Connettore personalizzato modulo.

Finestra modale Aggiungi connettore personalizzato con Accesso di rete impostato su Cloudflare Access, che mostra i campi CF-Access-Client-Id e CF-Access-Client-Secret

Cosa possono fare gli amministratori

Aggiungi un server MCP remoto dietro Cloudflare Access selezionando Cloudflare Access nel nuovo Accesso di rete menu a tendina nella + Connettore personalizzato modulo.
Incolla i loro CF-Access-Client-Id e CF-Access-Client-Secret (entrambi obbligatori) — Perplexity inserisce questi header in ogni richiesta, inclusa la richiesta di verifica in fase di creazione e ogni chiamata degli strumenti in fase di esecuzione, quindi un token chiaramente errato fallisce in verifica invece di farlo silenziosamente in un secondo momento. Consulta le note di risoluzione dei problemi qui sotto per i casi in cui la verifica riesce ma le chiamate in runtime restituiscono 403.
Combinalo con l’autenticazione normale a livello applicativo (OAuth, API Key, oppure Nessuna) — ad esempio, il pilot di PayPal usa insieme gli header di Cloudflare Access e OAuth.
I valori degli header vengono archiviati in forma crittografata e oscurati nell’interfaccia, seguendo lo stesso percorso di gestione degli altri segreti del connettore.
I nomi degli header non sono sensibili alle maiuscole, ma le chiavi devono essere esatte: CF-Access-Client-Id e CF-Access-Client-Secret.

Configurazione lato Cloudflare

Cloudflare Access richiede una configurazione una tantum nella dashboard di Cloudflare Zero Trust prima che Perplexity possa connettersi.

Crea un token di servizio. Nella tua dashboard di Cloudflare Zero Trust, vai su Access → Service Auth → Service Tokens e crea un nuovo token. Copia il Client ID e Client Secret subito — il secret viene mostrato una sola volta.
Crea un’applicazione Access per l’hostname del tuo server MCP. Usa il tipo di applicazione Self-hosted e impostala sull’hostname pubblico che Perplexity chiamerà.
Aggiungi una policy con Action = Service Auth. Nella policy dell’applicazione, imposta Action su Service Auth (non Allow) e includi il token di servizio che hai creato al punto 1.

Errore di configurazione comune: Scegliere Allow anziché Service Auth fa sì che Cloudflare si aspetti un accesso interattivo dal browser e rifiuti le richieste non browser, quindi la verifica di Perplexity fallirà. Service Auth è l’azione corretta per l’accesso machine-to-machine tramite token di servizio.

Suggerimento: Se il connettore viene salvato correttamente, la richiesta di verifica si è autenticata tramite Cloudflare Access — il percorso di autenticazione funziona end-to-end.

Risoluzione dei problemi: la verifica o le chiamate degli strumenti restituiscono 403

Se il connettore non supera la verifica, oppure la verifica riesce ma le chiamate degli strumenti restituiscono 403 in fase di esecuzione, procedi in quest’ordine:

Token incompleto o scaduto. Incolla di nuovo per intero il Client ID e Client Secret — il campo del secret è lungo e può essere facile perdere parti durante l’incolla. Anche i token di servizio hanno una scadenza (predefinita: 1 anno); reimposta il token se è scaduto.
Azione della policy errata. La policy di Access deve usare Service Auth, non Allow o Bypass. Vedi i passaggi di configurazione sopra.
Ritardo di propagazione. Le applicazioni, le policy e i token di servizio di Access appena creati impiegano alcuni minuti per propagarsi attraverso l’edge di Cloudflare. Se la verifica fallisce subito dopo la configurazione, attendi qualche minuto e riprova prima di presumere che ci sia un errore di configurazione.
Sfida WAF o Bot Management. Perplexity si connette da intervalli di IP dei data center. Se la tua zona Cloudflare sottopone il traffico automatizzato a una sfida, l’endpoint MCP potrebbe ricevere una Managed Challenge che un client macchina non può risolvere — questo si presenta come un 403. Aggiungi un’eccezione WAF skip o Bot Management per l’hostname MCP. È sicuro perché Cloudflare Access continua a proteggere l’endpoint tramite il token di servizio.

Se tutto quanto sopra è corretto e il connettore continua a non funzionare, è probabile che il problema sia a livello applicativo (nel server MCP stesso), non in Cloudflare Access.

Condivisione e autorizzazioni

I connettori personalizzati possono avere due ambiti:

Individuale — Il connettore è privato per l’utente che lo ha creato. Solo quell’utente può vederlo e usarlo.
Organizzazione — Il connettore è condiviso con tutti i membri dell’organizzazione (solo connettori remoti). Solo gli amministratori possono condividere i connettori a livello di organizzazione.

Controlli amministratore

Gli amministratori dell’organizzazione hanno funzionalità di gestione aggiuntive:

Consenti ai membri di aggiungere connettori — Usa questo interruttore per controllare se i membri non amministratori possono aggiungere i propri connettori remoti personalizzati. È disattivato per impostazione predefinita.
Aggiungi connettori remoti a livello di organizzazione — Aggiungi connettori remoti condivisi con l’intera organizzazione.

Queste impostazioni sono accessibili da Impostazioni Enterprise → Connettori nella sezione Autorizzazioni connettori .

Considerazioni sulla sicurezza

I connettori personalizzati introducono rischi aggiuntivi perché Perplexity non può verificare i server MCP di terze parti né garantire la qualità delle risposte. Tieni presente quanto segue:

Usa solo connettori provenienti da fonti di cui ti fidi. Perplexity non è responsabile dei problemi causati dai connettori personalizzati.
Gli URL dei server MCP remoti devono usare HTTPS.
Gli utenti possono modificare o eliminare solo i propri connettori. Gli amministratori possono gestire i connettori a livello di organizzazione.
Se la convalida del server fallisce durante la configurazione, il connettore mostrerà un’etichetta di errore con un messaggio che ti invita a riconfigurarlo.
Gli amministratori dovrebbero rivedere i connettori aggiunti dai membri e limitare o rimuovere quelli che rappresentano un rischio per la sicurezza.