Grundsätze
Plugin-Tools können auf Nutzerdaten und APIs von Drittanbietern zugreifen und Schreibaktionen ausführen. Behandle jeden MCP-Server und jede UI-Komponente wie Software für den Produktivbetrieb.
- Prinzip der geringsten Rechte: Fordere nur die Scopes und die Berechtigungen für Speicher- und Netzwerkzugriffe an, die du brauchst.
- Ausdrückliche Einwilligung: Sorge dafür, dass alle, die dein Plugin nutzen, erkennen, wann sie Konten verknüpfen oder Schreibzugriff gewähren. Nutze für destruktive Aktionen die Bestätigungsdialoge des Hosts.
- Mehrstufiger Schutz: Rechne damit, dass dein Server mit Prompt Injection und bösartigen Eingaben konfrontiert wird. Prüfe jede Eingabe und führe Audit-Protokolle.
Umgang mit Daten
- Strukturierte Inhalte: Gib nur die Daten mit, die für den aktuellen Prompt erforderlich sind. Vermeide es, Secrets oder Token in Komponenten-Props einzubetten.
- Speicherung: Lege fest, wie lange du Nutzerdaten aufbewahrst, und veröffentliche eine Aufbewahrungsrichtlinie. Komm Löschanfragen nach.
- Protokollierung: Entferne oder maskiere Angaben, die Personen identifizierbar machen, bevor du sie protokollierst. Speichere Korrelations-IDs für die Fehlersuche. Speichere den Wortlaut von Prompts nur, wenn es erforderlich ist.
Prompt Injection und Schreibaktionen
Eigene MCP-Server ermöglichen den vollständigen Zugriff auf MCP, einschließlich der Tools mit Schreibzugriff. Mit folgenden Maßnahmen senkst du das Risiko:
- Prüfe Tool-Beschreibungen regelmäßig und weise darin auf unzulässige Verwendungen hin („Nicht zum Löschen von Datensätzen verwenden“).
- Validiere alle Eingaben auf dem Server, auch wenn sie vom Modell stammen.
- Verlange bei irreversiblen Vorgängen die Bestätigung durch einen Menschen.
Teile deine besten Prompts zum Testen von Prompt Injection mit deinem QA-Team, damit es frühzeitig nach Schwachstellen suchen kann.
Netzwerkzugriff
Widgets laufen in einem isolierten iframe mit einer strengen Content Security Policy (CSP). Sie können nicht auf privilegierte Browser-APIs wie window.alert, window.prompt, window.confirm oder navigator.clipboard zugreifen. Die CSP regelt gewöhnliche fetch-Anfragen. Verschachtelte Frames sind standardmäßig deaktiviert. Gib einzelne Origins in den CSP-Metadaten der Ressource frei, etwa in _meta.ui.csp.frameDomains. Plugins können Seiten aus der eigenen registrierbaren Domain ihres MCP-Servers einbetten, darunter auch vorhandene Editoren und Verwaltungsoberflächen. Die Richtlinie für iframes erläutert, wem die Domain gehören muss, welche Begründungen erforderlich sind und welche Anforderungen für die Prüfung gelten.
Die CSP des Widgets legt fest, welche Ziele ein iframe laden darf. Für eine eingebettete Seite gilt deren eigene CSP. Die Freigabelisten connectDomains und resourceDomains des Widgets schränken Netzwerkanfragen innerhalb dieser Seite nicht ein. Gib für iframes nur konkrete Origins an und beziehe die eingebetteten Inhalte und Funktionen in deine Sicherheitsprüfung ein.
Für serverseitigen Code gelten nur die Netzwerkbeschränkungen deiner Hosting-Umgebung. Halte dich bei ausgehenden Anfragen an bewährte Verfahren für die TLS-Prüfung, Wiederholungsversuche und Timeouts.
Authentifizierung und Autorisierung
- Verwende beim Einbinden externer Konten den Authorization Code Flow von OAuth 2.1. Bevorzuge Client ID Metadata Documents (CIMD), wenn dein Autorisierungsserver CIMD unterstützt und sich die Person, die das Plugin erstellt, dafür entscheidet. Verwende
nonefür den Token-Austausch bei öffentlichen Clients oderprivate_key_jwt, wenn dein Autorisierungsserver eine Client-Authentifizierung verlangt. Unterstütze DCR, wenn die Person, die das Plugin erstellt, DCR auswählt oder wenn CIMD nicht verfügbar ist. - Prüfe bei jedem Tool-Aufruf die Scopes und setze die damit verbundenen Zugriffsbeschränkungen durch. Antworte bei abgelaufenen oder fehlerhaft formatierten Token mit dem Statuscode
401. - Wenn du die integrierte Identitätsfunktion nutzt, vermeide es, langlebige Secrets zu speichern. Verwende stattdessen den bereitgestellten Authentifizierungskontext.
Vorbereitung auf den Betrieb
- Führe vor dem Start Sicherheitsprüfungen durch, insbesondere wenn du Daten verarbeitest, die regulatorischen Vorgaben unterliegen.
- Achte auf ungewöhnliche Muster im Netzwerkverkehr und richte Warnmeldungen für wiederholte Fehler oder fehlgeschlagene Authentifizierungsversuche ein.
- Halte Drittanbieterabhängigkeiten, Bibliotheken und Build-Tools mit Patches auf dem aktuellen Stand, um Risiken in der Software-Lieferkette zu verringern.
Sicherheit und Datenschutz sind entscheidend für das Vertrauen der Menschen, die dein Plugin nutzen. Berücksichtige beides von Anfang an bei der Planung, Umsetzung und Bereitstellung.