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 cosaA che cosa serveIl file da modificare
Istruzioni globaliRegole e preferenze che valgono in ogni progetto («rispondi in italiano», «usa pnpm», il tuo stile di codice).data\agents\AGENTS.md
SkillProcedure riutilizzabili che l'agente carica quando servono, una cartella per skill con un file SKILL.md.data\agents\skills\<nome>\SKILL.md
Server MCPProgrammi o servizi che danno all'agente nuovi strumenti (leggere una documentazione, interrogare un servizio, usare il browser).data\agents\mcp.json
  1. Nella pagina AI scegli la riga «Condiviso fra gli agenti» e premi «Apri la cartella condivisa» (c'è anche sul titolo del riquadro Agenti).
  2. Modifica AGENTS.md con un editor di testo, aggiungi cartelle in skills o server in mcp.json.
  3. La modifica arriva agli agenti al loro prossimo avvio (o subito, se riavvii l'app).
Esempio di mcp.jsondata\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

  1. 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.
  2. 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.
  3. 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 prontoChe cosa faDove
githubIssue, 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
playwrightUn browser che l'agente apre e usa: pagine, clic, moduli, schermate.il kit
fetchLegge una pagina web e la dà all'agente come testo.il kit
filesystemLegge e scrive i file, solo nella cartella del progetto.il progetto
mysqlInterroga il database MySQL del progetto (DBHub), quando è stato creato.il progetto
mongodbInterroga 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

  1. Apri il progetto, sezione «Editor», riquadro «Server MCP del progetto».
  2. 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.
  3. Premi «Aggiungi un server».
  4. 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»).
  5. 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
OriginaleCopie per gli agenti
data\agents\AGENTS.mddata\home\.claude\CLAUDE.md · data\home\.codex\AGENTS.md · data\home\.gemini\AGENTS.md · data\home\.pi\agent\AGENTS.md
data\agents\skillsdata\home\.claude\skills · data\home\.codex\skills · data\home\.gemini\antigravity-cli\skills · data\home\.pi\agent\skills
data\agents\mcp.jsondata\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.