MCP Reference: chatmcp.googleapis.com

Die Chat MCP API bietet Remote-MCP für Google Chat-Funktionen.

Ein MCP-Server (Model Context Protocol) fungiert als Proxy zwischen einem externen Dienst, der einem Large Language Model (LLM) oder einer KI-Anwendung Kontext, Daten oder Funktionen bereitstellt. MCP-Server verbinden KI-Anwendungen mit externen Systemen wie Datenbanken und Webdiensten und übersetzen deren Antworten in ein Format, das die KI-Anwendung versteht.

Server einrichten

Sie müssen den Chat MCP-Server vor der Verwendung konfigurieren. Weitere Informationen zur Verwendung von Remote-MCP-Servern von Google und Google Cloud finden Sie unter Übersicht über Google Cloud-MCP-Server.

Serverendpunkte

Ein MCP-Dienstendpunkt ist die Netzwerkadresse und Kommunikationsschnittstelle (in der Regel eine URL) des MCP-Servers, über den eine KI-Anwendung (der Host für den MCP-Client) eine sichere, standardisierte Verbindung herstellt. Er ist der Ansprechpartner für das LLM, um Kontext anzufordern, ein Tool aufzurufen oder auf eine Ressource zuzugreifen. Google MCP-Endpunkte können global oder regional sein.

Der MCP-Server der Chat API hat den folgenden globalen MCP-Endpunkt:

  • https://chatmcp.googleapis.com/mcp/v1

MCP-Tools

Ein MCP-Tool ist eine Funktion oder ausführbare Funktion, die ein MCP-Server einem LLM oder einer KI-Anwendung zur Verfügung stellt, um eine Aktion in der realen Welt auszuführen.

Tools

Der MCP-Server chatmcp.googleapis.com hat die folgenden Tools:

MCP-Tools
list_messages Ruft Nachrichten aus einer bestimmten Google Chat-Unterhaltung ab (Bereich, Direktnachricht oder Gruppen-Direktnachricht). Ermöglicht das Filtern nach Thread, Zeitraum und Anzahl der Nachrichten. Außerdem kann die nächste Seite mit Nachrichten abgerufen werden, um mehr Kontext zu erhalten. Private Nachrichten (Nachrichten, die nur für einen einzelnen Nutzer sichtbar sind) werden herausgefiltert.
search_conversations

Sucht nach Google Chat-Unterhaltungen anhand des Anzeigenamens.

Wenn nur Teilnehmer angegeben sind, sucht dieses Tool nach 1:1-Direktnachrichten (wenn ein Teilnehmer angegeben ist) oder Gruppenchats (wenn mehrere Teilnehmer angegeben sind), die die angegebenen Teilnehmer und den aufrufenden Nutzer enthalten.

Wenn nur eine Abfrage angegeben ist, sucht dieses Tool nach Unterhaltungen, bei denen die Abfrage eine nicht berücksichtigende Teilstring des Anzeigenamens der Unterhaltung ist.

Wenn sowohl Teilnehmer als auch eine Abfrage angegeben sind, sucht dieses Tool nach Unterhaltungen anhand der Teilnehmer und filtert sie dann nach Anzeigenamen.

Wenn weder Teilnehmer noch eine Abfrage angegeben sind, listet dieses Tool alle Unterhaltungen auf, in denen der aufrufende Nutzer Mitglied ist.

Dieses Tool listet nur Unterhaltungen auf, in denen der aufrufende Nutzer Mitglied ist.

WICHTIG: Eine leere Liste „conversations“ bedeutet nicht, dass es insgesamt keine weiteren Ergebnisse gibt. Wenn „next_page_token“ vorhanden ist, können weitere Seiten abgerufen werden. Wenn Sie eine leere Liste, aber ein „next_page_token“ erhalten, fragen Sie den Nutzer, ob Sie die Suche fortsetzen sollen.

MCP-Tool-Spezifikationen abrufen

Verwenden Sie die Methode tools/list, um die MCP-Tool-Spezifikationen für alle Tools auf einem MCP-Server abzurufen. Im folgenden Beispiel wird gezeigt, wie Sie mit curl alle Tools und ihre Spezifikationen auflisten, die derzeit auf dem MCP-Server verfügbar sind.

Curl-Anfrage 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'