Un agente che utilizza gli strumenti MCP
MCP fornisce funzionalità con contratti espliciti.
Cosa imparerai
- Spiegare: il modello propone, lo strumento esegue
- Applica l'idea in un esempio: un agente che utilizza gli strumenti MCP
- Riconoscere i limiti e verificare il risultato dell'esercizio
MCP fornisce funzionalità con contratti espliciti. Seleziona solo gli strumenti necessari per l'attività.
Questi passaggi si riferiscono alle funzionalità identificate nel codice dell'applicazione. Questo materiale non è stato convalidato su un'istanza live; controlla la documentazione e le opzioni nella tua versione.
Come funziona, passo dopo passo
Il modello propone, lo strumento esegue
La chiamata allo strumento produce una richiesta di chiamata con un nome e argomenti. L'applicazione convalida lo schema, le autorizzazioni e i limiti prima dell'esecuzione. Il risultato ritorna al contesto per il passaggio successivo. Ad esempio, get_product_stock accetta uno SKU e restituisce una quantità; la sua descrizione dovrebbe spiegare che non effettua prenotazioni di prodotti. Distinguere risultati vuoti, errori di convalida, accessi mancanti e timeout. Un JSON valido non dimostra che gli argomenti siano corretti o che l'azione sia autorizzata. Per gli effetti esterni, considerare anche l'esecuzione duplicata.
Host, client e server
MCP è un protocollo che collega le applicazioni AI a capacità esterne. L'host fornisce l'esperienza, il client gestisce la connessione e il server espone strumenti, risorse o istruzioni in base al supporto. Gli strumenti eseguono operazioni; le risorse forniscono contenuti indirizzabili; i prompt forniscono modelli. Non tutti i server li implementano tutti e tre. Il trasporto trasporta i messaggi, l'autenticazione identifica i chiamanti e l'autorizzazione controlla l'accesso. Controlla la revisione del protocollo e le estensioni supportate su entrambe le estremità. La compatibilità non può essere dedotta solo dall'etichetta "MCP".
Controllare l'accesso prima dell'uso
Le autorizzazioni devono essere applicate dai server e dal livello dati. Non lasciare che sia il modello a decidere se un utente può vedere un documento. Filtra le fonti prima che entrino nel contesto, non dopo aver generato la risposta. Utilizza credenziali di accesso minimo, tienile lontane da prompt, screenshot e codice del browser e ruota le chiavi esposte. Una lista consentita di domini widget non sostituisce l'autenticazione API. L'autenticazione ti identifica; l'autorizzazione determina le operazioni e i dati che puoi utilizzare. Prova anche l'accesso negato.
Lo schema esplicativo
Seguire le frecce continue per il flusso principale. Le frecce blu tratteggiate forniscono dati o contesto; le frecce rosa tratteggiate mostrano feedback o risultati restituiti. Colori e forme distinguono modelli, negozi, decisioni e risultati. Su schermi piccoli, scorri in orizzontale per seguire l’intero schema.
Un esempio completo
Connetti un server dimostrativo, scopri gli strumenti e seleziona get_product_stock per l'agente. Uno SKU mancante comporta un chiarimento anziché un accesso arbitrario a tutti gli ordini.
Provalo tu stesso
- Abilita uno strumento di sola lettura e verifica uno SKU valido, uno SKU mancante e un accesso negato.
- Registrare l'input, la fonte e il risultato atteso prima di eseguire l'esperimento. Utilizzare solo i dati fittizi nell'esempio.
- Seguire le fasi del diagramma. Ad ogni passaggio registrare quali informazioni vengono ricevute e prodotte; non confondere il risultato intermedio con il risultato finale.
- Ripetere dopo aver rimosso le informazioni necessarie o reso ambiguo l'input. Controlla se il sistema chiarisce, ferma o inventa una risposta.
- Confrontare con la soluzione spiegata. Conserva la configurazione, la data, il risultato e una spiegazione delle differenze. Cambia una cosa e riprova.
Una soluzione spiegata
The call reads permitted SKU stock and treats access denial as an error rather than zero stock. Un esercizio riuscito ti consente di mostrare la connessione tra input, fasi e risultato. Quando mancano le informazioni, una risposta cauta è più utile dei dettagli inventati. Confrontare non solo stile: verificare anche condizioni, fonti e operazioni.
Quando è utile e quali sono i suoi limiti
La descrizione di uno strumento non è un controllo di sicurezza. Scegli questo approccio quando migliora un bisogno misurato. Mantieni una linea di base semplice e confronta i risultati utilizzando input identici. Un esempio di successo non stabilisce l’affidabilità in ogni situazione.
Verifica ciò che hai imparato
Chi esegue una chiamata proposta dal modello?
L'applicazione o il servizio host dopo la convalida. Il modello non ottiene automaticamente l'accesso illimitato.
Un server dotato di strumenti offre automaticamente risorse e suggerimenti?
No. Le funzionalità sono facoltative e devono essere scoperte e verificate.
Quale risultato dovrebbe produrre questo esercizio?
La chiamata legge lo stock SKU consentito e tratta il rifiuto di accesso come un errore anziché come zero stock.
Termini da ricordare
- Chiamata dello strumento: una richiesta strutturata per utilizzare una funzionalità esterna.
- server MCP: un servizio che espone funzionalità tramite Model Context Protocol.
- Autorizzare/Autorizzazione: verifica del diritto di accesso a un'operazione o risorsa.
Fonti e il prossimo passo
- LangGraph — flussi di lavoro e agenti
- Model Context Protocol — specifica
- OWASP — Iniezione di prompt
Per preparare: A03 — Un agente connesso alla conoscenza