Das Model Context Protocol (MCP) ist ein Open-Source-Standard zum Verbinden von KI-Anwendungen mit externen Systemen. Es wird eine bestimmte Gruppe von Einheiten und eine definierte Struktur festgelegt, die als Standardmethode zum Verbinden verschiedener Datenquellen und Tools mit KI-Modellen dient.
Sie können MCP-Tools verwenden, um Ihre Agent-Anwendung mit einem vorhandenen MCP-Server zu verbinden.
Beschränkungen
Es gelten folgende Einschränkungen:
- CX Agent Studio unterstützt nur StreamableHttpTransport-basierte Server. SSE-Transportserver werden nicht unterstützt.
MCP-Server erstellen oder auswählen
Wenn Sie einen eigenen MCP-Server erstellen möchten, empfehlen wir, die offiziellen MCP-SDKs oder andere zuverlässige Drittanbieter-SDKs wie FastMCP zu verwenden. Nachdem der MCP-Server erstellt wurde, stellen Sie ihn auf einem Hostingdienst bereit. Sie können den MCP-Server mit Cloud Run oder Compute Engine hosten. Remote-MCP-Server in Cloud Run erstellen und bereitstellen Google Cloud
Anstatt einen MCP-Server von Grund auf neu zu erstellen, können Sie auch einen vorgefertigten MCP-Server wie einen Google Cloud MCP-Server verwenden.
Authentifizierung
MCP-Tools haben die gleichen Authentifizierungsoptionen wie OpenAPI-Tools.
Benutzerdefinierte Header
Sie können benutzerdefinierte HTTP-Header angeben, die in Anfragen an den MCP-Server gesendet werden sollen. Sie können auch Variablen aus dem Sitzungskontext in diese Header einfügen. Weitere Informationen finden Sie unter Sitzungskontextvariablen.
MCP-Server unabhängig testen
Bevor Sie Ihre Agenten mit dem MCP-Server verbinden, empfehlen wir, den MCP-Server unabhängig zu testen.
Server, die mit StreamableHttpTransport erstellt wurden, enden mit dem Suffix (/mcp oder /mcp/). Wenn der Server beispielsweise unter https://example.com gehostet wird, lautet die richtige URL zum Senden von Anfragen an den Server https://example.com/mcp.
Wenn Sie den Server lokal testen möchten, können Sie curl oder Postman verwenden (das MCP-Verbindungen nativ unterstützt). So wird sichergestellt, dass der Server betriebsbereit ist und die für die Kommunikation mit dem Server erforderlichen Authentifizierungsinformationen verstanden werden.
Benutzerdefinierte Header
Sie können benutzerdefinierte Header definieren, die beim Senden von HTTP-Anfragen an den MCP-Server (Tool-Listenanfragen sowie Tool-Ausführung) enthalten sind. Die Werte dieser Header müssen über Variablen angegeben werden. Wenn Sie einen benutzerdefinierten Header definieren möchten, müssen Sie also zuerst eine Variable definieren, die den Headerwert enthält. Wenn eine Variable keinen Wert enthält und zur Laufzeit kein Standardwert vorhanden ist, wird der Header nicht in Anfragen aufgenommen.
MCP-Tool erstellen
So erstellen Sie ein MCP-Tool über die Console:
- Klicken Sie rechts im Agent Builder auf das Werkzeugsymbol.
- Wählen Sie MCP-Tool aus.
- Geben Sie einen Toolnamen an.
- Geben Sie eine Toolbeschreibung an.
- Geben Sie die Serveradresse für den MCP-Server an.
- Wählen Sie einen Authentifizierungstyp aus.
- Optional können Sie benutzerdefinierte Header definieren, indem Sie Headernamen und Variablen angeben, die als Headerwerte verwendet werden.
- Klicken Sie auf Erstellen.
Für Server, die in Cloud Run gehostet werden, ist die empfohlene Authentifizierungsoption das Dienst-Agent-ID-Token.
Bei dieser Methode wird das CX Agent Studio-Dienstkonto (im Format service-{PROJECT_NUMBER}@gcp-sa-ces.iam.gserviceaccount.com) verwendet, um Anfragen an den Cloud Run-Job zu senden.
Weisen Sie dem CX Agent Studio-Dienstkonto die Cloud Run Invoker-Rolle zu, damit es mit seiner eigenen Identität Anfragen an den Server senden kann.
Bevor Sie dem Agent zusätzliche Tools hinzufügen, sollten Sie mindestens ein Tool testen, um sicherzustellen, dass die Authentifizierungsinformationen richtig eingerichtet sind.