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. Questa funzione è attualmente in beta.
Creazione di server MCP remoti
Per iniziare con i server remoti, consulta le seguenti risorse:
La specifica di autenticazione, in particolare i dettagli sul flusso di autenticazione per servizi di terze parti.
Gli esempi di server remoti negli SDK TypeScript e Python.
Le implementazioni di autenticazione client e server negli SDK TypeScript e Python.
La roadmap ufficiale di MCP e il changelog della specifica in bozza per i dettagli su come il protocollo evolverà.
Altre risorse (come questa) possono essere utili per imparare le considerazioni quando si creano, distribuiscono e risolvono i problemi dei server remoti.
Inoltre, alcune soluzioni come Cloudflare forniscono hosting di server MCP remoti con scalabilità automatica integrata, gestione dei token OAuth e distribuzione.
Supporto MCP
Piattaforme
I server MCP remoti sono supportati su Claude e Claude Desktop per i piani Pro, Max, Team ed Enterprise.
Per configurare i server MCP remoti da utilizzare in Claude Desktop, aggiungili tramite Personalizza > Connettori. Claude Desktop non si collegherà ai server remoti configurati direttamente tramite
claude_desktop_config.json.
A partire da luglio, Claude per iOS e Android supportano anche i server MCP remoti!
Gli utenti possono utilizzare strumenti, prompt e risorse dai server remoti che hanno già aggiunto tramite claude.ai. Gli utenti non possono aggiungere nuovi server direttamente da Claude Mobile.
Raggiungibilità della rete
Tutte le connessioni MCP remote hanno origine dall'infrastruttura cloud di Anthropic, indipendentemente dal client Claude che l'utente sta utilizzando. Il tuo server deve accettare connessioni HTTPS in entrata dagli intervalli IP di Anthropic—consulta Indirizzi IP di Anthropic per l'elenco attuale.
Questo vale anche quando gli utenti eseguono Cowork o Claude Desktop localmente. I connettori remoti aggiunti tramite Personalizza > Connettori sono gestiti lato server, quindi la richiesta al tuo server MCP proviene da Anthropic, non dalla macchina dell'utente.
Se il tuo server viene eseguito all'interno di una rete privata, configura il firewall o l'ingresso per consentire il traffico in entrata dagli intervalli IP pubblicati di Anthropic. I server raggiungibili solo tramite VPN o dietro un firewall che blocca gli IP di uscita di Anthropic non riusciranno a connettersi.
Trasporto e autenticazione
Claude supporta sia server remoti basati su SSE che su HTTP Streamable, anche se il supporto per SSE potrebbe essere deprecato nei prossimi mesi.
Claude supporta sia server remoti senza autenticazione che basati su OAuth.
Supporto dell'autenticazione
Claude supporta la specifica di autenticazione 3/26 e (a partire da luglio) la specifica di autenticazione 6/18.
Claude supporta la Registrazione Dinamica del Client (DCR).
I server OAuth possono segnalare a Claude che un client DCR è stato eliminato e che Claude dovrebbe registrare nuovamente il client restituendo un HTTP 401 con un errore di invalid_client dall'endpoint del token, come descritto in RFC 6749.
A partire da luglio, gli utenti possono anche specificare un ID client e un segreto client personalizzati quando si configura un server che non supporta DCR.
L'URL di callback OAuth di Claude è https://claude.ai/api/mcp/auth_callback e il suo nome client OAuth è Claude.
Questo URL di callback potrebbe cambiare in https://claude.com/api/mcp/auth_callback in futuro – se scegli di inserire in whitelist gli URL di callback del client MCP, inserisci in whitelist anche questo URL di callback per assicurarti che il tuo server continui a funzionare con Claude.
Claude supporta la scadenza e l'aggiornamento dei token – i server dovrebbero supportare questa funzionalità per fornire la migliore esperienza agli utenti.
Consulta qui per gli indirizzi IP utilizzati da Claude per le connessioni in entrata e in uscita ai server MCP. Gli sviluppatori di server che desiderano disabilitare client MCP non Claude possono inserire in whitelist questi indirizzi IP, l'URL di callback OAuth di Claude e/o il nome client OAuth di Claude.
Funzionalità del protocollo
Claude supporta strumenti, prompt e risorse.
Claude supporta risultati di strumenti basati su testo e immagini.
Claude supporta risorse basate su testo e binarie.
Claude non supporta ancora sottoscrizioni di risorse, campionamento e altre funzionalità più avanzate o in bozza.
Test dei server MCP remoti
Il modo migliore per testare e convalidare un server è provare ad aggiungerlo a Claude.
In alternativa, utilizza lo strumento inspector. Questo ti permetterà di convalidare:
che il tuo server avvii e completi correttamente il flusso di autenticazione.
che il tuo server implementi correttamente varie parti del flusso di autenticazione.
quali strumenti, prompt, risorse e altre funzionalità MCP espone il tuo server.
Consulta la documentazione MCP per ulteriori dettagli sull'utilizzo di inspector e per altri suggerimenti su come eseguire il debug e risolvere i problemi del tuo server.
Inoltre, altre soluzioni come Cloudflare's AI Playground ti permettono di testare la funzionalità del server MCP remoto.