Aggrega mit Ihrem KI-Assistenten einrichten
Ein KI-Assistent, der Befehle auf Ihrem Rechner ausführen kann — ein Coding-Agent in Ihrem Terminal oder Ihrem Editor —, kann Aggrega für Sie einrichten: das Binary aggrega installieren, sich selbst den Aggrega-Skill hinzufügen und sich mit dem Aggrega-MCP-Server verbinden. Ein Assistent, der Plugins installiert, erledigt die letzten beiden Schritte in einem, indem er das Aggrega-Plugin installiert; jeder andere fügt den Skill hinzu und verbindet den Server nacheinander. Fügen Sie den folgenden Prompt dort ein, und er arbeitet diese Schritte ab; der Prompt weist ihn an, vor jeder Installation bei Ihnen nachzufragen.
Danach hat der Assistent zwei Wege, mit Aggrega zu arbeiten. Der Skill ist ein Ordner mit einer Datei SKILL.md, die der Assistent lädt, wenn Ihre Anfrage Aggrega betrifft: Er sagt dem Assistenten, wie die Authoring-Schleife abläuft und dass er jede Antwort zu einem Schema oder einer Datei aus der Binärdatei statt aus dem Gedächtnis nehmen soll. Der MCP-Server, aggrega mcp, gibt ihm die Werkzeuge von Aggrega — scaffold, validate, build und die übrigen — und das Referenzmaterial, mit dem sie arbeiten. Der Aggrega-Skill beschreibt den Skill und das Plugin, Den MCP-Server verbinden den Server und Was Ihr Assistent mit Aggrega tun kann, was er darüber erreicht.
Sobald er eingerichtet ist, geben Erste Schritte, jede Schritt-für-Schritt-Anleitung unter Import und die Seite jedes ausführbaren Beispiels, das mit Aggrega gebaut wird, die Aufgabe, die sie vermitteln, neben den Befehlen als Prompt zum Einfügen in den Assistenten an.
Der Prompt
Richten Sie Aggrega für mich ein, Schritt für Schritt, und sagen Sie mir bei jedem Schritt, was Sie ausgeführt haben.
1. Führen Sie `aggrega version` aus. Wenn der Befehl nicht gefunden wird, fragen Sie mich, bevor Sie Aggrega installieren, und installieren Sie es dann für meinen Benutzer mit dem offiziellen Installationsprogramm: unter Linux oder macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, unter Windows in PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Führen Sie `aggrega version` erneut aus. Wenn das Installationsprogramm eine Zeile ausgegeben hat, die meinem `PATH` hinzugefügt werden soll, zeigen Sie sie mir.2. Wenn `https://aggrega.ai/docs/ai-assistants/skill/` einen Weg nennt, das Aggrega-Plugin in Ihnen zu installieren, fragen Sie mich, bevor Sie es installieren, und installieren Sie es dann auf diese Weise, oder sagen Sie mir, was zu tun ist, wo es ein Schritt ist, den ich in Ihrer Oberfläche ausführe. Das Plugin fügt den Aggrega-Skill hinzu und verbindet Sie mit dem Aggrega-MCP-Server. Andernfalls führen Sie `aggrega skills install --help` aus und finden Sie Ihren eigenen Bezeichner in der Liste, die es ausgibt. Fragen Sie mich, ob ich den Skill in diesem Projekt oder in jedem Projekt haben möchte, und führen Sie dann `aggrega skills install --agent <your identifier>` aus, mit `--global` für jedes Projekt. Wenn Sie nicht in der Liste stehen, überspringen Sie die Installation des Skills und sagen Sie es mir.3. Wenn Sie das Plugin installiert haben, sind Sie bereits mit dem Aggrega-MCP-Server verbunden. Andernfalls verbinden Sie sich mit dem Aggrega-MCP-Server, also dem Befehl `aggrega mcp`, auf die Art, wie Sie einen MCP-Server hinzufügen, wie `https://aggrega.ai/docs/ai-assistants/mcp-server/` es für Sie beschreibt. Wenn Sie einen Neustart oder ein Neuladen brauchen, um das Plugin oder den Server zu laden, sagen Sie mir, was ich tun soll.4. Sobald Sie verbunden sind, rufen Sie das Werkzeug `describe-capabilities` ohne Argumente auf und fassen Sie zusammen, was es auflistet.Der Prompt ist in jeder Sprache, in der die Dokumentation veröffentlicht ist, derselbe: Nur seine Sätze werden übersetzt, und jeder Befehl, jedes Flag, jede Adresse und jeder Werkzeugname darin bleibt genau so, wie er geschrieben ist, sodass ein Assistent dieselben Anweisungen liest, aus welcher Sprache Sie ihn auch kopieren.
Das Installationsprogramm lädt das neueste Release herunter, prüft es gegen die veröffentlichten SHA-256-Digests des Release und installiert es nur für Ihren Benutzer, ohne Administratorrechte; Das Binary installieren beschreibt, was es tut und wie Sie stattdessen von Hand installieren.
Was sich von Assistent zu Assistent ändert
Drei Teile des Prompts hängen vom Assistenten ab: die Art, wie er das Aggrega-Plugin installiert, sofern er Plugins installiert; andernfalls der Bezeichner, den er bei der Installation des Skills an --agent übergibt, und die Art, wie er den Server hinzufügt. Der Assistent ermittelt sie aus dem Prompt, doch wenn Sie sie kennen, können Sie sie hineinschreiben.
| Assistent | Plugin installieren | Skill ohne das Plugin installieren |
|---|---|---|
| Claude Code | claude plugin install aggrega --marketplace aggrega-ai/aggrega-skills | aggrega skills install --agent claude-code |
| Codex | codex plugin marketplace add aggrega-ai/aggrega-skills, dann codex plugin add aggrega@aggrega | aggrega skills install --agent codex |
| GitHub Copilot CLI | copilot plugin marketplace add aggrega-ai/aggrega-skills, dann copilot plugin install aggrega@aggrega | aggrega skills install --agent github-copilot |
| Gemini CLI | gemini extensions install https://github.com/aggrega-ai/aggrega-skills | aggrega skills install --agent gemini-cli |
| Antigravity | agy plugin install https://github.com/aggrega-ai/aggrega-skills | aggrega skills install --agent antigravity oder --agent antigravity-cli für die Antigravity-CLI |
| Cursor | git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega, dann Developer: Reload Window | aggrega skills install --agent cursor |
Auch Visual Studio Code mit GitHub Copilot, Kiro und OpenClaw installieren das Plugin; Das Plugin installieren nennt den Weg für jeden Assistenten und was OpenClaw vor der Installation abfragt. Die Bezeichner, die --agent akzeptiert, und der Ordner, in den jeder schreibt, sind in aggrega skills aufgeführt und werden von aggrega skills install --help ausgegeben. Wie jeder Assistent den Server hinzufügt — mit einem eigenen Befehl oder über einen Eintrag in seinen Einstellungen oder in einer Serverlistendatei —, steht Client für Client auf Den MCP-Server verbinden.
Wenn ein Teil des Prompts nicht zutrifft
- Ein Assistent, der das Plugin installiert, überspringt das Verbinden des Servers: Das Plugin hat ihn verbunden. Das Plugin installiert die Binärdatei nicht, daher gilt Schritt 1 weiterhin. Wo der Assistent den Server des Plugins außerhalb Ihres Projekts startet — Codex startet ihn im eigenen Ordner des Plugins —, weist der Skill ihn an, dem Server den Ordner Ihres Projekts zu nennen, wie Der Ordner, in dem der Server arbeitet beschreibt.
- Ein Assistent, der kein Plugin installiert und nicht in der
--agent-Liste steht, überspringt die Installation des Skills. Er erreicht die Werkzeuge von Aggrega dennoch über den MCP-Server, sobald er verbunden ist, und der Server gibt ihm beim Verbinden eigene Anleitungen. - Ein Assistent, der keine Befehle ausführen kann — eine Chat-Anwendung ohne Zugriff auf Ihr Terminal —, kann dem Prompt nicht folgen. Installieren Sie die Binärdatei, wie Installation beschreibt, und verbinden Sie die Anwendung selbst, wie Den MCP-Server verbinden beschreibt. Zu Claude Desktop siehe Claude Desktop weiter unten.
- Ein Server, den jemand anderes für Sie betreibt, erreicht über HTTPS, benötigt weder die Binärdatei noch das Plugin noch den Skill. Geben Sie dem Client des Assistenten stattdessen die Adresse, wie Ein über HTTPS erreichter Server beschreibt.
Claude Desktop
Claude Desktop verbindet sich über das Erweiterungspaket, das jedes Release mitbringt, mit Aggrega, und dieses Paket startet das auf Ihrem Computer installierte aggrega. Richten Sie beides selbst auf Ihrem Computer ein:
- Installieren Sie
aggregaunter Windows in PowerShell mitirm https://aggrega.ai/install.ps1 | iexoder unter macOS oder Linux in einem Terminal mitcurl -fsSL https://aggrega.ai/install.sh | sh. Die Binärdatei installieren beschreibt, was das Installationsprogramm tut. - Installieren Sie das Erweiterungspaket, legen Sie dessen Workspace folder fest und starten Sie Claude Desktop neu, wie Claude Desktop auf der Seite „Den MCP-Server verbinden“ beschreibt.
Eine Claude-Desktop-Sitzung kann ihre Befehle in einem Cloud-Container statt auf Ihrem Computer ausführen; der obige Prompt wirkt daher, dort eingefügt, auf den Container. Dort lässt sich aggrega aus der Shell der Sitzung installieren und ausführen, sobald die Netzwerkrichtlinie des Containers aggrega.ai zulässt — ein Organisationsinhaber lässt es in den Netzwerkzugriffseinstellungen der Organisation zu. Der Aggrega-MCP-Server ist dort nicht verbunden: Claude Desktop fügt einen lokalen Server nur über seine Erweiterungseinstellungen hinzu, und die Erweiterung startet das aggrega auf Ihrem Computer, nicht das im Container.
aggrega skills install hat keinen Eintrag für Claude Desktop, daher überspringt eine Claude-Desktop-Sitzung die Installation des Skills. Sie erreicht die Werkzeuge von Aggrega über den MCP-Server, sobald die Erweiterung installiert ist, und der Server gibt ihr beim Verbinden eigene Anleitungen.