Vai al contenuto principale

Creazione di Connettori Personalizzati tramite Server MCP Remoti

Aggiornato oltre una settimana fa

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

Costruire Server MCP Remoti

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

Altre risorse (come questa) possono anche essere utili per apprendere le considerazioni durante la costruzione, il deployment e la risoluzione dei problemi dei server remoti.

Inoltre, alcune soluzioni come Cloudflare forniscono hosting di server MCP remoti con autoscaling integrato, gestione dei token OAuth e deployment.

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 per l'uso in Claude Desktop, aggiungili tramite Impostazioni > Connettori. Claude Desktop non si connetterà ai server remoti che sono configurati direttamente tramite claude_desktop_config.json.

  • A partire da luglio, Claude per iOS e Android supporta 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 Autenticazione

  • 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 ri-registrare 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 sono anche in grado di specificare un ID client personalizzato e un client secret quando configurano 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, per favore inserisci in whitelist anche questo URL di callback per assicurarti che il tuo server continui a funzionare con Claude.

  • Claude supporta la scadenza e il refresh dei token – i server dovrebbero supportare questa funzionalità per fornire la migliore esperienza agli utenti.

Vedi 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 non consentire 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 capacità più avanzate o in bozza.

Testare Server MCP Remoti

Il modo migliore per testare e validare un server è provare ad aggiungerlo a Claude.

In alternativa, usa lo strumento inspector. Questo ti permetterà di validare:

Hai ricevuto la risposta alla tua domanda?