In breve
Il code mode permette a un agente AI di eseguire un breve programma che orchestra molti strumenti MCP in un'unica chiamata, invece di un viaggio di andata e ritorno per ogni strumento. Il filtraggio e l'unione dei dati avvengono in un sandbox isolato, così torna indietro solo la risposta finale, riducendo il consumo di token nei flussi con molti dati fino al 90-99%.
Perché gli agenti multi-strumento consumano così tanti token
Ogni volta che un agente AI chiama uno strumento, il risultato torna indietro passando per il modello. Chiedigli di "elencare le fatture aperte di ogni cliente che ha ordinato lo scorso trimestre" e un agente che procede uno strumento alla volta fa decine di chiamate e trascina ogni elenco intermedio — clienti, ordini, fatture — dentro la finestra di contesto. Il modello legge tutto, token dopo token, solo per conservare alla fine una manciata di id. In un flusso con molti dati è il dato intermedio, non la risposta, a costarti caro.
Il code mode elimina i viaggi di andata e ritorno. Invece di chiamare gli strumenti uno alla volta, l'agente scrive un breve programma JavaScript che chiama diversi dei tuoi strumenti MCP, ne filtra e unisce i risultati e restituisce solo ciò che conta — in un unico passaggio. Decine di chiamate e megabyte di dati intermedi diventano una sola chiamata che restituisce poche righe. Nei compiti a più passaggi e ricchi di filtri questo riduce il consumo di token fino al 90-99%, ed è più veloce, perché il ciclo gira accanto ai dati anziché passare attraverso il modello.
Prima e dopo
Senza code mode — il modello guida ogni passaggio e legge ogni risultato:
search invoices → (model reads 400 rows)
list customers → (model reads 1,200 rows)
for each open invoice, get the customer → (hundreds of calls, all read back)
Con il code mode — il modello scrive un solo programma; torna indietro solo il risultato:
// Discover, read and call your tools from inside the sandbox.
const invoices = await amcp.run('list_invoices', { status: 'open' });
const customers = await amcp.run('list_customers', { activeSince: '2026-01-01' });
const active = new Set(customers.map((c) => c.id));
return invoices
.filter((i) => active.has(i.customerId))
.map((i) => ({ id: i.id, amount: i.amount, customer: i.customerId }));
L'agente riceve l'elenco breve che ha effettivamente richiesto. Le 1.600 righe su cui ha filtrato non entrano mai nella finestra di contesto.
Non affidabile per progettazione — così resta sicuro
Un programma è scritto da un modello, e il risultato di uno strumento vittima di
prompt injection potrebbe cercare di dirottarlo. Per questo il code mode non gira
mai nel backend di AnythingMCP. Gira in un code-runner separato: un
sottoprocesso isolato per ogni esecuzione, senza rete, senza filesystem, senza
ambiente e senza segreti. L'unica cosa che un programma può fare è chiamare gli
strumenti MCP che il chiamante è già autorizzato a usare, attraverso un ponte
amcp a cui il backend risponde con il ruolo e i permessi di quel chiamante. La
portata e le regole di lettura/scrittura sono esattamente le stesse di una
chiamata diretta a uno strumento, ogni esecuzione viene registrata nell'audit e
ogni esecuzione è limitata da un tempo massimo, da un tetto di memoria e da un
limite sul numero di chiamate agli strumenti che può effettuare.
Il code mode è disattivato per impostazione predefinita. Un workspace lo attiva per singolo server MCP, e il codice inline è inoltre regolato dal ruolo del chiamante — così nulla viene eseguito finché non scegli tu di abilitarlo.
Due modi per usarlo
- Strumenti di codice salvati. Uno strumento riutilizzabile il cui corpo è un programma memorizzato, creato nella dashboard come qualsiasi altro strumento. Compare nell'elenco degli strumenti, rispetta gli accessi per ruolo e viene registrato nell'audit. Perfetto per un flusso che il tuo team ripete di continuo.
- Codice inline. Uno strumento generico Run code che l'agente può chiamare con un programma che scrive all'istante, sempre in sola lettura e con i permessi propri del chiamante. Un agente può anche proporre uno strumento di codice salvato perché un amministratore lo approvi.
Come attivarlo
- Apri un server MCP nella dashboard e imposta Code mode su Saved code tools oppure Saved code tools + inline code.
- Scegli quali connettori il server espone — un programma può raggiungere solo quelli.
- Collega il server a Claude, ChatGPT o qualsiasi client MCP e chiedigli di eseguire un compito a più passaggi. Su AnythingMCP Cloud il runner è gestito per te; quando usi il self-hosting, avvia il servizio code-runner incluso.
Il code mode è disponibile su AnythingMCP Cloud e in self-hosting. Gli strumenti di codice salvati sono inclusi a partire dal piano Starter; il codice inline e le proposte degli agenti sono disponibili dal piano Team in su; gli strumenti di codice abilitati alla scrittura sono una funzionalità Enterprise. Consulta la pagina dei prezzi per sapere cosa include ciascun piano, oppure inizia con una prova gratuita.
Questa guida ti è stata utile?