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, 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 connettersi 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 multi-step 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, piuttosto che dal tuo dispositivo locale. Questo è vero su 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.

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, ma non sono disponibili in Cowork o claude.ai.


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 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. 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)", "Registrati automaticamente" o "Usa il tuo client OAuth". Nota: Non vedrai l'impostazione Client OAuth se hai selezionato "Nessun accesso" in Autenticazione.

  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. Finisci di configurare il 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 inserito dal tuo proprietario 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. 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)", "Registrati automaticamente" o "Usa il tuo client OAuth". Nota: Non vedrai l'impostazione Client OAuth se hai selezionato "Nessun accesso" in Autenticazione.

  7. In Request headers, 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 altre credenziali fisse invece di OAuth. Scopri come autenticarti con request headers.

  8. Completa la configurazione del tuo connettore facendo clic su "Aggiungi".

Abilitazione dei connettori dopo la configurazione

Puoi abilitare i connettori per 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 connettori personalizzati

Puoi rimuovere un connettore personalizzato seguendo questi passaggi:

    1. I proprietari di Team e Enterprise possono farlo per conto della loro organizzazione in Impostazioni organizzazione > Connettori.

  1. Individua la sezione "Connettori".

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

  3. Segui le istruzioni 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 saperne di più 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 quei 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, in genere passerai attraverso un processo di autenticazione OAuth per accedere in modo sicuro all'applicazione e concedere autorizzazioni specifiche. Questo 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 altre credenziali fisse invece di o in aggiunta a un processo di autenticazione OAuth. I valori sono archiviati crittografati, come altre credenziali del connettore. Nei piani Team e Enterprise, tutti coloro che utilizzano il connettore raggiungono il servizio con quella 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:

  • Connettiti 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 output degli strumenti e connettersi solo a server affidabili.

  • Monitora i cambiamenti nel comportamento dello strumento: Gli sviluppatori di 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.

Esecuzione di 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.

  • Esecuzione di azioni per conto dell'utente.

Claude può accedere solo alle risorse a cui hai concesso 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 con Claude. Invece di restituire solo risposte basate su testo, questi connettori possono aprire app live e interattive, come dashboard, bacheche di attività o strumenti di progettazione, direttamente nella chat.

I connettori interattivi appaiono 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 al momento della connessione dello strumento.

Controlli amministrativi: I proprietari dei piani Team e 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 da 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 si utilizza la ricerca con connettori personalizzati:

  • Disabilita gli strumenti che possono eseguire 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 Usare la ricerca su Claude per ulteriori informazioni su questa funzione.

Hai ricevuto la risposta alla tua domanda?