Ein KI-Assistent greift auf die MCP-Server Ihrer Organisation auf zwei Arten zu: mit einem API-Schlüssel oder als App, die Sie mit einer Anmeldung verbunden haben. Diese Seite zeigt, wie Sie beide sicher einrichten und den Zugriff wieder 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 angelegt wird. Siehe Authentication.
Was angehakt werden muss
| 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 abgelehnt, unabhängig von seinen übrigen 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 bei seinem nächsten Aufruf.
Empfohlene Vorgehensweise
- 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 rotieren.
- 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 an der REST-API.
- Den Schlüssel nicht in gemeinsamen Dateien ablegen. Konfigurationsdateien von Assistenten werden häufig synchronisiert oder committet; speichern Sie den Schlüssel im Geheimnisspeicher des Assistenten oder in einer Umgebungsvariable, sofern dies unterstützt wird.
Schlüssel überwachen 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(bzw.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 oder ersetzt den Zugriff sofort. Siehe Authentication.
- Die KI-Firewall erfasst Vorfälle mit auffälligen Schlüsseln. Ihre Maßnahmen (Drosselung oder Abschalten eines Schlüssels) sind in Entwicklung.
Verbundene Apps
Eine App, die Sie mit einer Anmeldung verbunden haben, steht unter Connected apps (im Bereich Developer des Menüs): „KI-Apps, die Sie mit einer Anmeldung mit diesem Workspace verbunden haben. Eine Trennung beendet den Zugriff 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 (mit Manage MCP settings) können zwischen Mine und Everyone (admins) wechseln, um die Apps aller Mitglieder zu sehen.
App trennen
- Öffnen Sie Connected apps.
- Wählen Sie in der Zeile der App Disconnect.
- Bestätigen Sie Disconnect this app?: „
verliert sofort den Zugriff auf diesen Workspace. Um sie erneut zu nutzen, verbinden Sie sie neu.“
Der nächste Aufruf der App wird mit 401 abgelehnt. 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 (dann neu verbinden),
- wenn sein Refresh-Token zweimal verwendet wird, was auf ein Kopieren hindeuten kann (die Verbindung wird widerrufen und das Ereignis mit hohem Schweregrad protokolliert),
- wenn die Person, die sie verbunden hat, kein aktives Mitglied mehr ist.
Von der KI-Firewall pausiert
In Entwicklung: Die Maßnahmen der KI-Firewall, einschließlich des Pausierens einer verbundenen App, sind in Entwicklung. Derzeit erfasst die Firewall nur Vorfälle; siehe AI firewall.
Wenn diese Maßnahme freigegeben wird, wird eine pausierte App bei jedem Aufruf für bis zu 7 Tage abgelehnt, und ihr Status zeigt Paused by the AI firewall. Falls Sie diesen Status sehen und ihn nicht erwartet haben, trennen Sie die App und prüfen Sie das Audit-Log, bevor Sie sie erneut verbinden.
Über HTTP
| Methode | Pfad | Wer | Macht |
|---|---|---|---|
| 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 akzeptieren page (ab 0), pageSize (Standard 20, höchstens 100), search (App-Name oder Host), sort und status (active, suspended, revoked). Pfade liegen unter https://<your host>/tenant/<tenantId>.
Welche Variante Sie wählen sollten
| Situation | Verwenden |
|---|---|
| Ein Assistent auf Ihrem eigenen Computer | Ein API-Schlüssel oder die Anmeldung, falls der Assistent sie anbietet |
| Ein gehosteter Assistent, der Connectoren über eine Adresse hinzufügt | Die Anmeldung |
| Ein geplanter Agent oder ein Skript ohne Person | Ein API-Schlüssel, als Service-Schlüssel markiert, wenn er seinen Ersteller überdauern muss |
| Ein gemeinsam genutzter Team-Assistent | Je ein API-Schlüssel pro Assistent mit nur Leseberechtigungen; niemals die Anmeldung einer Person |