Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

Den MCP-Server verbinden

Der MCP-Server von Aggrega ist der Befehl aggrega mcp, und die Binärdatei aggrega ist seine einzige Voraussetzung: Das Binary installieren installiert sie mit einem einzigen Befehl. Der Server läuft als Unterprozess Ihres Clients über stdio, liest seine Schemas aus der Binärdatei und seine Dokumentationsseiten aus einer Kopie, die er einmalig in den Cache Ihres Rechners lädt, und benötigt keinen separaten Dienst, keinen Port und kein Konto. Wenn jemand anderes bereits einen Server für Sie betreibt, brauchen Sie weder die Binärdatei noch irgendetwas hiervon: siehe Ein über HTTPS erreichter Server.

Clients, die ihn mit einem einzigen Befehl hinzufügen

Ein Assistent, in dem das Aggrega-Plugin installiert ist, ist bereits verbunden. Die Installation des Plugins fügt den Aggrega-Skill und den Server in einem Schritt hinzu — in Claude Code, Codex, GitHub Copilot, Gemini CLI, Antigravity, Cursor, Kiro und OpenClaw, wie Das Plugin installieren beschreibt —, sodass auf dieser Seite nichts weiter nötig ist, um diesen Assistenten zu verbinden. Das Plugin startet aggrega mcp mit dem aggrega, das auf dem PATH gefunden wird, mit dem der Assistent gestartet wurde; die Binärdatei muss also dort installiert sein. Manche Assistenten starten den Server eines Plugins im eigenen Ordner des Plugins statt in Ihrem Projekt — Codex tut das —, und der Assistent nennt dann den Ordner Ihres Projekts als workspace_root bei den Aufrufen, die ihn annehmen; der Skill weist ihn an zu prüfen, in welchem Workspace der Server antwortet.

Ohne das Plugin fügen Sie den Server mit dem eigenen Befehl des Clients hinzu. In Claude Code:

Terminal window
claude mcp add --transport stdio aggrega -- aggrega mcp

In Codex:

Terminal window
codex mcp add aggrega -- aggrega mcp

In Gemini CLI:

Terminal window
gemini mcp add aggrega aggrega mcp

Alle anderen Clients

Die meisten MCP-fähigen Clients starten den Server auf dieselbe Weise — sie führen den Befehl aggrega mit einem einzigen Argument mcp aus und sprechen das Protokoll über die Standardein- und -ausgabe des Prozesses. Unterschiedlich ist, wo jeder seine Serverliste führt und wie er die Einträge darin nennt. Die gemeinsame Form:

{
"mcpServers": {
"aggrega": {
"command": "aggrega",
"args": ["mcp"]
}
}
}

Sobald der Client neu gestartet ist und sich verbunden hat, stehen die Prompts, Ressourcen und Werkzeuge von Aggrega zum Verfassen zur Verfügung. Was Ihr Assistent mit Aggrega tun kann beschreibt sie, Aggrega-Dateien verfassen zeigt, was Sie damit tun, und die Referenz zu aggrega mcp behandelt den Befehl selbst.

Nichts im Eintrag wählt eine Protokollrevision. Aggrega spricht sowohl 2026-07-28 als auch 2025-06-18, über Standardein- und -ausgabe ebenso wie über HTTPS, sodass sich ein Client der einen wie der anderen verbindet und dieselben Prompts, Ressourcen und Werkzeuge erreicht. Welche ein Client anfordert, wird auf der Leitung ausgehandelt statt in Ihrer Konfiguration.

Ein Assistent, der Befehle ausführen kann, erledigt all das selbst — die Binärdatei installieren, den Aggrega-Skill hinzufügen und sich mit dem Server verbinden — anhand eines einzigen Prompts, den Sie bei ihm einfügen: siehe Aggrega mit Ihrem KI-Assistenten einrichten.

Wo jeder Client seine Serverliste führt

ClientWo die Liste liegtWie der Eintrag heißt
Claude Codeclaude mcp add oder eine .mcp.json-Datei im ProjektmcpServers
Claude Desktopseine Erweiterungseinstellungen für einen lokalen Server; seine Connector-Einstellungen für einen über HTTPS erreichtensiehe Claude Desktop
Cursor.cursor/mcp.json für einen Workspace oder eine benutzerbezogene mcp.json für jeden WorkspacemcpServers
Gemini CLIgemini mcp add oder ~/.gemini/settings.json für jedes Projekt und .gemini/settings.json für ein einzelnesmcpServers
Codex CLIcodex mcp add oder ~/.codex/config.toml für jedes Projekt und .codex/config.toml für ein einzelnes vertrauenswürdiges Projekteine Tabelle [mcp_servers.aggrega] — siehe Codex CLI
ZedSettings → AI → MCP Servers, das den Eintrag in die Einstellungsdatei von Zed schreibtcontext_servers — siehe Zed
Visual Studio Codemcp.json in Ihrem Benutzerprofil oder .vscode/mcp.json für einen Workspaceservers — siehe Visual Studio Code
GitHub Copilot CLIcopilot mcp add oder die Datei mcp-config.json, die es in Ihrem Home-Verzeichnis führtmcpServers
Antigravitydie Datei mcp_config.json, erreichbar über seine EinstellungenmcpServers
Windsurfdie Datei mcp_config.json, erreichbar über seine EinstellungenmcpServers
Clineseine MCP-Einstellungen, gestützt auf eine Datei cline_mcp_settings.jsonmcpServers

Jeder Client in dieser Tabelle außer den vieren mit einem eigenen Abschnitt weiter unten übernimmt den Eintrag genau wie oben geschrieben, unter dem Pfad in seiner Zeile. Ein nicht aufgeführter Client verbindet sich auf dieselbe Weise, wenn er eine Serverliste in einer dieser Formen liest.

Ein Hinweis zu PATH

Aus einer grafischen Umgebung gestartete Clients erben nicht immer denselben PATH wie Ihr Terminal. Meldet ein Client, dass er den Befehl aggrega nicht finden kann, ersetzen Sie "command": "aggrega" durch den absoluten Pfad zur Binärdatei (zum Beispiel "command": "/home/you/.local/bin/aggrega", der Installationsort unter Linux für einen Benutzer namens you). Alles andere bleibt gleich.

Visual Studio Code

Visual Studio Code führt seine Server unter servers statt unter mcpServers, und jeder Eintrag nennt den Transport, den er verwendet:

{
"servers": {
"aggrega": {
"type": "stdio",
"command": "aggrega",
"args": ["mcp"]
}
}
}

Codex CLI

Codex hält seine Server in TOML statt in JSON — in ~/.codex/config.toml für jedes Projekt oder in .codex/config.toml für ein Projekt, dem Codex vertraut —, jeden als Tabelle, die nach dem Server benannt ist:

[mcp_servers.aggrega]
command = "aggrega"
args = ["mcp"]

codex mcp add aggrega -- aggrega mcp, der Befehl von oben, schreibt dieselbe Tabelle für Sie. Die Codex-IDE-Erweiterung und die ChatGPT-Desktop-App lesen dieselbe Datei, sodass der eine Eintrag allen dreien dient.

Zed

Zed hält seine Server unter context_servers in seiner Einstellungsdatei. Fügen Sie den Server über Settings → AI → MCP Servers hinzu — Add Server, dann Add Local Server —, was den Eintrag in diese Datei schreibt, oder führen Sie zed: open settings file aus der Befehlspalette aus und fügen Sie den Eintrag selbst hinzu:

{
"context_servers": {
"aggrega": {
"command": "aggrega",
"args": ["mcp"]
}
}
}

Zed unterstützt die Werkzeuge und Prompts des Protokolls, daher erreicht sein Agent die Werkzeuge und Authoring-Prompts von Aggrega, nicht aber die Ressourcen, die der Server ebenfalls anbietet.

Claude Desktop

Claude Desktop installiert einen lokalen Server aus einem Erweiterungspaket — dem Server zusammen mit einem Manifest, das ihn beschreibt, gebündelt in einer installierbaren Datei und über seine Erweiterungseinstellungen hinzugefügt — statt aus einem Eintrag in einer Konfigurationsdatei. Jedes Aggrega-Release enthält ein solches Paket, aggrega-<version>.mcpb, neben seinen vorkompilierten Binärdateien.

Das Paket von Aggrega enthält kein eigenes Programm. Es startet eine bereits auf Ihrem Rechner installierte ausführbare Datei aggrega mit dem einzigen Argument mcp und spricht das Protokoll über die Standardein- und -ausgabe dieses Prozesses — derselbe Server, den jeder Eintrag oben startet. Sofern Sie keine andere ausführbare Datei wählen, übergibt es Claude Desktop den Befehlsnamen aggrega, wie es jeder Eintrag oben tut, sodass die Anwendung aggrega in dem PATH sucht, mit dem sie gestartet wurde; und es übergibt diesem Server den Workspace, den Sie wählen. So fügen Sie es hinzu:

  1. Installieren Sie die Binärdatei aggrega, wie in Das Binary installieren beschrieben. Der Installationsbefehl und die manuellen Schritte dort legen sie beide in einem eigenen Ordner ab — unter Windows %LOCALAPPDATA%\Programs\aggrega statt eines Systemordners wie C:\Windows\System32 —, sodass Sie sie ohne Administratorrechte ersetzen können.
  2. Installieren Sie aggrega-<version>.mcpb über die Erweiterungseinstellungen von Claude Desktop.
  3. Legen Sie die Einstellungen des Pakets fest; keine davon ist erforderlich. Path to the aggrega executable ist das Programm, das das Paket startet, und sein Standardwert ist der Befehlsname aggrega, den die Anwendung in dem PATH sucht, mit dem sie gestartet wurde. Ein Ordner, der Ihrem PATH hinzugefügt wird, während die Anwendung läuft — wie es der Windows-Installer und der Installationsbefehl unter Windows mit ihrem Ordner tun —, erreicht sie erst, wenn sie beendet und neu gestartet wurde, wie in Schritt 4, und eine aus einer grafischen Umgebung gestartete Anwendung sieht möglicherweise nicht denselben PATH wie Ihr Terminal (siehe Ein Hinweis zu PATH). Behalten Sie den Standardwert bei, wenn das aggrega in diesem PATH die gewünschte ausführbare Datei ist. Setzen Sie das Feld stattdessen auf den vollständigen Pfad einer ausführbaren Datei, wenn die gewünschte nicht in diesem PATH liegt oder ein anderes aggrega ist als das erste dort gefundene — unter macOS und Linux für den Installationsort das aggrega in .local/bin in Ihrem Home-Ordner, etwa /Users/you/.local/bin/aggrega; unter Windows der vollständige Pfad mit der Endung aggrega.exe, etwa C:\Users\you\AppData\Local\Programs\aggrega\aggrega.exe. Um zum Standardwert zurückzukehren, setzen Sie das Feld auf aggrega, statt es zu leeren. Ist überhaupt kein aggrega installiert, installieren Sie es wie in Schritt 1 beschrieben. Workspace folder ist der Ordner des Aggrega-Workspace, in dem der Assistent arbeitet: der Ordner, der die .aggrega-config.yaml Ihres Projekts enthält. Legen Sie diese Einstellung fest: Sie ist leer, bis Sie einen Ordner wählen, und solange sie leer ist, übergibt das Paket dem Server ein leeres AGGREGA_WORKSPACE_ROOT, sodass der Server jede Anfrage, die der Assistent im Workspace stellt, mit einer Ablehnung beantwortet, die besagt, dass die Einstellung Workspace folder leer ist, und Sie auffordert, sie auf den Ordner zu setzen, der die .aggrega-config.yaml Ihres Workspace enthält, statt in dem Ordner zu arbeiten, in dem Claude Desktop ihn gestartet hat. Das Paket übergibt den Ordner nur dann an den Server, wenn die Anwendung ihn startet; ein Ordner, den Sie festlegen, während der Server läuft, wird daher erst wirksam, wenn Sie die Erweiterung in den Erweiterungseinstellungen aus- und wieder einschalten oder die Anwendung wie in Schritt 4 neu starten.
  4. Beenden Sie Claude Desktop vollständig und starten Sie es dann erneut. Ein Server, den die Anwendung bereits gestartet hat, läuft weiter, und das Umbenennen der ausführbaren Datei beendet ihn nicht, sodass eine geänderte Einstellung erst wirksam wird, wenn die Anwendung den Server erneut startet: sobald sie beendet und neu gestartet wurde oder, für Workspace folder, sobald die Erweiterung aus- und wieder eingeschaltet wurde. Unter Windows zeigt der Task-Manager, ob noch ein aggrega-Prozess läuft.

Im Workspace-Ordner wird jede Anfrage beantwortet, die keinen eigenen Workspace nennt. Claude Desktop startet den Server in einem Ordner eigener Wahl statt in Ihrem Projekt, daher übergibt das Paket den von Ihnen gewählten Ordner an den Server als Variable AGGREGA_WORKSPACE_ROOT in seiner Umgebung, statt als Argument in der Befehlszeile, die die Anwendung zusammensetzt. Der Server nimmt diesen Ordner selbst als Workspace-Wurzel, so wie --workspace-root bei jedem Befehl genommen wird: Er sucht nicht oberhalb davon nach einem umschließenden Workspace; wählen Sie also den Ordner, der .aggrega-config.yaml enthält, und nicht einen darin. Um in einem anderen Workspace zu arbeiten, ändern Sie die Einstellung und starten Sie die Anwendung wie in Schritt 4 neu. Bei einer Anfrage, die mit einem relativen workspace_root einen eigenen Workspace nennt, wird dieser ebenfalls vom Workspace-Ordner aus gelesen, sodass ein Prompt einen Ordner darin — etwa quickstart-ai/1 — nennt, ohne zu wissen, wo der Ordner auf Ihrem Rechner liegt; ein absoluter workspace_root wird so verwendet, wie er angegeben ist. Solange die Einstellung leer ist, wird ein relativer mit derselben Ablehnung beantwortet wie eine Anfrage, die keinen nennt.

Da das Paket keine ausführbare Datei irgendeiner Plattform nennt, gilt dieselbe Datei für jede Plattform, die es deklariert: macOS, Windows und Linux.

Der Server meldet, welches aggrega das Paket gestartet hat. Die Erweiterungseinstellungen von Claude Desktop zeigen die eigene Version des Pakets — die Version des Release, aus dem es stammt — und nicht die Version der ausführbaren Datei, die es startet. Beide werden getrennt installiert und können daher aus verschiedenen Releases stammen. Das Paket übergibt dem Server seine eigene Version als Variable AGGREGA_BUNDLE_VERSION in seiner Umgebung, und der Server meldet beide: Die Antwort von describe-capabilities, ohne Argumente aufgerufen — das Werkzeug, das ein Assistent aufruft, um zu erfahren, was der Server anbietet —, beginnt mit einer Zeile, die die Version der ausführbaren Datei und die des Pakets nennt, und enthält dieselbe Zeile als version_summary in ihrem strukturierten Teil, sodass ein Assistent, der gefragt wird, welche Version von Aggrega läuft, beide dort lesen kann, welchen Teil der Antwort die Anwendung ihm auch übergibt. Stammen die beiden aus verschiedenen Releases, sagt diese Zeile das und nennt beide, und die Hinweise, die der Server dem Assistenten beim Verbinden übergibt, beginnen mit demselben Satz. Nichts wird wegen eines Unterschieds abgelehnt, und der Server beantwortet jede Anfrage wie gewohnt; es wird gemeldet, damit Sie wissen, welche ausführbare Datei das Paket ausführt. Um beide anzugleichen, installieren Sie das aggrega-<version>.mcpb des Release, aus dem Ihre ausführbare Datei stammt — aggrega version in einem Terminal gibt diese Version aus —, oder setzen Sie Path to the aggrega executable auf den vollständigen Pfad eines aggrega aus dem Release des Pakets, und starten Sie dann die Anwendung wie in Schritt 4 neu.

Die eigenen Logs von Claude Desktop zeigen, was es gestartet hat. Unter Windows können sie unter einem Paketordner im lokalen Anwendungsdatenverzeichnis liegen statt unter %APPDATA%\Claude\logs, selbst wenn Claude Desktop aus seinem eigenen Download installiert wurde: unter %LOCALAPPDATA%\Packages\, in dem Ordner, dessen Name mit Claude_ beginnt, unter LocalCache\Local\Claude\logs. Die Dateien dort umfassen mcp.log und mcp-server-Aggrega.log, wobei die zweite enthält, was der Aggrega-Server auf seine Standardfehlerausgabe schreibt. Eine Zeile mit Using MCP server command: nennt den Befehl, den die Anwendung gestartet hat, entnommen aus der Einstellung Path to the aggrega executable des Pakets. Nennt die Einstellung einen Pfad, unter dem sich nichts befindet, enthält das Log die Meldung des Windows-Befehlsinterpreters, dass der Pfad nicht als Befehl erkannt wird, und meldet dann, dass der Server nicht starten konnte. Fehlt der Workspace-Ordner — umbenannt, verschoben oder nie angelegt —, startet der Server trotzdem und beantwortet jede Anfrage, die der Assistent in diesem Workspace stellt, mit seiner Ablehnung, sodass der Assistent die Ablehnung als Antwort auf seine Anfrage erhält, statt dass die Anwendung einen Verbindungsfehler meldet. Sie nennt AGGREGA_WORKSPACE_ROOT als die Variable, die die Einstellung Workspace folder des Pakets setzt, und zitiert den Ordner genau so, wie die Anwendung ihn übergeben hat; mcp-server-Aggrega.log enthält dieselbe Ablehnung. Ein leer gelassener Workspace folder wird auf dieselbe Weise beantwortet, mit der Ablehnung aus Schritt 3, die die leere Einstellung nennt und die ebenfalls im Log steht. Korrigieren Sie die Einstellung und starten Sie die Anwendung wie in Schritt 4 neu.

Die Connector-Einstellungen von Claude Desktop sind der andere Weg, für einen über HTTPS erreichten Server: siehe Ein über HTTPS erreichter Server.

Wenn ein Client nicht den gesamten Werkzeugumfang übernimmt

Aggrega kündigt seinen gesamten Werkzeugumfang an und überlässt es dem Client, wie viel davon er dem Modell vorlegt. Manche Clients begrenzen, wie viele Werkzeuge sie auf einmal registrieren, und verwerfen den Rest. Wo das geschieht, verkürzt mcp.announce_tools das, was der Server ankündigt, auf die Werkzeuge, die Sie nennen — siehe Eingrenzen, was der Server ankündigt.

Ein über HTTPS erreichter Server

Jeder Eintrag oben startet den Server selbst. Ein Server, den jemand anderes betreibt — ein einzelner langlebiger Prozess auf einem Host, der einen Workspace bedient —, wird stattdessen über das Netzwerk erreicht, und sein Eintrag nennt eine Adresse statt eines Befehls:

{
"mcpServers": {
"aggrega": {
"url": "https://aggrega.example.com/mcp"
}
}
}

Der Pfad ist immer /mcp; der Host ist das, was der Operator für diesen Server veröffentlicht hat. Fragen Sie ihn danach. Gemini CLI nimmt die Adresse unter httpUrl statt unter url entgegen: url liest es als Server auf dem älteren Event-Stream-Transport und httpUrl als Server auf dem streamfähigen HTTP-Transport, den dieser Server spricht.

Ihr Client beschafft das Token, nicht Sie. Im Eintrag wird nichts zur Anmeldung konfiguriert: Der Server beantwortet eine nicht authentifizierte Anfrage, indem er das Dokument nennt, das angibt, welcher Autorisierungsserver seine Tokens ausstellt, und ein Client, der den Autorisierungsablauf des Protokolls spricht, liest dieses Dokument, leitet Sie zur Anmeldung weiter und hängt das erhaltene Token an jede spätere Anfrage an. Die Scope-Namen, die er anfordern kann, sind im selben Dokument veröffentlicht. Ein Client, der den Ablauf nicht implementiert, kann einen Server dieser Art nicht erreichen, und nichts, was Sie dem Eintrag hinzufügen, ersetzt ihn.

Ein Werkzeug, das die Scopes Ihrer Anmeldung nicht erreichen, steht trotzdem in der Werkzeugliste. Sein Aufruf wird abgelehnt, unter Nennung des Scopes, der ihn zulassen würde, und ein Client, der das Step-up des Protokolls implementiert, beantwortet diese Ablehnung, indem er Sie bittet, sich für diesen Scope erneut anzumelden. Einem Client ohne Step-up können die Schreib-Scopes dennoch gegeben werden: Wer den Autorisierungsserver betreibt, macht sie zu Standard-Scopes für diesen Client, sodass bereits seine erste Anmeldung sie trägt — um den Preis, dass dann jede Anmeldung über diesen Client Schreibzugriff trägt. Was ein Aufrufer erreichen darf legt dar, was jeder Scope zulässt und wie sich diese Einstellung bei einem Client verhält, der sich bei jeder Verbindung neu registriert.

Was ein solcher Server voraussetzt und was sein Betreiber konfiguriert, steht in der aggrega mcp-Referenz.

Die Verbindung überprüfen

Nachdem sich der Client neu verbunden hat, bestätigen Sie, dass die Integration aktiv ist: Der Client sollte die Prompts von Aggrega zum Verfassen (je einen für die Rollen Entwicklung, Architektur und Betrieb plus eine Vorlage pro Entität) und die Werkzeuge zum Verfassen auflisten — darunter scaffold, validate, describe und get-schema. Bitten Sie den Assistenten, ein Gerüst für eine Komponente zu erstellen, und er sollte ein Gerüst mit den Feldern zurückgeben, die eine Component verlangt. Erscheint nichts, prüfen Sie, ob aggrega version in einem Terminal läuft und ob das command des Clients auf die Binärdatei auflöst — der Hinweis zu PATH oben deckt die häufige Ursache ab.