Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Sicurezza e migliori pratiche

Lezione 11 di 12 Aggiornata il 29 luglio 2026 Sviluppatore
In questa pagina
  1. Cosa comporta la connessione a un server
  2. HTTPS e autenticazione: le fondamenta non negoziabili
  3. Allowlist come seconda linea di difesa
  4. Il contesto è una risorsa finita
  5. Descrizioni che migliorano la precisione
  6. Punti chiave

Cosa comporta la connessione a un server

Collegare Grok a server MCP remoti conferisce al modello la capacità di agire sui tuoi sistemi. Questo potere comporta dei rischi e le lezioni precedenti hanno introdotto i parametri che lo controllano. Ora è il momento di organizzarli in una postura di sicurezza coerente per il deployment in produzione.

HTTPS e autenticazione: le fondamenta non negoziabili

La regola è semplice: ogni server MCP in produzione deve utilizzare HTTPS e richiedere l’autenticazione. xAI impone già il primo punto e rifiuta qualsiasi URL HTTP in chiaro. Il secondo, invece, dipende interamente da te ed è proprio qui che si insinuano gli errori.

Un server senza autenticazione è accessibile a chiunque conosca l’URL. Questo significa che chiunque può chiamare i tuoi strumenti interni, i tuoi dati circolano senza controllo degli accessi e non hai modo di tracciare chi ha fatto cosa quando si verifica un’anomalia. L’URL non è un segreto: viaggia attraverso le reti, finisce nei log ed è indovinabile se segue una convenzione.

# Produzione: SEMPRE con autenticazione
mcp(
    server_url="https://api.monentreprise.com/mcp",
    server_label="interne",
    authorization=f"Bearer {os.getenv('MCP_TOKEN')}"
)

# SOLO sviluppo: senza autenticazione
# MAI deployare in produzione
mcp(
    server_url="https://mcp.deepwiki.com/mcp",
    server_label="deepwiki"
)

La gestione dei token segue quattro semplici discipline, ma devi rispettarle nel tempo. Archivia i token nelle variabili d’ambiente, mai nel codice sorgente. Altrimenti, il tuo primo git push pubblico invia il tuo token al mondo intero. Ruotali periodicamente, almeno ogni 90 giorni. Una rotazione programmata trasforma una potenziale fuga di dati in una finestra di esposizione limitata. Generali con i permessi minimi necessari, così un token rubato per un agente in sola lettura risulterà inutile a chiunque tenti di scrivere. Se uno viene compromesso, revocalo immediatamente prima di generarne uno nuovo. L’ordine conta: un token revocato dopo il fatto continua a funzionare per tutto il tempo impiegato a cercare il suo sostituto.

Allowlist come seconda linea di difesa

Un token valido prova l’identità del chiamante; non dice nulla su ciò che il chiamante dovrebbe essere in grado di fare. È qui che entra in gioco allowed_tool_names. Applica il principio del privilegio minimo esponendo al modello solo ciò che è strettamente necessario.

La restrizione specifica dipende dal profilo dell’agente. Un chatbot pubblico si limita alle operazioni di sola lettura, senza strumenti di scrittura a portata di mano.

allowed_tool_names=["search_docs", "get_article", "list_categories"]
# Nessun accesso a: create_article, update_article, delete_article

Un agente interno può permettersi un accesso maggiore, inclusa la possibilità di commentare un ticket, mantenendo però fuori portata le azioni irreversibili o quelle visibili a terzi.

allowed_tool_names=[
    "search_tickets", "get_ticket", "add_comment",
    # Nessun accesso a: close_ticket, delete_ticket, reassign_ticket
]

Infine, una pipeline automatizzata ha bisogno solo dei due strumenti che la sua workflow concatena. Non c’è alcuna giustificazione perché possa riconfigurare qualcosa.

allowed_tool_names=["run_analysis", "get_results"]
# Nessun accesso a: configure_pipeline, delete_results

Lo scenario contro cui queste liste ti proteggono è l’injection di prompt. Un documento analizzato, un ticket o un’email in arrivo possono contenere un’istruzione destinata al modello. Senza restrizioni, questa istruzione può portarlo a cancellare dati tramite uno strumento delete_*, modificare un’impostazione tramite update_config o inviare comunicazioni indesiderate tramite send_email. Uno strumento che non è mai stato esposto non può essere dirottato. Questa è l’unica garanzia veramente solida.

Il contesto è una risorsa finita

Ogni strumento esposto consuma token nella finestra di contesto, poiché il suo nome, la descrizione e lo schema dei parametri devono risiedervi. Un server che pubblica trenta strumenti può consumare diverse migliaia di token prima ancora che l’utente ponga una domanda.

Le conseguenze si manifestano in tre modi: meno spazio per la conversazione stessa, tempi di elaborazione più lunghi a causa del volume da analizzare e un aumento del rischio di confusione quando più strumenti sembrano simili. Tre pratiche affrontano questo problema. Innanzitutto, applica restrizioni con allowed_tool_names, che rimane la leva più diretta. Successivamente, segmenta per caso d’uso invece di mantenere una singola configurazione. Un agente di supporto clienti, un agente interno e una pipeline non hanno motivo di condividere lo stesso catalogo. Infine, rivaluta periodicamente. Controlla le tue tracce per vedere quali strumenti vengono effettivamente chiamati. Spesso scoprirai che diversi strumenti non sono mai stati usati, eppure costano contesto a ogni richiesta.

Descrizioni che migliorano la precisione

Descrizioni accurate sia a livello di server che di strumento riducono misurabilmente le chiamate errate. Il contrasto seguente illustra la differenza tra una descrizione utilizzabile e una inutile.

# Buono: specifico e azionabile
server_description="Product knowledge base. Search help articles, FAQ, and troubleshooting guides for products A, B, and C."

# Cattivo: vago e generico
server_description="Database"

Il system prompt è lo strato finale di questa configurazione. Ti permette di esprimere regole d’uso che la configurazione da sola non può far rispettare, come un ordine di priorità tra le fonti o un requisito di conferma.

When the user asks a technical question, search the internal knowledge base (kb) first.
If the answer is not found, use web search as a supplement.
Never modify a ticket without explicit user confirmation.

Tieni presente, tuttavia, che queste linee guida orientano il comportamento del modello senza vincolarlo. Completano l’allowlist; non la sostituiscono mai.

Punti chiave

  • HTTPS è imposto da xAI, ma l’autenticazione è tua responsabilità
  • Archivia i token nelle variabili d’ambiente e ruotali regolarmente
  • Usa allowed_tool_names per applicare il principio del privilegio minimo
  • Monitora il carico del contesto: ogni strumento consuma token
  • Scrivi descrizioni precise per migliorare la selezione degli strumenti da parte di Grok