Un server può dover offrire un'azione, fornire dati di contesto o richiedere informazioni all'utente. MCP assegna a queste interazioni interfacce diverse.
Nella revisione della specifica 2026-07-28, sampling e roots sono deprecati. Restano disponibili durante il periodo di deprecazione, ma le nuove implementazioni non dovrebbero adottarli.
Cosa fa ciascuna primitiva?
I tool espongono azioni, le resource espongono dati e i prompt espongono template di messaggi riutilizzabili. L'elicitation ottiene input aggiuntivo dall'utente.
La guida all'architettura MCP separa le funzionalità fornite dal server dall'input che un client può fornire.
| Primitiva | Scopo | Esempio |
|---|---|---|
| Tool | Permettono al client di invocare una funzione | Inviare un messaggio |
| Resource | Forniscono contesto a un indirizzo risorsa | Recuperare un documento |
| Prompt | Forniscono template di messaggi riutilizzabili | Preparare una richiesta strutturata per l'analisi |
| Elicitation | Chiedono all'utente informazioni necessarie per un'operazione | Richiedere una scelta mancante |
| Sampling, deprecato | Richiede la generazione del modello tramite il client | Chiedere a un client di generare testo |
| Roots, deprecato | Descrive posizioni nel filesystem rilevanti per il server | Identificare una directory di progetto |
Un server implementa le interfacce necessarie alla propria integrazione. Il client deve supportare le funzionalità che utilizza.
In che modo tool, resource e prompt differiscono nella pratica?
Scegli in base a se il client deve eseguire un'operazione, recuperare contesto o ottenere un prompt riutilizzabile.
Un ipotetico server di pianificazione potrebbe esporre un tool per prenotare appuntamenti. Una resource potrebbe fornire le informazioni sulla sede. Un prompt potrebbe preparare i messaggi usati per confrontare le opzioni di appuntamento.
Il client scopre le funzionalità del server disponibili. Scoprire un tool di prenotazione non concede il permesso di prenotare. Il servizio autorizza comunque l'operazione.
Una resource fornisce contenuto senza stabilire che il modello debba seguire istruzioni incorporate in esso. L'host controlla di quali contenuti e azioni del server si fida.
Cosa cambia per sampling e roots?
Per roots, il changelog raccomanda di passare file o directory tramite parametri dei tool, indirizzi di resource o configurazione del server. Per sampling, raccomanda l'integrazione diretta con le API dei fornitori di modelli.
Deprecazione non significa che una funzionalità sia già stata rimossa. Le integrazioni esistenti possono ancora incontrare queste interfacce durante la transizione.
Come fa un server a richiedere ulteriore input?
Un server restituisce un risultato che richiede input, e il client fornisce le informazioni richieste quando riprova l'operazione originale.
La revisione 2026-07-28 chiama questo pattern Multi Round-Trip Requests. Cambia il modo in cui vengono consegnate le richieste di elicitation, sampling e roots. La guida all'architettura indica ancora elicitation/create come metodo per richiedere input all'utente.
Quali primitive uso con Bird?
Puoi usare i tool MCP di Bird per inviare messaggi e consultare i risultati registrati.
Per l'email, email_send avvia l'operazione e email_get recupera il messaggio con il suo stato di consegna aggregato. I risultati per destinatario richiedono i dettagli del destinatario corrispondente. La risposta sullo stato di consegna spiega perché la sola accettazione non può stabilire la consegna.
L'inventario dei tool del tuo client fornisce i nomi e gli schema di input per la connessione in uso. Un tool elencato potrebbe comunque richiedere permessi che la tua autorizzazione non include.
Per istruzioni che collegano più operazioni in un task, le agent skill di Bird forniscono procedure CLI. Una procedura pacchettizzata e un prompt MCP sono interfacce separate; la presenza dell'una non implica la disponibilità dell'altra.