Vai al contenuto principale

Creazione di Connettori Personalizzati tramite Server MCP Remoti

Aggiornato questa settimana

I connettori personalizzati che utilizzano MCP remoto sono disponibili su Claude e Claude Desktop per gli utenti con piani Pro, Max, Team ed Enterprise.

Creazione di server MCP remoti

Per iniziare con i server remoti, consulta le seguenti risorse:

Altre risorse (come questa) possono essere utili per imparare considerazioni sulla creazione, distribuzione e risoluzione dei 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 Impostazioni > 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.

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 durante la configurazione di un server che non supporta DCR.

  • L'URL di callback OAuth di Claude è https://claude.ai/api/mcp/auth_callback e il nome del 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 anche questo URL di callback in whitelist per assicurare 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 i client MCP non Claude possono inserire in whitelist questi indirizzi IP, l'URL di callback OAuth di Claude e/o il nome del 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 le sottoscrizioni di risorse, il 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:

Hai ricevuto la risposta alla tua domanda?