4. IA : agents et modèles locaux

4.2 Instructions, skills et serveurs MCP partagés

Un seul dossier pour instruire les agents ensemble : AGENTS.md, les skills, les serveurs MCP du kit et ceux d'un projet.

Dans l'application: «IA › Agents»

En bref

  • Instructions, skills et serveurs MCP s'écrivent une seule fois, dans le dossier data\agents, et valent pour tous les agents.
  • Le kit les synchronise au démarrage de l'application, avant et après chaque agent et quand un agent se termine.
  • Vous pouvez aussi modifier les fichiers d'un agent : la modification passe aux autres.
  • Les serveurs MCP du kit s'ajoutent aussi depuis la page IA, ligne « Partagé entre les agents », panneau « Serveurs MCP du kit », avec les serveurs prêts GitHub, Playwright et Fetch en un clic.
  • Les serveurs MCP d'un seul projet s'ajoutent dans la section « Éditeur » du projet.

Ce qui est partagé

QuoiÀ quoi ça sertLe fichier à modifier
Instructions globalesRègles et préférences valables dans chaque projet (« réponds en français », « utilise pnpm », votre style de code).data\agents\AGENTS.md
SkillsProcédures réutilisables que l'agent charge quand il en a besoin, un dossier par skill avec un fichier SKILL.md.data\agents\skills\<nom>\SKILL.md
Serveurs MCPProgrammes ou services qui donnent à l'agent de nouveaux outils (lire une documentation, interroger un service, utiliser le navigateur).data\agents\mcp.json
  1. Dans la page IA, choisissez la ligne « Partagé entre les agents » et appuyez sur « Ouvrir le dossier partagé » (il se trouve aussi sur le titre du volet Agents).
  2. Modifiez AGENTS.md avec un éditeur de texte, ajoutez des dossiers dans skills ou des serveurs dans mcp.json.
  3. La modification arrive aux agents à leur prochain lancement (ou tout de suite, si vous redémarrez l'application).
Exemple de mcp.jsondata\agents\mcp.json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    },
    "docs": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

Serveurs MCP du kit et serveurs prêts

  1. Dans la page IA, choisissez la ligne « Partagé entre les agents » : sous « Instructions et skills » se trouve le panneau « Serveurs MCP du kit », la liste de data\agents\mcp.json.
  2. Dans « Serveurs prêts », appuyez sur « Ajouter » à côté du serveur qu'il vous faut ; pour un autre serveur, appuyez sur « Ajouter un serveur » et remplissez nom, type et programme ou adresse.
  3. Atollo écrit mcp.json et synchronise aussitôt les agents : Claude Code, Codex, Antigravity et Pi ont le serveur sans attendre leur prochain lancement. « Retirer » sur une ligne le supprime.
Serveur prêtCe qu'il faitOù
githubIssues, pull requests et dépôts sur GitHub, avec le compte GitHub du kit. C'est le serveur de GitHub lui-même, en ligne (api.githubcopilot.com/mcp), joint à travers Atollo, qui garde le jeton : rien à télécharger.le kit
playwrightUn navigateur que l'agent ouvre et utilise : pages, clics, formulaires, captures d'écran.le kit
fetchLit une page web et la donne à l'agent sous forme de texte.le kit
filesystemLit et écrit les fichiers, seulement dans le dossier du projet.le projet
mysqlInterroge la base de données MySQL du projet (DBHub), une fois qu'elle a été créée.le projet
mongodbInterroge la base de données MongoDB du projet, une fois qu'elle a été créée.le projet

Comment se fait la synchronisation

  • Instructions : AGENTS.md est copié en CLAUDE.md pour Claude Code et en AGENTS.md pour Codex, Antigravity et Pi. Si vous modifiez l'un de ces fichiers, la modification revient dans AGENTS.md et passe aux autres. Si les deux côtés changent, le plus récent l'emporte et l'autre est conservé dans le dossier des conflits.
  • Skills : chaque agent voit le dossier skills à travers un lien (des copies sur les disques FAT32 et exFAT). Une skill créée dans un agent est déplacée dans data\agents\skills et devient commune à tous ; une skill supprimée dans un agent est mise de côté et peut être récupérée.
  • Serveurs MCP : mcp.json est traduit dans le format de chaque agent. Avec Claude Code, cela vaut dans les deux sens : un serveur ajouté avec claude mcp add -s user revient dans mcp.json. Codex, Antigravity et Pi reçoivent les serveurs du kit et ne touchent pas à ceux que vous avez ajoutés à la main dans leurs configurations. Pi n'accepte pas les serveurs SSE : le kit les laisse hors de son mcp.json, avec un avertissement.

Serveurs MCP d'un seul projet

  1. Ouvrez le projet, section « Éditeur », panneau « Serveurs MCP du projet ».
  2. Pour un serveur prêt, appuyez sur « Ajouter » à côté de lui dans « Serveurs prêts » : filesystem (les fichiers, seulement dans le dossier du projet) et, une fois la base de données du projet créée avec « Créer la base et l'utilisateur », mysql ou mongodb. Pour un autre serveur, continuez à l'étape suivante.
  3. Appuyez sur « Ajouter un serveur ».
  4. Écrivez le « Nom » (lettres, chiffres, - et _) et choisissez le « Type » : « programme » (avec « Programme », par exemple npx, et les « Arguments, un par ligne ») ou « adresse (http) » (avec l'« Adresse »).
  5. Appuyez sur « Ajouter ». « Retirer » sur une ligne le supprime.

Ces serveurs ne valent que dans ce projet, en plus de ceux du kit. Claude Code les lit dans le fichier .mcp.json du projet (et demande confirmation à la première utilisation) ; Codex dans .codex\config.toml, qu'Atollo garde synchronisé ; Antigravity et Pi n'utilisent que les serveurs du kit. Les programmes nécessaires (Node pour npx, uv pour uvx) s'installent au lancement de l'agent ; la base de données du projet arrive au serveur mysql ou mongodb sous forme de variable, jamais écrite dans .mcp.json, qui peut se trouver dans le dépôt.

Sous le capot
OriginalCopies pour les agents
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
  • L'état de la synchronisation, les conflits et les skills supprimées sont dans data\agents\.sync (conflicts, deleted).
  • Les avertissements de la synchronisation finissent dans le journal de l'application, data\app\logs\app.log.
  • La synchronisation peut aussi se lancer depuis la ligne de commande : Atollo.exe sync [--project <dossier>] [--verbose].
  • Claude Code, Codex et Pi ne considèrent le dossier d'un projet comme fiable qu'après que vous y avez ouvert un agent depuis Atollo : dès lors ils peuvent y exécuter des commandes sans demander la confiance à chaque fois. Les autres dossiers de projects ne sont pas fiables d'avance.
  • Dans Codex, les variables ${VAR} ne sont pas développées : le kit les traduit là où Codex a une clé dédiée, sinon il les copie telles quelles avec un commentaire.
  • Pi garde tout dans data\home\.pi\agent (la variable PI_CODING_AGENT_DIR). En plus des instructions, skills et serveurs MCP, le kit y écrit models.json (le fournisseur « atollo » : les modèles locaux sur le disque, avec le port et la clé du serveur, réservé au propriétaire) et settings.json (sur Windows le Git Bash du kit comme shell, la confiance dans les projets « ask » si vous ne l'avez pas réglée, le modèle local par défaut tant que vous ne choisissez pas un autre fournisseur). Vos propres fournisseurs et paramètres restent.