4. AI: agenti e modelli locali
4.2 Istruzioni, skill e server MCP condivisi
Un'unica cartella per istruire gli agenti insieme: AGENTS.md, le skill, i server MCP del kit e quelli di un progetto.
Nell'app: «AI › Agenti»
In breve
- Istruzioni, skill e server MCP si scrivono una volta sola, nella cartella data\agents, e valgono per tutti gli agenti.
- Il kit li allinea all'avvio dell'app, prima e dopo ogni agente e quando un agente termina.
- Puoi modificare anche i file di un agente: la modifica passa agli altri.
- I server MCP del kit si aggiungono anche dalla pagina AI, riga «Condiviso fra gli agenti», riquadro «Server MCP del kit», con i server pronti GitHub, Playwright e Fetch a un clic.
- I server MCP di un solo progetto si aggiungono nella sezione «Editor» del progetto.
Che cosa si condivide
| Che cosa | A che cosa serve | Il file da modificare |
|---|---|---|
| Istruzioni globali | Regole e preferenze che valgono in ogni progetto («rispondi in italiano», «usa pnpm», il tuo stile di codice). | data\agents\AGENTS.md |
| Skill | Procedure riutilizzabili che l'agente carica quando servono, una cartella per skill con un file SKILL.md. | data\agents\skills\<nome>\SKILL.md |
| Server MCP | Programmi o servizi che danno all'agente nuovi strumenti (leggere una documentazione, interrogare un servizio, usare il browser). | data\agents\mcp.json |
- Nella pagina AI scegli la riga «Condiviso fra gli agenti» e premi «Apri la cartella condivisa» (c'è anche sul titolo del riquadro Agenti).
- Modifica AGENTS.md con un editor di testo, aggiungi cartelle in skills o server in mcp.json.
- La modifica arriva agli agenti al loro prossimo avvio (o subito, se riavvii l'app).
data\agents\mcp.json{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
},
"docs": {
"type": "http",
"url": "https://example.com/mcp"
}
}
}Server MCP del kit e server pronti
- Nella pagina AI scegli la riga «Condiviso fra gli agenti»: sotto «Istruzioni e skill» c'è il riquadro «Server MCP del kit», l'elenco di data\agents\mcp.json.
- In «Server pronti» premi «Aggiungi» accanto al server che ti serve; per un altro server premi «Aggiungi un server» e compila nome, tipo e programma o indirizzo.
- Atollo scrive mcp.json e allinea subito gli agenti: Claude Code, Codex, Antigravity e Pi hanno il server senza aspettare il prossimo avvio. «Togli» su una riga lo rimuove.
| Server pronto | Che cosa fa | Dove |
|---|---|---|
github | Issue, pull request e repository su GitHub, con l'account GitHub del kit. È il server di GitHub stesso, in rete (api.githubcopilot.com/mcp), raggiunto attraverso Atollo, che tiene il token: niente da scaricare. | il kit |
playwright | Un browser che l'agente apre e usa: pagine, clic, moduli, schermate. | il kit |
fetch | Legge una pagina web e la dà all'agente come testo. | il kit |
filesystem | Legge e scrive i file, solo nella cartella del progetto. | il progetto |
mysql | Interroga il database MySQL del progetto (DBHub), quando è stato creato. | il progetto |
mongodb | Interroga il database MongoDB del progetto, quando è stato creato. | il progetto |
Come avviene l'allineamento
- Istruzioni: AGENTS.md viene copiato come CLAUDE.md per Claude Code e come AGENTS.md per Codex, Antigravity e Pi. Se modifichi uno di quei file, la modifica torna in AGENTS.md e passa agli altri. Se cambiano entrambe le parti, vince la più recente e l'altra viene conservata nella cartella dei conflitti.
- Skill: ogni agente vede la cartella skills attraverso un collegamento (copie sui dischi FAT32 ed exFAT). Una skill creata dentro un agente viene spostata in data\agents\skills e diventa di tutti; una skill cancellata in un agente viene messa da parte e si può recuperare.
- Server MCP: mcp.json viene tradotto nel formato di ciascun agente. Con Claude Code vale in entrambe le direzioni: un server aggiunto con claude mcp add -s user torna in mcp.json. Codex, Antigravity e Pi ricevono i server del kit e lasciano stare quelli che hai aggiunto a mano nelle loro configurazioni. Pi non accetta i server SSE: il kit li lascia fuori dal suo mcp.json, con un avviso.
Server MCP di un solo progetto
- Apri il progetto, sezione «Editor», riquadro «Server MCP del progetto».
- Per un server pronto premi «Aggiungi» accanto a lui in «Server pronti»: filesystem (i file, solo nella cartella del progetto) e, quando il database del progetto è stato creato con «Crea database e utente», mysql o mongodb. Per un altro server continua dal passo seguente.
- Premi «Aggiungi un server».
- Scrivi il «Nome» (lettere, cifre, - e _) e scegli il «Tipo»: «programma» (con «Programma», per esempio npx, e gli «Argomenti, uno per riga») oppure «indirizzo (http)» (con l'«Indirizzo»).
- Premi «Aggiungi». «Togli» su una riga lo rimuove.
Questi server valgono solo in quel progetto, oltre a quelli del kit. Claude Code li legge dal file .mcp.json del progetto (e chiede conferma al primo uso); Codex da .codex\config.toml, che Atollo tiene allineato; Antigravity e Pi usano solo i server del kit. I programmi che servono (Node per npx, uv per uvx) si installano all'avvio dell'agente; il database del progetto arriva al server mysql o mongodb come variabile, mai scritto in .mcp.json, che può stare nel repository.
Sotto il cofano
| Originale | Copie per gli agenti |
|---|---|
data\agents\AGENTS.md | data\home\.claude\CLAUDE.md · data\home\.codex\AGENTS.md · data\home\.gemini\AGENTS.md · data\home\.pi\agent\AGENTS.md |
data\agents\skills | data\home\.claude\skills · data\home\.codex\skills · data\home\.gemini\antigravity-cli\skills · data\home\.pi\agent\skills |
data\agents\mcp.json | data\home\.claude\.claude.json · data\home\.codex\config.toml · data\home\.gemini\config\mcp_config.json · data\home\.pi\agent\mcp.json |
- Lo stato dell'allineamento, i conflitti e le skill cancellate sono in data\agents\.sync (conflicts, deleted).
- Gli avvisi dell'allineamento finiscono nel log dell'app, data\app\logs\app.log.
- L'allineamento si può lanciare anche dalla riga di comando:
Atollo.exe sync [--project <cartella>] [--verbose]. - Claude Code, Codex e Pi considerano attendibile la cartella di un progetto solo dopo che vi hai aperto un agente da Atollo: da lì possono eseguire comandi senza chiedere la fiducia ogni volta. Le altre cartelle di projects non sono attendibili in anticipo.
- In Codex le variabili ${VAR} non vengono espanse: il kit le traduce dove Codex ha una chiave apposita, altrimenti le copia così come sono con un commento.
- Pi tiene tutto in data\home\.pi\agent (la variabile PI_CODING_AGENT_DIR). Oltre a istruzioni, skill e server MCP, il kit vi scrive models.json (il provider «atollo»: i modelli locali su disco, con la porta e la chiave del server, solo per il proprietario) e settings.json (su Windows il Git Bash del kit come shell, la fiducia nei progetti «ask» se non l'hai impostata, il modello locale come predefinito finché non scegli un altro provider). I tuoi provider e le tue impostazioni restano.