Vai al contenuto principale

Iniziare con i connettori personalizzati utilizzando MCP remoto

I connettori personalizzati che utilizzano MCP remoto sono disponibili su Claude, Cowork e Claude Desktop per gli utenti con piani Free, Pro, Max, Ultra, Team ed Enterprise. Gli utenti Free sono limitati a un connettore personalizzato.

Cosa sono i connettori personalizzati?

I connettori personalizzati ti permettono di connettere Claude direttamente agli strumenti e alle fonti di dati più importanti per i tuoi flussi di lavoro. Questo consente a Claude di operare all'interno del tuo software preferito e di trarre informazioni dal contesto completo dei tuoi strumenti esterni.

Puoi:

  • Connettere Claude ai server MCP remoti esistenti.

  • Creare i tuoi server MCP remoti per connetterti con qualsiasi strumento.

Sicurezza e privacy con i connettori personalizzati

I connettori personalizzati ti permettono di connettere Claude a servizi che non sono stati verificati da Anthropic. Una volta connesso, Claude può accedere a questi servizi e intraprendere azioni in essi. Per ulteriori indicazioni, consulta la sezione Considerazioni sulla sicurezza e la privacy di seguito.

Cosa sono i server MCP remoti?

Il Model Context Protocol (MCP) è uno standard aperto, creato da Anthropic, per le applicazioni di intelligenza artificiale per connettersi a strumenti e dati.

In precedenza, i server MCP venivano eseguiti solo localmente (cioè sul laptop di un utente). Ora, gli sviluppatori possono creare e ospitare server MCP remoti che comunicano con le app di intelligenza artificiale su Internet.

I server MCP remoti danno ai modelli accesso a strumenti e dati ospitati su Internet, trasformando Claude in un collega informato che può gestire in modo indipendente progetti complessi e multifase personalizzati in base alle tue esigenze.


Requisiti di rete

Quando aggiungi un connettore personalizzato, Claude si connette al tuo server MCP remoto dall'infrastruttura cloud di Anthropic, anziché dal tuo dispositivo locale. Questo è vero per ogni client Claude, inclusi claude.ai, Claude Desktop, Cowork e le app mobili.

Ciò significa che il tuo server MCP deve essere raggiungibile su Internet pubblico dagli intervalli IP di Anthropic. I server ospitati su una rete aziendale privata, dietro una VPN o bloccati da un firewall non si connetteranno, anche se puoi raggiungerli dalla tua macchina. Il tuo server deve anche essere raggiungibile sulla porta HTTPS standard (443). Claude non può connettersi a un URL che specifica un'altra porta (ad esempio, https://example.com:8443/mcp).

Se il tuo server è su una rete privata

Dovrai aggiungere alla whitelist gli indirizzi IP di Anthropic nel tuo firewall in modo che le connessioni in entrata da Claude possano raggiungere il tuo server. Consulta Indirizzi IP di Anthropic per gli intervalli attuali.

Perché questo si applica a Cowork e Claude Desktop

Anche se Cowork e Claude Desktop vengono eseguiti sul tuo computer, i connettori remoti sono configurati e gestiti tramite il tuo account Claude. La connessione al tuo server MCP ha origine dai server di Anthropic, non dall'interfaccia di rete della tua macchina. I server MCP locali configurati in Claude Desktop tramite claude_desktop_config.json sono un meccanismo separato e utilizzano la tua rete locale. Non sono disponibili in claude.ai o nelle sessioni Cowork che vengono eseguite nel cloud; una sessione Cowork in esecuzione localmente sul tuo dispositivo può utilizzarli.


Aggiungi un connettore personalizzato

Nota: Sebbene chiunque possa creare e ospitare connettori utilizzando MCP remoto, solo i Proprietari e i Proprietari Primari possono aggiungerli ai piani Team, e solo i Proprietari, i Proprietari Primari e le persone con un ruolo personalizzato che include l'accesso Gestisci alle Librerie possono aggiungerli ai piani Enterprise. Una volta che un connettore è stato aggiunto a un'organizzazione Team o Enterprise, gli utenti si connettono individualmente e abilitano quel connettore. Ciò garantisce che Claude possa accedere solo a strumenti e dati a cui l'utente individuale ha accesso, a meno che il connettore non utilizzi una credenziale condivisa come una chiave API, che dà a tutti coloro che la utilizzano l'accesso di quella credenziale.

Per i piani Team ed Enterprise

Passaggi preliminari per i proprietari:

Prima che i membri dei piani Team ed Enterprise possano configurare i connettori personalizzati, un Proprietario o un Proprietario Primario deve seguire questi passaggi iniziali per aggiungere un connettore personalizzato alla tua organizzazione:

  1. Fai clic su «Aggiungi.»

  2. Passa il mouse su «Personalizzato,» quindi seleziona «Web.»

  3. Immetti un nome per il connettore. Questo è il nome che gli utenti vedono nell'elenco dei connettori.

  4. Aggiungi l'URL del server MCP remoto del tuo connettore esattamente come documentato dal provider, incluso qualsiasi percorso (ad esempio, https://example.com/mcp). Fai clic su «Continua.»

  5. Rivedi le impostazioni di autenticazione rilevate da Claude e modificale se il tuo server ha bisogno di qualcosa di diverso. Fai clic su «Continua.»

  6. In Autenticazione, scegli come le persone si connettono al server: «Accedi ora,» «Accedi quando necessario,» o «Nessun accesso.»

  7. In Client OAuth, scegli come Claude si identifica al server di autorizzazione del server: «Usa l'identità pubblicata di Claude (Consigliato),» «Registra automaticamente,» o «Usa il tuo client OAuth.» Nota: Non vedrai l'impostazione Client OAuth se hai selezionato «Nessun accesso» in Autenticazione. Scegli «Usa il tuo client OAuth» solo se la documentazione del server dice che richiede un client che registri tu stesso. Immetti sia l'ID client che il Segreto client se il server ha emesso un segreto e registra https://claude.ai/api/mcp/auth_callback come URL di reindirizzamento per quel client.

  8. In Intestazioni richiesta, aggiungi credenziali fisse come chiavi API che Claude invia ad ogni richiesta se il tuo server MCP si autentica con una chiave API, token bearer o altra credenziale fissa invece di OAuth. Scopri come autenticarsi con intestazioni richiesta.

  9. Termina la configurazione del tuo connettore facendo clic su «Aggiungi.»

Passaggi per i membri dopo la configurazione del connettore:

  1. Trova il connettore personalizzato che il tuo Proprietario ha aggiunto nell'elenco. Di solito ha un'etichetta «Personalizzato».

  2. Fai clic su «Connetti» per autenticarti e iniziare a utilizzare il connettore con Claude.

Nota: Se l'URL del tuo connettore personalizzato si trova su un dominio che corrisponde a un'inserzione nella Directory dei connettori (ad esempio, un URL dell'area di lavoro Workato), viene visualizzato con il nome e il branding di quel servizio invece di un'etichetta «Personalizzato». È comunque il tuo connettore. Si connette all'URL esatto che il tuo proprietario ha inserito e utilizza gli strumenti del tuo server, quindi non è necessario rimuoverlo o aggiungerlo di nuovo.

Per i piani Pro e Max

Se stai utilizzando un piano Pro o Max individuale, segui questi passaggi per aggiungere un connettore personalizzato:

  1. Fai clic su «+ Aggiungi» quindi su «Aggiungi connettore personalizzato.»

  2. Immetti un nome per il connettore. Questo è il nome che gli utenti vedono nell'elenco dei connettori.

  3. Aggiungi l'URL del server MCP remoto del tuo connettore esattamente come documentato dal provider, incluso qualsiasi percorso (ad esempio, https://example.com/mcp). Fai clic su «Continua.»

  4. Rivedi le impostazioni di autenticazione rilevate da Claude e modificale se il tuo server ha bisogno di qualcosa di diverso. Fai clic su «Continua.»

  5. In Autenticazione, scegli come le persone si connettono al server: «Accedi ora,» «Accedi quando necessario,» o «Nessun accesso.»

  6. In Client OAuth, scegli come Claude si identifica al server di autorizzazione del server: «Usa l'identità pubblicata di Claude (Consigliato),» «Registra automaticamente,» o «Usa il tuo client OAuth.» Nota: Non vedrai l'impostazione Client OAuth se hai selezionato «Nessun accesso» in Autenticazione. Scegli «Usa il tuo client OAuth» solo se la documentazione del server dice che richiede un client che registri tu stesso. Immetti sia l'ID client che il Segreto client se il server ha emesso un segreto e registra https://claude.ai/api/mcp/auth_callback come URL di reindirizzamento per quel client.

  7. In Intestazioni richiesta, aggiungi credenziali fisse come chiavi API che Claude invia ad ogni richiesta se il tuo server MCP si autentica con una chiave API, token bearer o altra credenziale fissa invece di OAuth. Scopri come autenticarsi con intestazioni richiesta.

  8. Termina la configurazione del tuo connettore facendo clic su «Aggiungi.»

Abilitazione dei connettori dopo la configurazione

Puoi abilitare i connettori per le singole conversazioni tramite il pulsante «+» in basso a sinistra della tua interfaccia di chat, quindi «Connettori.» Vedrai i tuoi connettori configurati con interruttori che ti permettono di abilitarli/disabilitarli per conversazione.


Rimuovi i connettori personalizzati

Puoi rimuovere un connettore personalizzato seguendo questi passaggi:

    1. I Proprietari e i Proprietari Primari di Team ed Enterprise possono farlo per conto della loro organizzazione in Impostazioni organizzazione > Connettori. Nei piani Enterprise, anche le persone con un ruolo personalizzato che include l'accesso Gestisci alle Librerie possono farlo.

  1. Individua la sezione «Connettori».

  2. Fai clic su «Rimuovi» o seleziona i tre punti accanto al connettore che desideri rimuovere.

  3. Segui i prompt per rimuovere.

Se stai cercando di modificare un connettore personalizzato, dovrai prima rimuoverlo e poi aggiungerlo di nuovo utilizzando i dettagli aggiornati.


Crea connettori personalizzati

Per informazioni sulla creazione di connettori da utilizzare con Claude, consulta Creazione di connettori personalizzati in Claude Docs.


Considerazioni sulla sicurezza e la privacy

I connettori personalizzati ti permettono di connettere Claude a servizi arbitrari che non sono stati verificati da Anthropic. Quando connetti Claude a servizi esterni, gli stai concedendo la capacità di accedere e potenzialmente modificare i dati all'interno di questi servizi in base alle tue autorizzazioni. È importante assicurarsi di connettersi solo a server MCP remoti di cui ti fidi e di essere consapevole delle interazioni di Claude con i connettori web.

Sicurezza e autorizzazioni

Quando aggiungi un connettore personalizzato a Claude, di solito passerai attraverso un processo di autenticazione OAuth per accedere in modo sicuro all'applicazione e concedere autorizzazioni specifiche. Ciò consente a Claude di interagire con l'applicazione per tuo conto, senza che Claude veda mai la tua password effettiva.

Alcuni connettori utilizzano una chiave API o un'altra credenziale fissa invece di o in aggiunta a un processo di autenticazione OAuth. I valori vengono archiviati crittografati, come altre credenziali del connettore. Nei piani Team ed Enterprise, tutti coloro che utilizzano il connettore raggiungono il servizio con la stessa credenziale, quindi utilizza una limitata a ciò che i membri dovrebbero accedere.

Puoi revocare queste autorizzazioni in qualsiasi momento disconnettendo il connettore nelle impostazioni di Claude o nelle impostazioni di sicurezza del servizio di terze parti.

I server MCP remoti agiscono come intermediari tra Claude e le applicazioni esterne. Dovresti:

  • Connettersi solo a server affidabili: Connetti Claude solo a server creati e ospitati da organizzazioni e applicazioni di cui ti fidi.

  • Rivedi attentamente le autorizzazioni richieste: Durante l'autenticazione, rivedi quali autorizzazioni il server MCP sta richiedendo all'applicazione. Limita questi ambiti quando possibile e nega l'accesso se le autorizzazioni richieste sembrano non necessarie.

  • Sii consapevole delle iniezioni di prompt: I server MCP dannosi possono includere istruzioni nascoste che cercano di far eseguire a Claude azioni non intenzionali. Claude ha protezioni integrate che tentano di bloccare questi attacchi, ma è importante prestare attenzione agli input e agli output degli strumenti e connettersi solo a server affidabili.

  • Monitora i cambiamenti nel comportamento dello strumento: Gli sviluppatori del server possono aggiornare il comportamento dello strumento in modo inaspettato, portando a comportamenti non intenzionali o dannosi.

Segnalazione di server MCP dannosi

Se vieni a conoscenza di un server MCP dannoso, segnalalo al nostro programma di divulgazione delle vulnerabilità e scegli https://github.com/modelcontextprotocol come Asset.

Intraprendere azioni con gli strumenti

I server MCP remoti danno a Claude strumenti che può invocare durante la tua conversazione. Lo sviluppatore di un server MCP può definire cosa fanno questi strumenti, incluso:

  • Lettura dei dati dalle applicazioni connesse.

  • Creazione, modifica o eliminazione di dati nelle applicazioni connesse.

  • Intraprendere azioni per conto dell'utente.

Claude può accedere solo alle risorse a cui hai dato al server il permesso di accedere, ma dovresti:

  • Essere consapevole di tutte le azioni che Claude sta intraprendendo e che non abbiano effetti distruttivi o non intenzionali.

  • Rivedi attentamente le richieste di approvazione dello strumento di Claude e fai clic su «Consenti sempre» solo quando utilizzi un server e uno strumento di cui ti fidi per l'esecuzione senza supervisione.

  • Utilizzando il menu «Ricerca e strumenti», disabilita gli strumenti che non sono rilevanti per la conversazione attuale o che non desideri che Claude possa invocare.

Connettori interattivi

Alcuni connettori possono visualizzare interfacce interattive direttamente all'interno delle tue conversazioni Claude. Invece di restituire solo risposte basate su testo, questi connettori possono aprire app interattive dal vivo, come dashboard, bacheche di attività o strumenti di progettazione, direttamente nella chat.

I connettori interattivi vengono visualizzati in due modi:

  • Schede inline: Componenti compatti incorporati nella conversazione, che mostrano riepiloghi, conferme o azioni rapide.

  • Visualizzazione a schermo intero: Interfacce immersive per interazioni complesse come visualizzazioni di dati o modifica di documenti. Il compositore di conversazione rimane disponibile in modo da poter continuare a chattare con Claude.

Puoi interagire direttamente con questi connettori, filtrando i dati, spuntando le attività, regolando le impostazioni, senza lasciare la conversazione. Tutte le azioni che intraprendi all'interno dell'interfaccia utilizzano le stesse autorizzazioni che hai concesso quando hai connesso lo strumento.

Controlli amministrativi: I proprietari dei piani Team ed Enterprise possono disabilitare specifiche chiamate di strumenti che rendono i connettori interattivi all'interno di Impostazioni organizzazione > Connettori.

Utilizzo di Claude con Research

Nota: Advanced research attualmente non è in grado di invocare strumenti dai server MCP locali.

Research consente a Claude di indagare profondamente le query cercando in centinaia di fonti interne ed esterne. Durante il processo di ricerca, Claude può invocare strumenti dai tuoi connettori automaticamente senza ulteriore approvazione.

Quando utilizzi la ricerca con connettori personalizzati:

  • Disabilita gli strumenti che possono intraprendere azioni di scrittura nelle applicazioni esterne.

  • Rivedi attentamente la richiesta di approvazione di Claude e sii consapevole di quali strumenti stai concedendo a Claude il permesso di invocare.

  • Sii consapevole dell'impatto di Claude che invia un gran numero di richieste ai tuoi connettori.

Consulta Usa la ricerca su Claude per ulteriori informazioni su questa funzione.

Hai ricevuto la risposta alla tua domanda?