Wolkenwald
PurePower Engine · Anbinden

MCP und KI-Assistenten

Jede Anlage der PurePower Engine ist von Haus aus ein MCP-Server. Unter /api/v1/mcp spricht sie das Model Context Protocol (JSON-RPC 2.0): Ein KI-Assistent wie Claude verbindet sich mit einem API-Schlüssel und arbeitet mit den Werkzeugen der installierten Plugins — Tickets anlegen, Wiki-Seiten lesen, Räume buchen — und zwar mit genau den Rechten des Kontos dahinter, nicht mehr.

MCP-Freigabe: Liste der anbietenden Plugins mit Zahl der Werkzeuge und Schalter im Betrieb

Die MCP-Freigabe: welche Plugins Werkzeuge anbieten, wie viele davon ein Konto sieht und ob das Plugin überhaupt im Betrieb ist.

Werkzeuge entstehen aus der Schnittstelle

Eine Werkzeugliste pflegt niemand von Hand. Jede Schnittstellen-Route eines Plugins, die einen Vertrag trägt (<contract> in der routes.xml), wird automatisch ein Werkzeug: Beschreibung, Parameter mit Typ und Pflichtangabe, Rückgabefelder und die Kennzeichnung „nur lesend“ oder „zerstörend“ kommen von dort. Das Rahmenwerk bietet seine eigenen Verwaltungsfunktionen auf dieselbe Weise an (Präfix pp_).

<route method='GET' path='/admin/api/v1/reservierung/ressourcen'
       handler='RessourcenListe' permission='reservierung:lesen'>
  <contract readonly='true' group='ressourcen'
            description='Buchbare Ressourcen (Räume, Geräte, Fahrzeuge), nach Name.'>
    <param name='art' type='string' desc='Nur diese Art: raum, geraet, fahrzeug, sonstiges.'/>
    <returns kind='json'>
      <field name='gesamt' type='integer' desc='Anzahl.'/>
    </returns>
  </contract>
</route>

Aus dieser Route wird das Werkzeug reservierung_ressourcen_liste.

  • Ein Plugin bietet Werkzeuge an, wenn es im Manifest <mcp prefix="…"/> erklärt.
  • Die Argumente werden vor dem Aufruf gegen den Vertrag geprüft; fehlt eine Pflichtangabe, kommt der Aufruf gar nicht erst an.
  • Zerstörende Werkzeuge verlangen confirm=true; ohne diese Bestätigung melden sie nur, was geschehen würde.
  • Fehler der Operation kommen als Ergebnis zurück, nicht als Protokollfehler — so sieht das Modell sie und kann sich berichtigen.
  • Jedes Werkzeug ist zugleich ein Knoten im Pipeline-Editor: dieselbe Route, derselbe Vertrag.

Zwei Tore: Plugin im Betrieb, Freigabe je Konto

Ein neu installiertes Plugin liefert keine Werkzeuge, nur weil es welche anbietet. Erst wenn es in der Verwaltung im Betrieb ist, erscheint es überhaupt im Katalog. Darunter entscheidet die Freigabe je Benutzer und je API-Schlüssel:

  • Drei Ebenen: ganzes Plugin, thematische Gruppe oder einzelnes Werkzeug — das Genauere gewinnt.
  • Drei Stufen: nur lesen, bearbeiten, auch löschen. Jede Zeile ist frei, gesperrt oder erbt.
  • Ohne Freigabe nichts: Ein Konto ohne passende Zeile sieht keine Werkzeuge des Plugins.
  • Geschnitten, nicht überboten: Ein Schlüssel kann enger sein als sein Benutzer, nie weiter.
  • Neues fällt auf: Bringt ein Plugin-Update neue Gruppen mit, sind sie markiert, bis jemand sie zur Kenntnis nimmt. Je Werkzeug wird gezählt, wie oft es benutzt wurde.
Freigabe der Gruppen eines Plugins für einen API-Schlüssel
Freigabe für einen einzelnen API-Schlüssel: je Gruppe frei, gesperrt oder geerbt, mit der Stufe nur lesen, bearbeiten oder auch löschen.

Wichtig ist, was die Freigabe nicht tut: Sie gibt keine Rechte. Der MCP-Server ruft die Route über den eigenen Webserver auf, mit dem Schlüssel des Aufrufers — dieselbe Anmeldung, dieselbe Rechteprüfung, dieselbe Ratenbremse wie im Browser. Ein Konto ohne Schreibrecht kann auch über MCP nicht schreiben. Einen zweiten Weg an der Rechteverwaltung vorbei gibt es nicht.

Hunderte Werkzeuge, kleiner Katalog

Eine Anlage mit vielen Plugins bietet schnell mehrere hundert Werkzeuge an. Damit der Assistent nicht schon vor der ersten Frage seinen Kontext füllt, lässt sich der Katalog auf drei Hilfswerkzeuge umstellen (Einstellung mcp.katalog_art = suchen): pp_werkzeuge findet die passenden Werkzeuge zu einer Aufgabe, pp_aufrufen ruft eines davon auf, pp_verzeichnis gibt die Übersicht. Freigabe, Rechte und Bestätigung gelten dabei unverändert.

Einen Assistenten verbinden

Ein MCP-Klient braucht nur die Adresse der Anlage und einen API-Schlüssel. Für Claude Code etwa:

{
  "mcpServers": {
    "meine-anlage": {
      "type": "http",
      "url": "https://anlage.example.ch/api/v1/mcp",
      "headers": { "Authorization": "Bearer pp_live_…" }
    }
  }
}

Den Schlüssel stellt man in der Verwaltung oder im eigenen Profil aus, mit Scopes und Ablaufdatum. Wie Schlüssel und Scopes funktionieren, steht unter REST-Schnittstellen.

Der eingebaute KI-Assistent

Auch ohne externen Klienten steht in der Verwaltung ein Assistent bereit: als Seitenleiste auf jeder Seite und mit Werkzeugen für Inhalte — Titel und Teaser vorschlagen, SEO-Beschreibung und SEO-Check, Zusammenfassen, Übersetzen, Text verbessern.

  • Anbieter: Ollama lokal, OpenAI, Anthropic, Mistral oder xAI. Die Anlage erkennt, ob Inhalte das Haus verlassen — ein lokales Modell auf dem eigenen Server behält alles intern.
  • Für Plugins: Ein Plugin darf das Sprachmodell nur nutzen, wenn ein Admin den Scope dafür freigegeben hat, nur im Namen eines angemeldeten Benutzers und mit einer Ratenbremse je Benutzer. Protokolliert wird jeder Aufruf, nie der Inhalt.
  • KI-Aktionen: Plugins hängen eigene Aktionen in die Seitenleiste, etwa im Ticket-System „Vorgang zusammenfassen“ und „Antwort vorschlagen“.
KI-Einstellungen mit Anbieter Ollama lokal
Anbieter und Modell des eingebauten Assistenten. Der Schlüssel eines Cloud-Anbieters wird serverseitig gespeichert und nie angezeigt.

Zurück zur PurePower Engine.

Kontakt

Fragen zu MCP und KI-Assistenten?

Wir zeigen es Ihnen gern oder beraten Sie zu Lizenz, Hosting und Betrieb.