Model Armor in Google- und Google Cloud-MCP-Server einbinden

In diesem Dokument erfahren Sie, wie Sie Model Armor konfigurieren, um Ihre Daten und Inhalte zu schützen, wenn Sie Anfragen an Google Cloud-Dienste senden, die MCP-Tools (Model Context Protocol) und -Server bereitstellen.

Model Armor trägt dazu bei, Ihre agentischen KI-Anwendungen zu schützen, indem MCP-Toolaufrufe und ‑Antworten bereinigt werden. Dieser Prozess minimiert Risiken wie Prompt Injection und die Offenlegung sensibler Daten.

Unterstützte MCP-Server

Eine Liste der unterstützten Google- und Google Cloud MCP-Server finden Sie unter Produkte mit Model Armor-Unterstützung.

Die Mindesteinstellungen für Model Armor werden nicht angewendet, wenn Sie nicht unterstützte Google- und Google Cloud MCP-Server aufrufen.

Überlegungen zum Datenstandort

Der Gerichtsbezirk definiert die geografische Region und die rechtliche Grenze, in der Ihre Daten verarbeitet und gespeichert werden. Dies ist für den Datenstandort von entscheidender Bedeutung, da so sichergestellt wird, dass Daten an einem ausgewählten Ort verbleiben, um die Einhaltung regulatorischer Anforderungen zu gewährleisten. Model Armor ist ein regionalisierter Dienst, der jedoch nicht in jeder Google Cloud Region verfügbar ist, in der Google- und Google Cloud MCP-Server-unterstützte Dienste betrieben werden. Wenn Sie Model Armor für einen MCP-unterstützten Dienst aktivieren, der in einer Gerichtsbarkeit verfügbar ist, in der Model Armor nicht vorhanden ist, werden Ihre Daten möglicherweise zur Sicherheitsüberprüfung an einen Model Armor-Endpunkt in einer anderen Gerichtsbarkeit gesendet. Diese länderübergreifenden Aufrufe können sich auf die Anforderungen an den Datenstandort für den MCP-unterstützten Dienst auswirken. Informationen dazu, wie sich standortübergreifende Aufrufe auf den Datenstandort der von Ihnen verwendeten Dienste auswirken, finden Sie in der Dokumentation für jeden von MCP unterstützten Dienst.

Hinweis

  1. Aktivieren Sie die API, auf die Sie über MCP zugreifen möchten. Weitere Informationen finden Sie unter Unterstützte Produkte aktivieren.
  2. Aktivieren Sie die Model Armor API in Ihrem Projekt. Weitere Informationen finden Sie unter APIs aktivieren.
  3. Wenn Sie Anforderungen an den Datenstandort haben, müssen Sie einen Log-Sink konfigurieren, um Logs an einen konformen Speicherort weiterzuleiten, bevor Sie Cloud Logging im nächsten Schritt aktivieren. Wenn Sie einen Log-Sink konfigurieren, werden Model Armor-Logs in Buckets in der entsprechenden Gerichtsbarkeit gespeichert. Weitere Informationen finden Sie unter Logs regionalisieren.

Unterstützte und nicht unterstützte MCP-Nutzlasten

Model Armor bereinigt nur die folgenden MCP-Nutzlasten:

Model Armor lässt die folgenden Nutzlasten ohne Bereinigung zu:

  • tools/list
  • resources/*
  • notifications/*
  • Streamable HTTP/SSE for MCP
  • MCP-Protokollfehler (z. B. alle Fehler außer Tool-Ausführungsfehlern)

Schutz für Google- und Google Cloud Remote-MCP-Server konfigurieren

Mit den Mindesteinstellungen für Model Armor können Sie Ihre MCP-Toolaufrufe und ‑Antworten schützen. Eine Mindesteinstellung definiert die Mindestsicherheitsfilter, die für das gesamte Projekt gelten. Mit dieser Konfiguration wird ein einheitlicher Satz von Filtern auf alle MCP-Tool-Aufrufe und ‑Antworten im Projekt angewendet.

Richten Sie eine Model Armor-Mindesteinstellung mit aktivierter MCP-Bereinigung ein. Weitere Informationen finden Sie unter Model Armor-Untergrenzeneinstellungen konfigurieren.

Hier ein Beispielbefehl:

gcloud model-armor floorsettings update \
--full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
--enable-floor-setting-enforcement=TRUE \
--add-integrated-services=GOOGLE_MCP_SERVER \
--google-mcp-server-enforcement-type=INSPECT_AND_BLOCK \
--enable-google-mcp-server-cloud-logging \
--malicious-uri-filter-settings-enforcement=ENABLED \
--add-rai-settings-filters='[{"confidenceLevel": "MEDIUM_AND_ABOVE", "filterType": "DANGEROUS"}]'

Ersetzen Sie dabei PROJECT_ID durch die ID Ihres Projekts in Google Cloud .

Beachten Sie die folgenden Einstellungen:

  • INSPECT_AND_BLOCK: Der Erzwingungstyp, der Inhalte für den Google MCP-Server prüft und Prompts und Antworten blockiert, die den Filtern entsprechen.
  • ENABLED: Die Einstellung, die einen Filter oder die Durchsetzung ermöglicht.
  • MEDIUM_AND_ABOVE: Das Konfidenzniveau für die Filtereinstellungen „Verantwortungsbewusste KI – Gefährlich“. Sie können diese Einstellung ändern. Niedrigere Werte können jedoch zu mehr falsch positiven Ergebnissen führen. Weitere Informationen finden Sie unter Vertrauenswürdigkeitsstufen für Model Armor.

Model Armor-Schutz prüfen

Nachdem Sie Model Armor-Schutz für MCP-Server konfiguriert haben, können Sie prüfen, ob er funktioniert, indem Sie eine Anfrage mit Inhalten senden, die blockiert werden sollten, und prüfen, ob Model Armor sie blockiert. Bei den folgenden Schritten wird davon ausgegangen, dass Sie das Logging für Model Armor wie unter Schutz für Google- und Google Cloud MCP-Server konfigurieren beschrieben aktiviert haben.

  1. Rufen Sie in dem Projekt, in dem Sie Model Armor-Schutz aktiviert haben, ein MCP-Tool mit einem schädlichen Wert in einem seiner Parameter auf. Wenn Sie beispielsweise den Filter für schädliche URIs aktiviert haben, fügen Sie eine Phishing-Test-URL in einen Parameter wie http://testsafebrowsing.appspot.com/s/phishing.html ein.
  2. Prüfen Sie, ob der MCP-Toolaufruf blockiert ist. Je nach MCP-Server und ‑Client erhalten Sie möglicherweise einen Fehler oder eine leere Antwort, was darauf hindeutet, dass die Anfrage durch eine Sicherheitsrichtlinie blockiert wurde.

  3. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

    Zum Log-Explorer

  4. Geben Sie im Bereich Abfrage die folgende Abfrage ein:

    resource.type="model-armor_managed_service"
logName="projects/PROJECT_ID/logs/modelarmor.googleapis.com%2Fdetection"

    Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID.

  5. Klicken Sie auf Abfrage ausführen.

  6. Sehen Sie sich die Ergebnisse im Abschnitt Abfrageergebnisse an. Wenn die Anfrage von Model Armor blockiert wurde, sehen Sie einen Logeintrag mit Details zur erkannten Bedrohung, z. B. MALICIOUS_URI_DETECTED.

Scannen von MCP-Traffic mit Model Armor deaktivieren

Wenn Sie verhindern möchten, dass Model Armor den Traffic zu und von Google MCP-Servern automatisch auf Grundlage der Mindesteinstellungen des Projekts scannt, führen Sie den folgenden Befehl aus:

gcloud model-armor floorsettings update \
  --full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
  --remove-integrated-services=GOOGLE_MCP_SERVER

Ersetzen Sie PROJECT_ID durch die Google Cloud Projekt-ID. Model Armor wendet die in den Mindesteinstellungen dieses Projekts definierten Regeln nicht automatisch auf den gesamten Google MCP-Server-Traffic an.

Die Mindesteinstellungen für Model Armor und die allgemeine Konfiguration können sich auf mehr als nur MCP auswirken. Da Model Armor in Dienste wie die Gemini Enterprise Agent Platform eingebunden ist, können sich Änderungen, die Sie an den Mindesteinstellungen vornehmen, auf das Scannen von Traffic und das Sicherheitsverhalten in allen eingebundenen Diensten auswirken, nicht nur auf MCP.

Nächste Schritte