Un agent host può aver bisogno di una connessione configurabile. Uno sviluppatore può aver bisogno di una libreria da importare nel codice. Queste esigenze portano a superfici di integrazione diverse.
Cosa fornisce ciascuno al proprio chiamante?
Un server MCP fornisce un'interfaccia di protocollo; un SDK fornisce funzioni e tipi per un linguaggio di programmazione.
La guida all'architettura MCP descrive server che espongono funzionalità ai client connessi. Un server può essere eseguito come processo locale o fornire un endpoint remoto.
| Interfaccia | Chiamante | Cosa usa il chiamante | Responsabilità di runtime |
|---|---|---|---|
| Server MCP | Un client MCP in un agent host o applicazione | Richieste di protocollo e funzionalità scoperte | Qualcuno esegue il processo server o il servizio remoto |
| API SDK | Codice applicativo | Metodi di libreria che chiamano un API | L'applicazione esegue la libreria e ne gestisce l'integrazione |
| MCP SDK | Codice che implementa un client o server MCP | Tipi di protocollo e helper di implementazione | L'applicazione esegue comunque il client o server risultante |
Un pacchetto SDK non diventa un server in esecuzione solo perché lo installi.
Un server può usare un SDK?
Sì. Uno sviluppatore può usare un SDK di protocollo per implementare un server MCP, e poi usare un'altra libreria client nei suoi handler.
La documentazione MCP SDK descrive librerie per costruire client e server. Qui SDK identifica codice usato per implementare il protocollo.
Un API SDK ha un obiettivo diverso: chiama l'API di un servizio. Un ipotetico server ordini potrebbe esporre un tool per lo stato dell'ordine il cui handler usa un API SDK per recuperare l'ordine.
L'interfaccia MCP esterna e la chiamata API interna hanno contratti separati. Supportare un'operazione API non la espone automaticamente come tool MCP.
Quali responsabilità restano nella mia applicazione?
La tua applicazione decide comunque quali operazioni richiedere. Decide anche come gestirne i risultati.
Con un API SDK, il tuo codice seleziona un metodo e ne fornisce gli argomenti. Con MCP, l'host instrada le richieste attraverso un client verso le funzionalità esposte dal server.
L'architettura MCP lascia l'uso del contesto del modello da parte dell'host fuori dall'ambito del protocollo. Una connessione tool non decide le tue regole di business, la policy di autorizzazione o i criteri di completamento.
Per la ricerca di un ordine, ricevere lo stato richiesto può concludere il task. Per l'invio di un messaggio, la sottomissione e la consegna successiva sono esiti separati.
Come scelgo un'integrazione Bird?
Puoi connettere un agent host compatibile al server MCP di Bird, oppure integrare il codice applicativo tramite un client API.
Per la via della libreria, la decisione Bird SDK copre la scelta tra un SDK e l'HTTP diretto. Per la via dei tool, l'inventario Bird del tuo client fornisce i nomi dei tool disponibili e i relativi schemi di input.
Confronta l'operazione di cui hai bisogno con l'interfaccia che intendi usare. La presenza di un'operazione in un'interfaccia non ne garantisce la presenza in un'altra.
- Usa la connessione MCP quando il tuo host deve scoprire e invocare i tool Bird.
- Usa un client API quando il tuo codice applicativo seleziona e invoca le operazioni del servizio.
- Usa un MCP SDK quando stai implementando il client o il server del protocollo stesso.