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
| Berechtigung | Benö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(odermcp_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.“
| Spalte | Zeigt |
|---|---|
| App | Name und Host der App |
| Access | Read oder Read and change |
| Status | Connected, Disconnected oder Paused by the AI firewall |
| Connected | Wann Sie sie genehmigt haben |
| Last used | Ihr 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
- Öffnen Sie Connected apps.
- Wählen Sie Disconnect in der Zeile der App.
- 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
| Methode | Pfad | Wer | Funktion |
|---|---|---|---|
| GET | /api/mcp/grants | Jedes angemeldete Mitglied mit Connect MCP clients | Ihre verbundenen Apps: { data, total } |
| GET | /api/mcp/grants/all | Manage MCP settings | Alle Apps |
| DELETE | /api/mcp/grants/{grantId} | Der Eigentümer der App oder ein Administrator | Trennen: { "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
| Situation | Verwenden |
|---|---|
| Ein Assistent auf Ihrem eigenen Computer | Ein API-Schlüssel oder die Anmeldung, falls der Assistent sie anbietet |
| Ein gehosteter Assistent, der Konnektoren über eine Adresse hinzufügt | Die Anmeldung |
| Ein geplanter Agent oder ein Skript ohne Person | Ein API-Schlüssel, als Dienstschlüssel markiert, wenn er seinen Ersteller überdauern muss |
| Ein gemeinsamer Team-Assistent | Ein API-Schlüssel pro Assistent mit nur Leseberechtigungen; niemals die Anmeldung einer Person |

