4. KI: Agenten und lokale Modelle
4.2 Gemeinsame Anweisungen, Skills und MCP-Server
Ein einziger Ordner, um alle Agenten gemeinsam anzuleiten: AGENTS.md, die Skills, die MCP-Server des Kits und die eines Projekts.
In der App: «KI › Agenten»
Kurz gesagt
- Anweisungen, Skills und MCP-Server werden nur einmal geschrieben, im Ordner data\agents, und gelten für alle Agenten.
- Das Kit gleicht sie beim Start der App ab, vor und nach jedem Agenten und wenn ein Agent endet.
- Du kannst auch die Dateien eines Agenten ändern: Die Änderung geht an die anderen über.
- Die MCP-Server des Kits lassen sich auch auf der Seite KI hinzufügen, Zeile „Von den Agenten geteilt“, Bereich „MCP-Server des Kits“, mit den fertigen Servern GitHub, Playwright und Fetch per Klick.
- MCP-Server für ein einzelnes Projekt werden im Abschnitt „Editor“ des Projekts hinzugefügt.
Was geteilt wird
| Was | Wozu es dient | Die zu bearbeitende Datei |
|---|---|---|
| Globale Anweisungen | Regeln und Vorlieben, die in jedem Projekt gelten („antworte auf Deutsch“, „verwende pnpm“, dein Codestil). | data\agents\AGENTS.md |
| Skills | Wiederverwendbare Abläufe, die der Agent bei Bedarf lädt, ein Ordner pro Skill mit einer Datei SKILL.md. | data\agents\skills\<Name>\SKILL.md |
| MCP-Server | Programme oder Dienste, die dem Agenten neue Werkzeuge geben (eine Dokumentation lesen, einen Dienst abfragen, den Browser verwenden). | data\agents\mcp.json |
- Wähle auf der Seite KI die Zeile „Von den Agenten geteilt“ und drück „Gemeinsamen Ordner öffnen“ (die Schaltfläche gibt es auch am Titel des Bereichs Agenten).
- Bearbeite AGENTS.md mit einem Texteditor, füge Ordner in skills oder Server in mcp.json hinzu.
- Die Änderung erreicht die Agenten bei ihrem nächsten Start (oder sofort, wenn du die App neu startest).
data\agents\mcp.json{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
},
"docs": {
"type": "http",
"url": "https://example.com/mcp"
}
}
}MCP-Server des Kits und fertige Server
- Wähle auf der Seite KI die Zeile „Von den Agenten geteilt“: Unter „Anweisungen und Skills“ gibt es den Bereich „MCP-Server des Kits“, die Liste von data\agents\mcp.json.
- Drück unter „Fertige Server“ neben dem gewünschten Server auf „Hinzufügen“; für einen anderen Server drück „Server hinzufügen“ und gib Name, Typ und Programm oder Adresse ein.
- Atollo schreibt mcp.json und gleicht die Agenten sofort ab: Claude Code, Codex, Antigravity und Pi haben den Server, ohne auf ihren nächsten Start zu warten. „Entfernen“ in einer Zeile entfernt ihn.
| Fertiger Server | Was er tut | Wo |
|---|---|---|
github | Issues, Pull Requests und Repositorys auf GitHub, mit dem GitHub-Konto des Kits. Es ist der Server von GitHub selbst, online (api.githubcopilot.com/mcp), erreicht über Atollo, das das Token behält: nichts herunterzuladen. | das Kit |
playwright | Ein Browser, den der Agent öffnet und benutzt: Seiten, Klicks, Formulare, Bildschirmfotos. | das Kit |
fetch | Liest eine Webseite und gibt sie dem Agenten als Text. | das Kit |
filesystem | Liest und schreibt Dateien, nur im Ordner des Projekts. | das Projekt |
mysql | Fragt die MySQL-Datenbank des Projekts ab (DBHub), sobald sie angelegt ist. | das Projekt |
mongodb | Fragt die MongoDB-Datenbank des Projekts ab, sobald sie angelegt ist. | das Projekt |
Wie der Abgleich funktioniert
- Anweisungen: AGENTS.md wird als CLAUDE.md für Claude Code und als AGENTS.md für Codex, Antigravity und Pi kopiert. Wenn du eine dieser Dateien änderst, geht die Änderung zurück in AGENTS.md und an die anderen. Ändern sich beide Seiten, gewinnt die neuere, und die andere wird im Konfliktordner aufbewahrt.
- Skills: Jeder Agent sieht den Ordner skills über eine Verknüpfung (Kopien auf FAT32- und exFAT-Laufwerken). Ein in einem Agenten erstellter Skill wird nach data\agents\skills verschoben und gehört dann allen; ein in einem Agenten gelöschter Skill wird beiseitegelegt und lässt sich wiederherstellen.
- MCP-Server: mcp.json wird in das Format jedes Agenten übersetzt. Bei Claude Code gilt das in beide Richtungen: Ein mit claude mcp add -s user hinzugefügter Server kommt zurück in mcp.json. Codex, Antigravity und Pi erhalten die Server des Kits und lassen die, die du von Hand in ihren Konfigurationen hinzugefügt hast, unangetastet. Pi akzeptiert keine SSE-Server: Das Kit lässt sie mit einer Warnung aus seiner mcp.json weg.
MCP-Server für ein einzelnes Projekt
- Öffne das Projekt, Abschnitt „Editor“, Bereich „MCP-Server des Projekts“.
- Für einen fertigen Server drück unter „Fertige Server“ daneben auf „Hinzufügen“: filesystem (die Dateien, nur im Ordner des Projekts) und, sobald die Datenbank des Projekts mit „Datenbank und Benutzer erstellen“ angelegt ist, mysql oder mongodb. Für einen anderen Server mach mit dem nächsten Schritt weiter.
- Drück „Server hinzufügen“.
- Gib den „Name“ ein (Buchstaben, Ziffern, - und _) und wähle den „Typ“: „Programm“ (mit „Programm“, zum Beispiel npx, und den „Argumente, eines pro Zeile“) oder „Adresse (http)“ (mit der „Adresse“).
- Drück „Hinzufügen“. „Entfernen“ in einer Zeile entfernt ihn.
Diese Server gelten nur in diesem Projekt, zusätzlich zu denen des Kits. Claude Code liest sie aus der Datei .mcp.json des Projekts (und fragt bei der ersten Verwendung nach einer Bestätigung); Codex aus .codex\config.toml, das Atollo abgeglichen hält; Antigravity und Pi verwenden nur die Server des Kits. Die nötigen Programme (Node für npx, uv für uvx) werden beim Start des Agenten installiert; die Datenbank des Projekts erreicht den Server mysql oder mongodb als Variable, nie in .mcp.json geschrieben, die im Repository liegen kann.
Unter der Haube
| Original | Kopien für die Agenten |
|---|---|
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 |
- Der Abgleichstatus, die Konflikte und die gelöschten Skills liegen in data\agents\.sync (conflicts, deleted).
- Warnungen des Abgleichs landen im Protokoll der App, data\app\logs\app.log.
- Der Abgleich lässt sich auch über die Kommandozeile starten:
Atollo.exe sync [--project <Ordner>] [--verbose]. - Claude Code, Codex und Pi vertrauen dem Ordner eines Projekts erst, nachdem du darin einen Agenten aus Atollo geöffnet hast: Ab dann können sie dort Befehle ausführen, ohne jedes Mal nach Vertrauen zu fragen. Die anderen Ordner in projects gelten nicht im Voraus als vertrauenswürdig.
- In Codex werden ${VAR}-Variablen nicht ersetzt: Das Kit übersetzt sie dort, wo Codex einen eigenen Schlüssel hat, und kopiert sie sonst unverändert mit einem Kommentar.
- Pi bewahrt alles in data\home\.pi\agent auf (die Variable PI_CODING_AGENT_DIR). Neben Anweisungen, Skills und MCP-Servern schreibt das Kit dort models.json (den Anbieter „atollo“: die lokalen Modelle auf dem Datenträger, mit Port und Schlüssel des Servers, nur für den Eigentümer lesbar) und settings.json (unter Windows die Git Bash des Kits als Shell, das Projektvertrauen „ask“, wenn du es nicht eingestellt hast, das lokale Modell als Standard, bis du einen anderen Anbieter wählst). Deine eigenen Anbieter und Einstellungen bleiben.