Neu: Die KI-Firewall überwacht die gesamte Plattform und erklärt jeden Vorfall in einfachen Worten. So funktioniert es

MCP-Schlüssel und verbundene Apps

Geben Sie einem KI-Assistenten einen API-Schlüssel nur mit den MCP- und Leseberechtigungen, die er braucht, und sehen und trennen Sie verbundene Apps.

Ein KI-Assistent erreicht die MCP-Server Ihrer Organisation auf einem von zwei Wegen: mit einem API-Schlüssel oder als App, die Sie mit einer Anmeldung verbunden haben. Diese Seite zeigt, wie Sie jeden Weg sicher einrichten und den Zugriff beenden. Die Schritte zur Verbindung finden Sie unter Connect an AI assistant.

MCP-Schlüssel

Es gibt keine eigene Art von MCP-Schlüssel. Ein MCP-Schlüssel ist ein gewöhnlicher API-Schlüssel mit der Berechtigung Connect MCP clients (mcp_server.connect), der wie jeder andere unter API Keys erstellt wird. Siehe Authentication.

Was Sie auswählen

BerechtigungBenötigt für
Connect MCP clients (Gruppe MCP)Zugriff auf überhaupt einen MCP-Server
View devices (iot_device.devices.read)list_devices, get_device
Telemetrie lesen (telemetry.read)get_latest_readings, get_reading_series

Verwenden Sie die Voreinstellungen Read only der Module; mehr ist nicht nötig. Ein Schlüssel mit Connect MCP clients, aber ohne die Berechtigung eines Tools, sieht dieses Tool nicht. Ein Schlüssel ohne Connect MCP clients wird von jedem MCP-Server abgewiesen, unabhängig von allen anderen Berechtigungen.

Jedes Tool läuft nur, solange sowohl der Schlüssel als auch dessen Inhaber die Berechtigung des Tools besitzen. Verliert der Inhaber eine Berechtigung, verliert der Assistent das Tool beim nächsten Aufruf.

Bewährte Praxis

  • Ein Schlüssel pro Assistent und Person. Benennen Sie ihn so, dass Sie erkennen, wer ihn nutzt: „Desktop-Assistent – Alex“.
  • Kurze Gültigkeit. 30 bis 90 Tage, danach erneuern.
  • IP-Allowlist, wenn der Assistent auf einem festen Server läuft.
  • Keine weiteren Berechtigungen. Ein MCP-Schlüssel mit zusätzlichen Berechtigungen funktioniert damit auch über die REST-API.
  • Schlüssel nicht in gemeinsamen Dateien ablegen. Konfigurationsdateien von Assistenten werden oft synchronisiert oder committet; speichern Sie den Schlüssel im Geheimnisspeicher des Assistenten oder, wo möglich, in einer Umgebungsvariable.

Schlüssel beobachten und beenden

  • Die Seite des Schlüssels zeigt Last used, Last used IP und Total verifications.
  • Jeder Tool-Aufruf steht im Audit-Log als mcp_server.tool.called (oder mcp_server.tool.refused), mit dem Schlüssel als Akteur, dem Tool, dem Ergebnis und der Dauer.
  • Deactivate, Revoke oder Rotate key auf der Seite des Schlüssels beendet bzw. ersetzt den Zugriff sofort. Siehe Authentication.
  • Die AI-Firewall protokolliert Vorfälle zu Schlüsseln, die sich auffällig verhalten, und kann einen solchen Schlüssel drosseln oder widerrufen.

Verbundene Apps

Eine App, die Sie mit einer Anmeldung verbunden haben, wird unter Connected apps (im Bereich Developer des Menüs) aufgeführt: „KI-Apps, die Sie mit einer Anmeldung mit diesem Arbeitsbereich verbunden haben. Eine Trennung stoppt sie sofort.“

SpalteZeigt
AppName und Host der App
AccessRead oder Read and change
StatusConnected, Disconnected oder Paused by the AI firewall
ConnectedWann Sie sie genehmigt haben
Last usedIhr letzter Aufruf

Verwenden Sie Search app or host…, um eine App zu finden. Administratoren (die Manage MCP settings besitzen) können zwischen Mine und Everyone (admins) wechseln, um die Apps aller Mitglieder zu sehen.

App trennen

  1. Öffnen Sie Connected apps.
  2. Wählen Sie Disconnect in der Zeile der App.
  3. Bestätigen Sie Disconnect this app?: „App-Name verliert sofort den Zugriff auf diesen Arbeitsbereich. Um sie erneut zu nutzen, verbinden Sie sie neu.“

Der nächste Aufruf der App wird mit 401 abgewiesen. Mitglieder können ihre eigenen Apps trennen; Administratoren können die Apps aller trennen. Zum Trennen ist eine angemeldete Person nötig: Ein API-Schlüssel kann das nicht.

Eine Verbindung endet außerdem:

  • nach 90 Tagen (verbinden Sie sie dann neu),
  • wenn ihr Refresh-Token zweimal verwendet wird, was bedeuten kann, dass es kopiert wurde (die Verbindung wird widerrufen und das Ereignis mit hohem Schweregrad protokolliert),
  • wenn die Person, die sie verbunden hat, kein aktives Mitglied mehr ist.

Über HTTP

MethodePfadWerFunktion
GET/api/mcp/grantsJedes angemeldete Mitglied mit Connect MCP clientsIhre verbundenen Apps: { data, total }
GET/api/mcp/grants/allManage MCP settingsAlle Apps
DELETE/api/mcp/grants/{grantId}Der Eigentümer der App oder ein AdministratorTrennen: { "revoked": true }

Listen nehmen page (ab 0), pageSize (Standard 20, höchstens 100), search (App-Name oder Host), sort und status (active, suspended, revoked) entgegen. Pfade liegen unter https://<your host>/tenant/<tenantId>.

Welcher Weg der richtige ist

SituationVerwenden
Ein Assistent auf Ihrem eigenen ComputerEin API-Schlüssel oder die Anmeldung, falls der Assistent sie anbietet
Ein gehosteter Assistent, der Konnektoren über eine Adresse hinzufügtDie Anmeldung
Ein geplanter Agent oder ein Skript ohne PersonEin API-Schlüssel, als Dienstschlüssel markiert, wenn er seinen Ersteller überdauern muss
Ein gemeinsamer Team-AssistentEin API-Schlüssel pro Assistent mit nur Leseberechtigungen; niemals die Anmeldung einer Person