Riepilogo ed esercitazione pratica
In questa pagina
Cosa abbiamo affrontato
Questo corso ti ha guidato dal concetto di Model Context Protocol fino a una configurazione pronta per la produzione. Se devi ricordare una sola cosa, sia questa: MCP permette a Grok di connettersi a server di strumenti esterni tramite HTTPS, scoprendo e utilizzando automaticamente gli strumenti esposti senza necessità di configurazione manuale lato client.
Architetturalmente, quattro punti strutturano tutto il resto. Remote MCP funziona esclusivamente su HTTPS, escludendo HTTP in chiaro, localhost e il trasporto stdio per i server locali. Sono supportati due trasporti: lo Streaming HTTP stateless moderno e le SSE persistenti; è il server a decidere quale usare, non hai scelta tu. Infine, tre interfacce forniscono accesso a questo meccanismo: l’SDK nativo xAI (consigliato), le Responses API per la compatibilità con OpenAI e le Voice Agent API per gli agenti vocali.
I sei parametri in sintesi
| Parametro | Obbligatorio | Funzione |
|---|---|---|
server_url | Sì | Indirizzo HTTPS del server MCP |
server_label | Sì | Identificativo univoco, prefissa gli strumenti |
server_description | No | Descrizione in linguaggio naturale per guidare Grok |
allowed_tool_names | No | Whitelist degli strumenti accessibili |
authorization | No | Token di autenticazione (Bearer, chiave API) |
headers | No | Intestazioni HTTP aggiuntive |
Due obbligatori, quattro opzionali: questa è l’intera superficie di configurazione per Remote MCP. Tuttavia, quelli opzionali non sono semplici comodità. allowed_tool_names gestisce la tua sicurezza, mentre server_description garantisce una selezione accurata quando coesistono più server.
Controlli prima del passaggio in produzione
Tre categorie di controlli richiedono una verifica esplicita. Sul fronte della sicurezza, assicurati che gli URL utilizzino HTTPS con certificati validi, che ogni server interno disponga del proprio token di autenticazione, che questi token risiedano nelle variabili d’ambiente, che gli strumenti siano limitati allo stretto necessario e che sia pianificata una rotazione regolare dei token, non solo sperata.
Sul fronte della configurazione, ogni server deve avere un server_label univoco e descrittivo, e il suo server_description deve essere preciso e aggiornato: una descrizione che si riferisce a una versione precedente del server fuorvia il modello. Mantieni il numero totale di strumenti ragionevole, intorno a dieci-venti per sessione, e rimuovi dalla configurazione i server i cui strumenti non vengono più invocati da nessuno.
Sul fronte dell’osservabilità, pianifica gli incidenti in anticipo: traccia le chiamate agli strumenti nei tuoi log, imposta alert sugli errori di connessione MCP, monitora l’utilizzo dei token per server e misura la latenza delle chiamate. Quest’ultima è spesso trascurata, sebbene costituisca il primo segnale di un server in degrado.
Il tuo primo agente, in tre passaggi
Il modo migliore per consolidare questo corso è costruire progressivamente. Inizia con un server pubblico, senza autenticazione, per validare che la meccanica funzioni end-to-end.
from xai_sdk import Client
from xai_sdk.tools import mcp
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
chat = client.chat.create(
model="grok-4.20-0309-reasoning",
tools=[
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
],
)
Testa con una richiesta che costringa effettivamente il modello a consultare il repository, ad esempio: «spiegami l’architettura del progetto fastapi/fastapi». Se la risposta arriva e cita la struttura reale del progetto, la tua connessione MCP è operativa.
Successivamente, aggiungi uno strumento nativo per vedere Grok arbitrare tra due fonti di natura diversa. La descrizione del server diventa utile proprio qui, poiché ora c’è una scelta da fare.
tools=[
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki",
server_description="Documentazione per progetti open source su GitHub"
),
{"type": "web_search"},
]
Infine, fai il passo verso un server interno, con autenticazione e restrizione degli strumenti. Questo è il momento in cui tutto ciò che hai visto sulla sicurezza diventa concreto.
tools=[
mcp(server_url="https://mcp.deepwiki.com/mcp", server_label="deepwiki"),
mcp(
server_url="https://api.your-server.com/mcp",
server_label="internal",
server_description="Dati e strumenti interni aziendali",
authorization=f"Bearer {os.getenv('INTERNAL_TOKEN')}",
allowed_tool_names=["search", "get_document"]
),
{"type": "web_search"},
]
Cosa rimane valido dopo questo corso
Quattro limitazioni accompagneranno tutti i tuoi progetti MCP con Grok. Le Responses API in formato OpenAI non supportano né require_approval né connector_id, il che ti riporta all’SDK nativo ogni volta che desideri una validazione umana prima dell’esecuzione. Il trasporto stdio, e quindi i server MCP locali, rimane fuori portata: solo HTTPS. Ogni strumento esposto consuma contesto, rendendo il minimalismo una decisione architetturale piuttosto che un ripensamento. Infine, la latenza di rete si somma a ogni chiamata, quindi un agente che concatena diversi strumenti MCP risponderà più lentamente di un agente che ne chiama uno solo.
Nessuno di questi vincoli è un blocco. Tutti sono aggirabili grazie a scelte progettuali consapevoli, ed è esattamente ciò che questo corso ti ha fornito.
Punti chiave
- Remote MCP connette Grok a strumenti esterni tramite HTTPS in poche righe di configurazione
- Sei parametri bastano per configurare un server MCP (due obbligatori, quattro opzionali)
- La sicurezza si basa sulla triade HTTPS + autenticazione + restrizione degli strumenti
- Inizia con un server pubblico (DeepWiki) per poi progredire verso configurazioni multi-server autenticate
- Combina MCP e strumenti nativi per creare agenti versatili
Metti alla prova le tue conoscenze
Server MCP remoti nell’API di Grok: ti sei guadagnato questo riepilogo.
1. Cosa permette il supporto MCP dell'API di Grok?
Risposta: Connettere server MCP remoti come strumenti del modello: Grok chiama le loro capacità durante la generazione; i tuoi sistemi e l’ecosistema MCP diventano estensioni.
2. Come si dichiara un server MCP in una richiesta?
Risposta: Tramite server_url e server_label, con descrizione e whitelist degli strumenti autorizzati, oltre alle intestazioni di autenticazione richieste per l’accesso.
3. Cosa permette la configurazione multi-server?
Risposta: Combinare più server MCP in un’unica richiesta, ciascuno etichettato, e mescolarli con strumenti integrati (web, X): l’orchestrazione rimane in capo al modello.
4. Quali trasporti sono supportati?
Risposta: Streaming HTTP e SSE, i trasporti remoti del protocollo: il server risiede dove vuoi tu, l’API vi si connette.
5. Quali regole di sicurezza per i server remoti?
Risposta: Autorizza solo gli strumenti necessari, autentica in modo rigoroso e tratta le risposte del server come dati da validare: un server MCP di terze parti è una potenziale superficie di attacco.
Dichiara, restringi, autentica, combina: Remote MCP estende Grok ai tuoi sistemi, secondo le tue regole.