--- description: "Der AO Hub ist die Heimat der Registry bekannter MCP-Server (Model Context Protocol)." --- # AO Hub Der **AO Hub** ist die Heimat der Registry bekannter MCP-Server (Model Context Protocol) – ein durchsuch- und filterbarer Katalog darüber, was es gibt, was jeder Server erreichen kann und wie riskant es ist, ihn einem autonomen Agenten zu überlassen. > Diese Seite ist die **Registry** – der Tab **MCPs**: entdecken, pflegen und prüfen. Der Katalog selbst ändert nie, was ein laufender Agent erreichen kann; das passiert erst, wenn du einem Agenten einen Server hinzufügst (siehe *Aus dem Katalog einem Agenten zuweisen* weiter unten). ## Die AO-Hub-Seite Seitenleiste → **AO Hub** → Tab **MCPs**. Die Liste führt zwei Arten von Einträgen zusammen: - **Mitgelieferte Definitionen** – ein kuratierter Katalog, der mit dem Produkt ausgeliefert wird (Filesystem, Git, GitHub, GitLab, Postgres, Slack, Notion, Linear, Sentry und mehr). Diese sind global: Jeder Workspace sieht sie. - **Workspace-Definitionen** – Einträge, die dein Workspace-Administrator erstellt hat, einschließlich **Anpassungen** mitgelieferter Definitionen. Eine Workspace-Definition mit demselben Slug wie eine mitgelieferte **ersetzt sie** nur für diesen Workspace – andere Workspaces behalten den mitgelieferten Eintrag. ### Filter Filtere nach **Kategorie**, **Transport** (`stdio` / `http`), **Risikostufe** (`low` / `medium` / `high` / `critical`) oder per Freitext-**Suche** über Name, Anbieter, Slug, Beschreibung und Tags. Die Filter-Dropdowns bieten immer jeden im Katalog vorhandenen Wert an, auch während ein Filter aktiv ist. `%` und `_` im Suchfeld werden als normale Zeichen behandelt, nicht als Platzhalter. ### Sortierung Klicke auf eine beliebige Spaltenüberschrift (Server, Kategorie, Risiko, Transport, Tools, Quelle, Aktualisiert), um danach zu sortieren; ein erneuter Klick kehrt die Reihenfolge um. Die aktive Spalte trägt einen Pfeil für auf-/absteigend; die Sortierung bleibt erhalten, wenn du Filter änderst oder die Liste neu lädst. ### Einen Eintrag lesen - **Risikostufe** ist das prominenteste Feld – ein Badge „Verifiziert“ ist eine Aussage über die Urheberschaft, niemals eine Garantie, dass ein Server mit hohem Risiko sicher ist. - **Tools** listet auf, was der Server voraussichtlich bereitstellt, jeweils mit eigener Risikostufe. - **Zugangsdaten** zeigt die *Form* dessen, was ein Mensch später angeben muss (z. B. `Authorization: Bearer `). Eine Definition enthält nie echte Zugangsdaten. ## Erstellen und Pflegen (Administratoren) **Definition hinzufügen** öffnet den Editor. Wähle einen Transport: - **stdio** – Startbefehl plus Argumente (z. B. `npx -y @some/mcp-server`). - **http** – eine URL. Alles Übrige ist beschreibend: Anbieter, Kategorie, Links zu Homepage/Doku, die erwartete Tool-Liste, Vorlagen für Zugangsdaten, Tags, Risikostufe und ob der Eintrag verifiziert ist. ### Geltungsbereich Workspace vs. Instanz Standardmäßig ist eine von dir erstellte Definition **privat für diesen Workspace**. Wer die instanzweite Berechtigung **MCP-Registry** hat (verwaltet von einem System-Administrator unter Globale Einstellungen → Benutzerverwaltung), kann stattdessen mit `scope: instance` veröffentlichen, wodurch der Eintrag in **jedem** Workspace der Instanz sichtbar wird. ### Bearbeiten und Versionen - **Eine mitgelieferte Definition bearbeiten** ist nicht direkt möglich – erstelle stattdessen eine Workspace-Anpassung (die Oberfläche bietet das an; die Anpassung merkt sich, wovon sie abgeleitet wurde). - Eine **Version** wird immer dann festgehalten, wenn sich die *Reichweite* ändert – Transport, Befehl/Argumente/URL, Vorlagen für Zugangsdaten oder die Tool-Liste. Eine umformulierte Beschreibung, neue Tags oder eine geänderte Risikostufe erzeugen **keine** Version: Der Verlauf beantwortet „Was könnte ein Agent erreichen?“, nicht „Wie war es formuliert?“. - **Der Slug ist dauerhaft.** Er ist der stabile Schlüssel, auf den sich eine spätere Verbindung festlegt; das Umbenennen einer Definition ändert nur den Anzeigenamen. ### Wiederherstellen und löschen - **Wiederherstellen** (angeboten bei Anpassungen mitgelieferter Einträge) verwirft die Kopie des Workspace – der mitgelieferte Eintrag erscheint sofort wieder. - **Löschen** entfernt einen Eintrag, der dem Workspace gehört. Wenn er einen mitgelieferten überdeckt hat, ist der mitgelieferte Eintrag sofort wieder sichtbar. Mitgelieferte und instanzweit geteilte Einträge lassen sich nicht von einer Workspace-Seite aus löschen. ## Audit Jede Änderung – Erstellen, Aktualisieren, Löschen, Wiederherstellen – wird im **Audit-Log** des Workspace festgehalten, mit dem handelnden Benutzer, der Definition und dem Änderungshinweis. ## Für API-Aufrufer Die Registry ist auch per REST verfügbar: `GET/POST/PATCH/DELETE /api/v1/workspaces/{id}/mcp-definitions` (plus `POST …/{id}/restore`). Jede Änderung liefert die gesamte zusammengeführte Liste zurück, sodass ein Client nie ein zweites Mal lesen muss. Siehe die API-Referenz → „MCP Hub — server-definition registry“. ## Aus dem Katalog einem Agenten zuweisen Das Durchsuchen endet dort, wo ein Agent beginnt: Auf dem Tab **MCP-Server** eines beliebigen Agenten öffnet **„Aus Katalog hinzufügen“** eine Auswahl über genau diese Registry. Wählst du einen Eintrag aus, füllt er den Dialog „MCP-Server hinzufügen“ vor – Name, Transport, Befehl/Argumente oder URL, Umgebungsschlüssel aus den Zugangsdaten-Vorlagen der Definition, Header-Namen – und du trägst die Werte (API-Schlüssel, Tokens) selbst ein; der Katalog enthält immer nur die *Form* dessen, was anzugeben ist, nie einen Wert. Die gespeicherte Serverzeile merkt sich ihre Herkunft: Auf der Karte ist sie mit **„Aus Katalog“** markiert, und die Zuweisung wird im Audit-Log des Workspace festgehalten (`mcp.assigned`). Wenn du einen aus dem Katalog zugewiesenen Server später bearbeitest (z. B. um ein Token zu rotieren), geht diese Herkunft nie verloren; auch das Löschen der Definition, aus der er stammt, bricht die funktionierende Serverzeile nie. Beachte, was das *noch nicht* bedeutet: Die Zeile erreicht weiterhin alles, was ihr Befehl/ihre URL vorgibt, genau wie ein von Hand konfigurierter Server – Durchsetzung pro Tool, Freigaben und Aufruf-Auditierung sind die nächsten Phasen (Verbindungen/Zugangsdaten, danach Governance).