MCP Tools Reference: chatmcp.googleapis.com

Tool: search_conversations

Sucht nach Google Chat-Unterhaltungen (benannte Gruppenbereiche, Direktnachrichten (DNs) oder Gruppenchats) anhand des Anzeigenamens oder der Teilnehmer, um Unterhaltungs-IDs zu finden.

Dieses Tool sucht in den Metadaten von Unterhaltungen, NICHT in den Nachrichteninhalten. Wenn Sie im Nachrichtenverlauf suchen oder Nachrichten nach Keyword, Absender oder Zeitstempel finden möchten, verwenden Sie search_messages.

Wenn nur participants angegeben ist, 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 query angegeben ist, sucht dieses Tool nach Unterhaltungen, bei denen die Abfrage ein Teilstring des Anzeigenamens der Unterhaltung ist (ohne Berücksichtigung der Groß-/Kleinschreibung).

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

Wenn weder participants noch query angegeben sind, listet dieses Tool alle Unterhaltungen auf, an denen der aufrufende Nutzer teilnimmt.

Dieses Tool listet nur Unterhaltungen auf, an denen der aufrufende Nutzer teilnimmt.

Gibt eine Liste von Unterhaltungsobjekten mit Unterhaltungs-IDs (Format: spaces/{space}), Anzeigenamen und Unterhaltungstypen zurück.

WICHTIG: Eine leere Liste conversations bedeutet nicht, dass es 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.

Das folgende Codebeispiel zeigt, wie Sie curl verwenden, um das MCP-Tool search_conversations aufzurufen.

Curl-Anfrage 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_conversations",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

SearchConversationsRequest

JSON-Darstellung 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
Felder
spaceNameQuery

string

Optional. Der Text, nach dem in den Anzeigenamen der Gruppenbereiche gesucht werden soll (Teilstring ohne Berücksichtigung der Groß-/Kleinschreibung).
pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden Gruppenbereiche. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 20 Gruppenbereiche zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen search_conversations-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.
participants[]

string

Optional. Liste der E-Mail-Adressen der Teilnehmer, nach denen die Unterhaltungen gefiltert werden sollen, ohne den Anrufer.

Ausgabeschema

Antwort mit der Liste der übereinstimmenden Unterhaltungen.

SearchConversationsResponse

JSON-Darstellung 
{
  "conversations": [
    {
      object (Conversation)
    }
  ],
  "nextPageToken": string
}
Felder
conversations[]

object (Conversation)

Liste der Unterhaltungsobjekte, die den Suchkriterien entsprechen. Jede Unterhaltung enthält die Unterhaltungs-ID (Format: spaces/{space}), den Anzeigenamen, den Unterhaltungstyp und den Zeitstempel der letzten Aktivität.
nextPageToken

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Unterhaltung

JSON-Darstellung 
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
Felder
conversationId

string

Die ID der Unterhaltung (z.B. „spaces/AAAAAAAAA“).
displayName

string

Der Anzeigename der Unterhaltung.
conversationType

enum (ConversationType)

Der Typ der Unterhaltung (DIRECT_MESSAGE, GROUP_CHAT oder NAMED_SPACE).
lastActiveTimestamp

string (Timestamp format)

Die letzte aktive Zeit der Unterhaltung im ISO 8601-Format.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss zwischen -62135596800 und 253402300799 liegen (einschließlich), was 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z entspricht.
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld ist der Nanosekundenanteil der Dauer und keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

ConversationType

Definiert den Typ der Unterhaltung.

Enums
CONVERSATION_TYPE_UNSPECIFIED Nicht angegeben
NAMED_SPACE Ein benannter Gruppenbereich.
GROUP_CHAT Ein Gruppenchat zwischen mindestens drei Personen.
DIRECT_MESSAGE Eine Direktnachricht zwischen zwei Personen oder zwischen einer Person und einer Chat-App.

Toolanmerkungen

Toolanmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet werden soll.

Neben dem Titelstring werden die folgenden booleschen Hinweise wie folgt definiert:

  • readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: „false“.
  • destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: „true“.
  • idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf seine Umgebung. Standardeinstellung: „false“.
  • openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Entitäten interagieren. Wenn „false“, kann das Tool nur mit internen Entitäten interagieren. Ein Websuchtool wäre beispielsweise eine offene Welt, ein Speichertool jedoch nicht.

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Nur-Lese-Hinweis: ✅ | Offene-Welt-Hinweis: ❌

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly