MCP consente di collegare un'applicazione IA con strumenti e dati utilizzando un contratto comune. Per capire questo, separa tre domande: chi decide cosa fare, chi trasporta richiesta e chi conduce l'operazione.
Concetti Chiave
Model Context Protocol (MCP) standardizza come le funzionalità esterne vengono trovate e utilizzate. Riduce una particolare integrazione tra ogni applicazione e ogni sistema, ma non elimina configurazioni, credenziali, politiche e differenze di supporto. Il server supportato A non ottiene automaticamente autorizzazione per leggere tutti i file o modificare gli account.
The host È l'applicazione che gestisce l'interazione e il contesto. Interno l'ospite, un client MCP mantiene il collegamento con un Server MCPQuesto espone le abilità. L'host A può utilizzare diversi clienti per connettersi a diversi server. Lo LLM e il loop dell'agente continuano ad avere la sua funzione: MCP non di per sé dà pensiero o sostituisce l'orchestrazione.
Modulo Obiettivi
- host differenziato, client e server senza confonderli con il modello.
- Scegli tra gli strumenti, risorse e prompts se necessario.
- Dopo la scoperta, l'invocazione e il ritorno di uno strumento.
- Distinguere il trasporto MCP da chiamate che il server fa a un altro API.
Capacità server 3
| Capacità | Cosa fornisce? | Esempio di supporto |
|---|---|---|
| Tools | Operazioni con input descritti da uno schema. | consultar_pedido Riforma la sua stato. |
| Risorse | Informazioni che l'applicazione può incorporare come contesto. | A politica di ritorno identificata da URI. |
| Prompts | Modelli riutilizzabili che l'utente può selezionare. | Modello A per preparare una diagnosi di incidenza. |
Si tratta di strumenti controllati dal modello perché il modello può decidere di applicarli. L'applicazione e il server mantengono i controlli esecuzione. Risorse è gestito dall'applicazione e prompts è offerto per la scelta dell'utente. Questi termini descrivono il modello di gioco e non danno autorità senza restrizioni. The documentazione della capacità del server dettagli la distinzione.
Connessione, messaggi e trasporto
La versione e le capacità sono concordate nella creazione della connessione. Il cliente può quindi scoprire gli strumenti con tools/list e li invoca con tools/call. Lo schema comunica nomi, scopi e argomenti. Le risposte indicano risultati o errori. MCP utilizza i messaggi basati su JSON-RPC che collegano richieste e le risposte identificative. La notifica A non richiede lo stesso scambio di risposta di richiesta.
con S.A., client e server sono comunicati dall'ingresso standard e dall'uscita di un processo locale. con Streamable HTTPIl client è collegato a endpoint HTTP; È adatto per server remoti e può anche essere utilizzato localmente. La sicurezza e l'autenticazione dipendono dal trasporto e dalla distribuzione. Controllare le funzionalità della versione che si utilizza Architettura ufficiale di MCP.
"Server da un fornitore esterno" non significa necessariamente "processo di rimozione". È possibile eseguire un pacchetto di terze parti localmente utilizzando stdio e avere quel pacchetto chiamata dopo una nuvola API di HTTPS. Sono due connessioni diverse. Questa differenza aiuta a individuare errori di credenziali, rete e configurazione.
Esempio guidato
Il nostro team vuole condividere una consultazione d'ordine tra un agente LangChain e un assistente supportato dallo sviluppo MCP.
Per pubblicare l'operazione, parti di una funzione Python come consultar_pedidoregistro , la con @mcp.tool() e descrivere la sua intenzione e le sue argomentazioni. The SDK ufficiale Python genera lo schema che il cliente scoprirà da tools/list; al ricevimento tools/callIl server , la valida gli argomenti ed esegue la funzione registrata. FastMCP è l'interfaccia utilizzata per la dimostrazione del corso. e Linea ufficiale SDK uso MCPServer. Lo schema descrive gli input: non consentono l'accesso agli ordini. Identity, autorizzazioni e regole aziendali continuano a richiedere controlli espliciti.
- Esposizioni
consultar_pedido(id_pedido)su un server. La sua descrizione indica che legge solo e richiede un identificatore concreto. - Configura la connessione e le credenziali autorizzate su ogni host. Il client avvia la sessione e consulta gli strumenti disponibili.
- L'utente chiede su ordine
P-204. Il modello propone chiamata L'host applica il suo autorizzazioni. - Il cliente invia
tools/callcon il nome e gli argomenti. Il server convalida l'identità e l'accesso prima di consultare il sistema d'ordine. - Il server restituisce un risultato come stato "in preparazione" e una data stimata, o un errore se non c'è accesso.
- L'host aggiunge che l'osservazione al contesto e l'agente spiega il risultato. L'host A secondo può riutilizzare la stessa capacità se supporta il protocollo, il trasporto e l'autenticazione.
La prova preziosa non è che entrambi i partecipanti scrivono risposte simili: sono che le tracce mostrano lo strumento destinato e il risultato giusto. Se la assistente ha uno strumento equivalente, una risposta appropriata non dimostra di aver utilizzato il server.
Dall'esempio locale al caso OCI
A utilizza e costa server può incapsulare un API OCI. Il client MCP descrive il periodo e il raggruppamento. Il server applica le credenziali e consulta lo API. Per convalidare la risposta, confrontare le date, valuta, fuso orario e raggiungere con un rapporto autorizzato dalla stessa fonte. La differenza A non dimostra che MCP ha sbagliato: ci può essere un filtro diverso o dati non consolidati.
Prima per eseguire un pacchetto esterno verifica la provenienza e autorizzazioni. Per una somma semplice all'interno di un'applicazione, una funzione locale è sufficiente. MCP è particolarmente utile quando la capacità è condivisa, rimane separata o già esiste in un altro sistema.
Errori comuni
- Per supporre che
tools/listeseguire gli strumenti: solo scoprirli. - Per unire un contesto risorsa con una funzione che modifica un registro.
- Attributing autorizzazioni, identità o ragionamento al protocollo da solo.
- Registrare segreti privati completi o dati per purificare un'integrazione.
Esercizio di architettura
L'host A avvia un server per stdio. Il server guarda OCI di HTTPS. Devi configurare il client MCP come Streamable HTTP solo perché i dati provengono dal cloud?
Soluzione
No. Il trasporto MCP descrive la connessione tra client e server: in questo caso è stdio. La connessione HTTPS dal server a OCI è un'altra integrazione. Per cambiare il trasporto senza cambiare la distribuzione sarebbe rompere la comunicazione. Il luogo in cui i dati sono non determina automaticamente il trasporto MCP.
Fonti e recensioni
Controlla. Panoramica dell'architettura y Comprensione dei server MCP. Per applicare a Oracle, collegare questo modulo con MCP a Autonomous AI Database. È necessario essere in grado di identificare entrambe le estremità di ogni connessione prima di scegliere il trasporto o autorizzazioni.