Zum Inhalt springen
Service status

Tippen, um zu suchen

MCP-Server · 6 Min. Lesezeit

Funktionen eines MCP-Servers und das Audit-Log

Lege fest, welche Funktionen eines MCP-Servers laufen dürfen und ob sie eine Genehmigung brauchen, und sieh nach, wie jede Einstellung im Audit-Log erscheint.

Verbindet sich Intric mit einem MCP-Server, liest Intric aus, was der Server kann: eine Liste seiner Tools. In Intric heißen diese Tools Funktionen. Auf der Seite Funktionen legst du für jede Funktion fest, ob sie überhaupt laufen darf und ob jemand jeden einzelnen Aufruf genehmigen muss. Diese Einstellung bestimmt auch, was das Audit-Log später festhält. Manche Einstellungen hinterlassen zu jedem Aufruf einen Eintrag, andere gar keinen.

Nur Admins der Organisation können diese Einstellungen ändern. Wie du einen Server überhaupt erst einrichtest, erfährst du unter Eigenen MCP-Server mit Intric verbinden. Wie sich die Genehmigungsmodi in die übrigen KI-Tools einfügen, steht unter KI-Tools.

  1. Gehe zu Admin → KI-Tools und öffne den Tab MCP.
  2. Öffne den MCP-Server.
  3. Klicke unter Funktionen und Berechtigungen auf Funktionen.

Schon bevor du die Zeile öffnest, zeigt sie eine Zusammenfassung, etwa 12 Tools · 3 automatisch. Steht dort Nicht abgerufen, hat Intric die Liste des Servers noch nicht gelesen. Mit Funktionen aktualisieren holst du sie ab.

Hier am Beispiel der Outlook-Integration. Bei einem MCP-Server bedienst du die Seite „Funktionen“ genauso.

Jede Funktion steht mit ihrem Namen in der Liste, dazu die Beschreibung, die der Server liefert. Beides stammt vom Server, deshalb kannst du es in Intric nicht bearbeiten. Neben jeder Funktion sitzt ein Schalter mit drei Stellungen:

Modus Was in einer Unterhaltung passiert
Aus Der Assistent erfährt nicht, dass es die Funktion gibt, und kann sie deshalb nicht nutzen.
Fragen Vor jedem Aufruf sieht der Nutzer, was der Assistent an das Tool senden will, und wählt Genehmigen oder Ablehnen.
Auto Die Funktion läuft sofort, ohne den Nutzer zu fragen.

Ist Fragen gewählt, kannst du zusätzlich Nutzende können die automatische Genehmigung aktivieren anhaken. Die Genehmigungskarte bietet dann zwei weitere Optionen:

  • Für diesen Assistenten immer erlauben: Intric fragt diesen Nutzer nicht mehr, bevor die Funktion läuft, wenn er mit genau diesem Assistenten chattet.
  • Überall immer erlauben: Intric fragt diesen Nutzer in keiner seiner Unterhaltungen mehr, bevor die Funktion läuft.

Der Nutzer muss seine Wahl zuerst bestätigen, und sie gilt nur für ihn selbst. Aufrufe, die darunter fallen, kennzeichnet Intric in der Unterhaltung als Automatisch genehmigt.

Hinweis: Hat ein Nutzer eine automatische Genehmigung einmal erteilt, kann er sie derzeit nicht zurücknehmen. Als Admin stoppst du alle diese Genehmigungen für eine Funktion, indem du sie auf Fragen ohne Häkchen oder auf Aus stellst. Intric behält die Genehmigungen allerdings. Setzt du das Häkchen wieder, gelten sie erneut.

  • Mit dem Suchfeld und dem Filter Alle / Aus / Fragen / Auto findest du eine Funktion. Die Zeile über der Liste zählt, wie viele Funktionen in jedem Modus stehen.
  • Alle … setzen auf Aus / Fragen / Auto ändert jede Funktion des Servers. Eine Suche oder ein Filter, den du gesetzt hast, spielt dabei keine Rolle.
  • Deine Änderungen greifen erst, wenn du speicherst. Fertig bringt dich zurück zum Panel des Servers, und dort klickst du auf Änderungen speichern. Zurücksetzen verwirft, was du auf der Seite „Funktionen“ geändert hast.
  • Neue Funktionen starten auf Fragen. Ausnahme: Eine Funktion, die laut Server keine Genehmigung braucht, startet auf Auto.
  • Schaltest du den Server ein, fällt jede Funktion auf ihren Standardwert zurück. Schaltest du einen MCP-Server aus und wieder ein, verlieren alle Funktionen die Einstellung, die du selbst gewählt hast. Überprüfe deshalb die Seite „Funktionen“, nachdem du einen Server wieder eingeschaltet hast.
  • Du kannst Einstellungen nur ändern, solange der Server eingeschaltet ist.
  • Ist keine Funktion mehr eingeschaltet, schaltet sich der Server selbst aus. Stellst du alle Funktionen auf Aus, kann das den ganzen Server abschalten.
  • Einstellungen hängen am Namen der Funktion. Benennt der Server ein Tool um, behandelt Intric es als neue Funktion mit Standardwert. Verschwindet eine Funktion und taucht später unter demselben Namen wieder auf, bekommt sie ihre alte Einstellung zurück.
  • Ressourcen und Prompts stehen nicht in der Liste. Ein MCP-Server kann mehr als Tools anbieten: Ressourcen (Inhalte, die der Assistent lesen kann) und Prompts. Intric nutzt beides, auf dieser Seite erscheinen sie aber nicht. Sie laufen automatisch, außer der Server verlangt für sie eine Genehmigung.
  • Der Modus gilt überall gleich. Kein Space und kein Assistent kann den Modus einer Funktion überschreiben. Assistenten fügen immer den ganzen Server hinzu oder entfernen ihn. Auch die Sicherheitsklassifizierung gilt für den ganzen Server und nicht für einzelne Funktionen.

Funktionen aktualisieren fragt beim Server die aktuelle Liste ab und ersetzt damit die Liste, die Intric gespeichert hat. Intric aktualisiert auch von selbst, sobald du eine neue Server-URL speicherst oder ein OAuth-Konto verbindest. In drei Fällen steht die Schaltfläche nicht zur Verfügung:

  • Der Server ist ausgeschaltet.
  • Im Panel des Servers gibt es ungespeicherte Änderungen an der Verbindung.
  • Der Server nutzt OAuth, und du hast dein Konto noch nicht verbunden.

Das Audit-Log zeigt jeden Eintrag unter seinem technischen Ereignisnamen, zum Beispiel TOOL_UPDATE. Öffne einen Eintrag, um alle Details zu sehen. Dort findest du seine Daten, und genau diese Daten enthält auch der CSV-Export.

Speicherst du Änderungen auf der Seite „Funktionen“, hält das Log einen Eintrag TOOL_UPDATE fest. Dasselbe Ereignis entsteht, wenn du festlegst, ob der Server für die Organisation verfügbar ist, oder wenn du seine Sicherheitsklassifizierung änderst.

  • Akteur: der Admin, der gespeichert hat.
  • Ressource: Typ MCPTool. Als Ressourcenname steht dort immer mcp, nicht der Name des Servers. Server unterscheidest du deshalb an der Ressourcen-ID.
  • Details: alter und neuer Wert von allem, was sich geändert hat. Die Einstellung einer Funktion sieht so aus:
"llm_tool_settings": { "items": { "search_documents": "auto_approve" } }

Diesen Wert speichert Intric für jeden Modus:

Auf der Seite „Funktionen“ Im Audit-Log
Aus denied
Fragen ask
Fragen + Nutzende können die automatische Genehmigung aktivieren consent_allowed
Auto auto_approve

Änderungen am Server selbst protokolliert Intric getrennt davon. Bei MCP_SERVER_CREATE, MCP_SERVER_UPDATE und MCP_SERVER_DELETE ist der Name des Servers die Ressource. MCP_SERVER_UPDATE hält fest, welche Felder sich geändert haben, etwa die URL oder credentials bei einem API-Schlüssel oder Client-Secret. Die neuen Werte stehen nicht darin.

Jedes Mal, wenn ein Assistent eine Funktion nutzt, bestimmt der Modus, was im Log landet:

Modus Was der Nutzer getan hat Im Log als
Aus — Nichts. Die Funktion kann nicht laufen.
Fragen Auf Genehmigen geklickt TOOL_USE_APPROVE
Fragen Auf Ablehnen geklickt oder statt einer Antwort eine neue Nachricht geschickt TOOL_USE_REJECT
Fragen + Nutzende können die automatische Genehmigung aktivieren Für diesen Assistenten immer erlauben oder Überall immer erlauben gewählt TOOL_AUTO_APPROVE_CONSENT_GRANT und TOOL_USE_APPROVE
Fragen + Nutzende können die automatische Genehmigung aktivieren Nichts: Ein früheres „immer erlauben“ deckte den Aufruf ab TOOL_USE_AUTO_APPROVE
Auto Nichts. Die Funktion lief ohne Nachfrage. Nichts

Die Einträge für Genehmigung, Ablehnung und automatische Genehmigung hängen an der Unterhaltung. Sie enthalten den Namen der Funktion und genau das, was der Assistent an sie geschickt hat. Den Namen des Servers und die Antwort des Tools enthalten sie nicht. TOOL_AUTO_APPROVE_CONSENT_GRANT hält fest, ob die Genehmigung für einen Assistenten oder überall gilt, und für welchen Assistenten.

Hinweis: TOOL_USE_AUTO_APPROVE und TOOL_AUTO_APPROVE_CONSENT_GRANT erscheinen im Log, der Ereignisfilter bietet sie aber noch nicht an. Um sie zu finden, filtere nach Nutzer oder Zeitraum, oder durchsuche den CSV-Export.

  • Aufrufe von Funktionen auf Auto sowie Aufrufe von Ressourcen und Prompts, die automatisch laufen.
  • Genehmigungen und Ablehnungen in Läufen eines Plans. Ein dort erteiltes „immer erlauben“ landet trotzdem im Log.
  • Funktionen aktualisieren, egal ob du es gestartet hast oder Intric es von selbst ausgeführt hat.
  • Das Verbinden und Trennen eines OAuth-Kontos sowie Verbindungsprüfungen.
  • Was das Tool zurückgeschickt hat.

Brauchst du zu jedem Aufruf einer Funktion einen Eintrag, nimm Fragen und nicht Auto. Auch Fragen mit Nutzende können die automatische Genehmigung aktivieren hält jeden Aufruf fest. Nach dem ersten „immer erlauben“ eines Nutzers erscheinen dessen Aufrufe aber als TOOL_USE_AUTO_APPROVE und nicht als Genehmigung.