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.
Die Seite „Funktionen“ öffnen
Abschnitt betitelt „Die Seite „Funktionen“ öffnen“- Gehe zu Admin → KI-Tools und öffne den Tab MCP.
- Öffne den MCP-Server.
- 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.
Genehmigungsmodi
Abschnitt betitelt „Genehmigungsmodi“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. |
Nutzer selbst genehmigen lassen
Abschnitt betitelt „Nutzer selbst genehmigen lassen“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 vielen Funktionen arbeiten
Abschnitt betitelt „Mit vielen Funktionen arbeiten“- 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.
Standardwerte und was du beachten solltest
Abschnitt betitelt „Standardwerte und was du beachten solltest“- 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
Abschnitt betitelt „Funktionen aktualisieren“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.
Wie Einstellungen im Audit-Log erscheinen
Abschnitt betitelt „Wie Einstellungen im Audit-Log erscheinen“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.
Einstellungen ändern
Abschnitt betitelt „Einstellungen ändern“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 immermcp, 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.
Funktionen ausführen
Abschnitt betitelt „Funktionen ausführen“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.
Was das Log nicht erfasst
Abschnitt betitelt „Was das Log nicht erfasst“- 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.