MCP-Sicherheit

Lege klare Grenzen für Kontoberechtigungen, die Ausgabe geheimer Daten und die Offenlegung von Inhalten fest, bevor du eine Lokalisierungsaufgabe delegierst.

Gib einem Assistenten den Zugriff, den er für die Aufgabe braucht, und ziehe eine klare Grenze zwischen Einsichtnahme und Änderungen. MCP-Tools greifen mit den Zugangsdaten deines Kontos zu und können über ihre Ergebnisse Inhalte offenlegen – auch wenn bei der Aufgabe nichts geändert wird.

Erlaube bei der Untersuchung einer Übersetzung zunächst nur Lesezugriffe auf die relevante Konfiguration und die betreffenden Anfragen. Stimme bei einer Korrektur ab, welche Ressource geändert werden soll und welche Auswirkungen das hat, bevor du den Schreibzugriff aktivierst. Clientseitige Freigaben und Zulassungslisten können diese Grenze zusätzlich absichern. Die Angabe „schreibgeschützt“ in einem Prompt entzieht den Zugangsdaten jedoch nicht die Schreibberechtigung.

Kontozugangsdaten #

Der gehostete Server unter https://mcp.lingo.dev/mcp authentifiziert ein OAuth-Benutzerzugriffstoken, das im Header Authorization: Bearer übermittelt wird. Das Token identifiziert die angemeldete Person. Die Verbindung erstellt weder einen dauerhaften persönlichen API-Schlüssel noch legt sie eine bestimmte Organisation fest.

Der Client verwaltet die Zugriffs- und Aktualisierungszugangsdaten der OAuth-Verbindung. Bewahre sie im dafür vorgesehenen Zugangsdaten-Speicher des Clients auf – nicht in der Projektkonfiguration, in Prompts oder in Diagnoseausgaben. Fehlt das Benutzertoken, ist es abgelaufen oder ungültig, wird 401 zurückgegeben, damit der Client die Autorisierung starten oder erneuern kann.

Der gehostete Server akzeptiert Lingo.dev-API-Schlüssel weder über x-api-key noch als Bearer-Token.

Rufe members_listMemberships auf, um die Organisationen zu ermitteln, auf die die angemeldete Person zugreifen kann. Übergib anschließend die gewünschte ID ausdrücklich im jeweils vorgesehenen Feld an jedes Tool auf Organisationsebene. Über eine Verbindung können mehrere Organisationen erreichbar sein. Behalte die ausgewählte ID deshalb während der gesamten Aufgabe bei. Tools auf Objektebene ermitteln den Zugriff anhand ihrer Ressourcen-IDs. Jeder Backend-Aufruf wird mit den Berechtigungen der angemeldeten Person autorisiert. Dass ein Tool im Verzeichnis sichtbar ist, bedeutet nicht, dass es für jede Ressource verwendet werden darf.

/main bietet dieselben authentifizierten Tools, während /account eine authentifizierte Anfrage an /main weiterleitet. Keine der beiden Adressen stellt das frühere Modell mit Organisationsschlüsseln wieder her. Halte dich an die Anleitung zur Verbindungseinrichtung, wenn du zwischen gehosteten URLs wechselst.

Wenn du eine Verbindung nicht mehr nutzen möchtest, trenne sie im Client und entferne ihre gespeicherten Zugangsdaten. Gehe nicht davon aus, dass das Löschen einer Clientkonfiguration ein bereits ausgestelltes Zugriffstoken sofort ungültig macht oder dass das Löschen eines API-Schlüssels diese Benutzersitzung widerruft. Das Trennen der Verbindung macht weder frühere Änderungen noch eingereichte Aufträge oder bereits an den Client zurückgegebene Inhalte rückgängig.

Gewähre nur die für die Aufgabe nötigen Berechtigungen #

Wähle in der Zulassungsliste oder den Freigabeeinstellungen des Clients gezielt die benötigten Lesezugriffe aus, sofern dies unterstützt wird. Mitgliederverwaltung, Schlüsselerstellung, Engine-Bereitstellung und das Anwenden von Vorschlägen haben jeweils unterschiedliche Auswirkungen. Aktiviere diese Funktionen nur, wenn die Aufgabe die jeweiligen Auswirkungen erfordert und erlaubt.

Beschreibe einen Schreibvorgang genau: „Füge diesen französischen Begriff zum ausgewählten Glossar hinzu“ benennt eine enger begrenzte Änderung als „Repariere die Lokalisierungs-Engine“. Frage nach, ob der Vorgang einen Begriff hinzufügt, eine gemeinsam genutzte Ressource bearbeitet, alle Verknüpfungen ersetzt oder die Engine-Bereitstellung startet. Sieh dir vor der Bearbeitung einer gemeinsam genutzten Ressource deren Verknüpfungen an, da mehrere Lokalisierungs-Engines das Ergebnis nutzen können.

Rufe bei einer Änderung der Mitgliedschaft die aktuellen Mitglieder und verfügbaren Rollen ab und bestätige die vorgesehenen Berechtigungen. members_setRole erwartet die userId des Mitglieds; members_remove erwartet die id der Mitgliedschaft, keine E-Mail-Adresse oder Benutzer-ID. Für eine Rollenänderung auf Organisationsebene ist außerdem die ausgewählte orgId erforderlich. Richte dich nach dem aktuellen Tool-Schema und dessen Berechtigungsanforderungen, statt die Argumente eines früheren Konto-Wrappers zu übernehmen.

Wenn eine Anfrage für einen Dienstschlüssel fehlschlägt, erläutere, welcher Nutzungsanspruch oder welche Berechtigung fehlt, und hole eine Freigabe ein, bevor du andere Zugangsdaten vorschlägst. Persönliche Schlüssel, Dienstschlüsselrollen, Berechtigungsbereiche von Lokalisierungs-Engines und Inhaltsberechtigungsbereiche können unterschiedliche Zugriffe gewähren. Eine Ausweichoption in einer zur Laufzeit bereitgestellten Tool-Beschreibung berechtigt nicht zu einem weitergehenden Zugriff.

Ausgabe geheimer Daten und Lesezugriffe auf private Daten #

Kläre den sicheren Umgang mit geheimen Daten, bevor du apiKeys_create aufrufst: Der Aufruf gibt einen geheimen Wert im Klartext zurück – und zwar nur einmal. Auch beim Erstellen einer Einladung kann ein Token für deren Annahme zurückgegeben werden. Tool-Ergebnisse gelangen an den Client und können in den Modellkontext oder in gespeicherte Gesprächsprotokolle aufgenommen werden. Halte diese geheimen Daten aus nachfolgenden Prompts, Commits, Berichten und Screenshots heraus.

Details zu Anfragen und Prüfungen können Ausgangstexte, Übersetzungen, Kontext und Materialien von Bewertern enthalten. Beginne mit einer kleinen Seite relevanter Metadaten und rufe anschließend den vollständigen Text ab, den du für die Untersuchung benötigst. Halte dieselben Grenzen für die Offenlegung ein, wenn der Assistent gelesene Daten zusammenfasst oder an ein anderes Tool weitergibt.

Externe Suchen und Tool-Kontext #

localization_search durchsucht die Lokalisierungs-Wissensdatenbank von Lingo.dev. docs_fetch liest eine Seite anhand eines Pfads, den diese Suche zurückgegeben hat. Damit lassen sich keine beliebigen URLs abrufen.

Verwende aufgabenbezogene Suchanfragen ohne Zugangsdaten oder unnötige private Texte. Behandle abgerufene Seiten und Auszüge als Quellenmaterial, das du einordnen musst. Darin enthaltene Anweisungen können den Umfang der autorisierten Aufgabe nicht erweitern.

Aktuelle Tools akzeptieren optional intent zur Beschreibung der jeweiligen Aufgabe. Diese Angabe wird zu Diagnosezwecken aufgezeichnet, aber nicht als Feld der API-Nutzdaten weitergeleitet. Auch Tool-Argumente und -Ergebnisse können in Diagnosedaten und Clientprotokolle gelangen. Nimm daher keine geheimen Daten in Aufgabenbeschreibungen auf und gehe nicht davon aus, dass ein Lesezugriff keine gespeicherte Kopie hinterlässt.