Das Model Context Protocol (MCP) ist ein Open-Source-Standard zum Verbinden von KI-Anwendungen mit externen Systemen. Er definiert eine bestimmte Menge von Einheiten und eine definierte Struktur, die als Standardmethode zum Verbinden verschiedener Datenquellen und Tools mit KI-Modellen dient.
Mit MCP-Tools können Sie Ihre Agent-Anwendung mit einem vorhandenen MCP-Server 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. In dieser Anleitung wird der Prozess von Anfang bis Ende beschrieben: 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 verwenden, z. B. einen Google Cloud MCP-Server.
Authentifizierung
MCP-Tools haben dieselben Authentifizierungsoptionen wie OpenAPI-Tools.
MCP-Server unabhängig testen
Bevor Sie Ihre Agents 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.
MCP-Tool erstellen
So erstellen Sie ein MCP-Tool über die Console:
- Klicken Sie rechts im Agent Builder auf das Werkzeugsymbol.
- Wählen Sie das MCP-Tool aus.
- Geben Sie einen Namen für das Tool an.
- Geben Sie eine Toolbeschreibung an.
- Geben Sie die Serveradresse für den MCP-Server an.
- Wählen Sie einen Authentifizierungstyp aus.
- Klicken Sie auf Erstellen.
Für Server, die in Cloud Run gehostet werden, ist die empfohlene Authentifizierungsoption das Service-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.