Model Context Protocol
Sviluppo server MCP per Claude, ChatGPT e altri assistenti AI
Un server MCP permette ad assistenti AI come Claude e ChatGPT di leggere e scrivere nel vostro prodotto per conto di un utente autenticato. Progettiamo gli strumenti, l'accesso e i permessi, e lo pubblichiamo come server remoto che gli utenti collegano con un solo URL.
Perché le aziende lo chiedono
- I vostri clienti lavorano già in Claude o ChatGPT e chiedono perché il vostro prodotto non ci sia.
- Le persone copiano i dati dalla vostra app in una chat e poi riportano la risposta a mano.
- Avete un'API, ma è pensata per sviluppatori, non per un assistente che deve scegliere la chiamata giusta.
- Volete dare all'AI accesso ai dati, ma non a un assistente che possa cancellare record o vedere i dati di altri clienti.
- Oggi per collegarsi servono chiavi API e file di configurazione, e quasi nessuno lo fa.
Cosa realizziamo
Progettazione degli strumenti
Un insieme mirato di strumenti, con nomi e descrizioni che aiutano l'assistente a scegliere quello giusto e input tipizzati controllati sul server. In The Quiz Master uno strumento guida spiega com'è fatto un buon quiz prima che l'assistente scriva qualcosa.
Accesso con OAuth
L'utente aggiunge l'URL del server ed entra con il suo account abituale. The Quiz Master ha un proprio server OAuth 2.1 con registrazione dinamica del client e PKCE, quindi nessuno deve gestire chiavi API.
Strumenti di lettura e di scrittura
Gli strumenti che leggono restano separati da quelli che modificano i dati, e le azioni distruttive restano fuori se non servono davvero. The Quiz Master non ha strumenti di cancellazione, e il server MCP di Bekki in Bettermile è in sola lettura.
Permessi per ogni utente
Ogni chiamata gira come l'utente autenticato e tocca solo ciò che quell'utente può vedere o modificare. I dati personali si possono filtrare prima che arrivino al modello.
Server remoti via HTTP
Server ospitati via HTTP che funzionano dagli assistenti AI web e desktop, non solo come script locale sul portatile di uno sviluppatore.
File e media
Strumenti che portano file nel vostro prodotto in modo sicuro. In The Quiz Master, import_media copia immagini, audio e video nello storage dell'app, con un limite di dimensione e i file SVG rifiutati.
Come lavoriamo
01
Cosa deve fare l'assistente
Elenchiamo le attività che un utente chiederebbe all'assistente nel vostro prodotto e decidiamo quali richiedono lettura e quali scrittura.
02
Progetto degli strumenti
Scriviamo nomi, input e descrizioni degli strumenti e li proviamo con richieste reali prima di sviluppare l'insieme completo.
03
Accesso e permessi
Aggiungiamo l'accesso OAuth e verifichiamo che ogni chiamata sia limitata all'utente autenticato e al suo ruolo.
04
Test negli assistenti e pubblicazione
Proviamo il server in Claude e negli altri client che usano i vostri utenti, lo mettiamo online e scriviamo una pagina che spiega come collegarlo.
Server MCP in produzione
The Quiz Master ha un server MCP remoto con 17 strumenti, così gli assistenti scrivono i quiz direttamente nella libreria del presentatore. In Bettermile, parte del gruppo GLS, il nostro fondatore è il principale sviluppatore di un server MCP in sola lettura che permette a Claude di interrogare i dati del Back Office con i permessi di ciascun utente.
Domande frequenti sui server MCP
Cos'è un server MCP?
MCP, Model Context Protocol, è uno standard aperto per collegare gli assistenti AI ad altri software. Un server MCP offre una serie di strumenti, come cercare in un elenco o creare un record, che l'assistente può usare per conto dell'utente. È il modo per rendere il vostro prodotto utilizzabile da dentro Claude, ChatGPT e altri assistenti.
Funziona anche con ChatGPT, oltre che con Claude?
Sì, entrambi supportano i server MCP remoti, come un numero crescente di altri assistenti e strumenti per sviluppatori. Configurazione e funzioni supportate cambiano un po' da un client all'altro, per questo proviamo il server in quelli che i vostri utenti usano davvero.
I miei utenti devono creare una chiave API?
No, se il server usa OAuth. L'utente incolla l'URL del server nel suo assistente, entra con il suo account abituale e autorizza l'accesso. The Quiz Master funziona così.
L'AI può cancellare o modificare i nostri dati?
Solo se le date uno strumento che lo fa. Teniamo separati gli strumenti di lettura e di scrittura, lasciamo fuori le azioni distruttive come impostazione predefinita e limitiamo ogni chiamata a ciò che l'utente autenticato può fare. Un server può anche essere del tutto in sola lettura, come quello in Bettermile.
Dobbiamo rifare il nostro backend?
No. Di solito il server MCP sta accanto alla vostra API o al database esistente e li richiama, come piccolo servizio separato o come parte del backend. Li sviluppiamo in TypeScript con l'SDK MCP, e il nostro fondatore ne ha sviluppato uno in Kotlin con Spring AI in Bettermile.