MCP Tools Reference: chatmcp.googleapis.com

Narzędzie: search_conversations

Wyszukuje rozmowy w Google Chat (pokoje z nazwą, czaty lub czaty grupowe) według wyświetlanej nazwy lub uczestników, aby znaleźć identyfikatory rozmów.

To narzędzie przeszukuje metadane rozmowy, a NIE treść wiadomości. Aby przeszukać historię wiadomości lub znaleźć wiadomości według słowa kluczowego, nadawcy lub sygnatury czasowej, użyj narzędzia search_messages.

Jeśli podasz tylko parametr participants, to narzędzie znajdzie czaty 1:1 (jeśli podasz 1 uczestnika) lub czaty grupowe (jeśli podasz kilku uczestników), które obejmują określonych uczestników i użytkownika wywołującego.

Jeśli podasz tylko parametr query, to narzędzie wyszuka rozmowy, w których zapytanie jest podciągiem wyświetlanej nazwy rozmowy (bez uwzględniania wielkości liter).

Jeśli podasz zarówno parametr participants, jak i query, to narzędzie znajdzie rozmowy według uczestników, a następnie odfiltruje je według wyświetlanej nazwy.

Jeśli nie podasz ani parametru participants, ani query, to narzędzie wyświetli listę wszystkich rozmów, w których użytkownik wywołujący jest uczestnikiem.

To narzędzie wyświetla tylko rozmowy, w których użytkownik wywołujący jest uczestnikiem.

Zwraca listę obiektów rozmowy zawierających identyfikatory rozmów (format: spaces/{space}), wyświetlane nazwy i typy rozmów.

WAŻNE: pusta lista conversations nie oznacza, że nie ma więcej wyników. Jeśli występuje parametr next_page_token, można pobrać więcej stron. Jeśli otrzymasz pustą listę, ale parametr next_page_token, zapytaj użytkownika, czy chcesz kontynuować wyszukiwanie.

Poniższy przykładowy kod pokazuje, jak użyć narzędzia curl do wywołania narzędzia MCP search_conversations.

Żądanie Curl 
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
}'

Schemat wejściowy

SearchConversationsRequest

Zapis JSON 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
Pola
spaceNameQuery

string

Opcjonalnie. Tekst do wyszukania w wyświetlanych nazwach pokoi (podciąg bez uwzględniania wielkości liter).
pageSize

integer

Opcjonalnie. Maksymalna liczba pokoi do zwrócenia. Usługa może zwrócić mniej niż tę wartość. Jeśli nie podasz tej wartości, zostanie zwróconych co najwyżej 20 pokoi. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.
pageToken

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania search_conversations. Podaj go, aby pobrać następną stronę.
participants[]

string

Opcjonalnie. Lista adresów e-mail uczestników, według których mają być filtrowane rozmowy, z wyłączeniem rozmówcy.

Schemat wyjściowy

Odpowiedź zawierająca listę pasujących rozmów.

SearchConversationsResponse

Zapis JSON 
{
  "conversations": [
    {
      object (Conversation)
    }
  ],
  "nextPageToken": string
}
Pola
conversations[]

object (Conversation)

Lista obiektów rozmowy, które pasują do kryteriów wyszukiwania. Każda rozmowa zawiera identyfikator rozmowy (format: spaces/{space}), wyświetlaną nazwę, typ rozmowy i sygnaturę czasową ostatniej aktywności.
nextPageToken

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

Rozmowa

Zapis JSON 
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
Pola
conversationId

string

Identyfikator rozmowy (np. „spaces/AAAAAAAAA”).
displayName

string

Wyświetlana nazwa rozmowy.
conversationType

enum (ConversationType)

Typ rozmowy (DIRECT_MESSAGE, GROUP_CHAT lub NAMED_SPACE).
lastActiveTimestamp

string (Timestamp format)

Czas ostatniej aktywności w rozmowie w formacie ISO 8601.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

Sygnatura czasowa

Zapis JSON 
{
  "seconds": string,
  "nanos": integer
}
Pola
seconds

string (int64 format)

Reprezentuje sekundy czasu UTC od epoki uniksowej 1970-01-01T00:00:00Z. Musi mieścić się w zakresie od -62135596800 do 253402300799 włącznie (co odpowiada zakresowi od 0001-01-01T00:00:00Z do 9999-12-31T23:59:59Z).
nanos

integer

Nieujemne ułamki sekundy z dokładnością do nanosekundy. To pole jest częścią czasu trwania w nanosekundach, a nie alternatywą dla sekund. Ujemne wartości sekund z ułamkami muszą nadal mieć nieujemne wartości nanosekund, które liczą się w czasie. Musi mieścić się w zakresie od 0 do 999 999 999 włącznie.

ConversationType

Określa typ rozmowy.

Wartości w polu enum
CONVERSATION_TYPE_UNSPECIFIED Nie określono.
NAMED_SPACE Pokój z nazwą.
GROUP_CHAT Czat grupowy z udziałem co najmniej 3 osób.
DIRECT_MESSAGE Czat między 2 osobami lub między osobą a aplikacją Chat.

Adnotacje narzędzia

Adnotacje narzędzia są wysyłane do klientów MCP, aby opisać podstawowe ryzyko związane z danym narzędziem. Większość klientów traktuje te wskazówki jako niezaufane, ale można ich użyć do określenia, kiedy należy wysłać do użytkownika prośbę o potwierdzenie.

Oprócz ciągu tytułu zdefiniowano te wskazówki logiczne:

  • readOnlyHint: jeśli ma wartość true, narzędzie nie modyfikuje swojego środowiska. Domyślnie: false.
  • destructiveHint: jeśli ma wartość true, narzędzie może wykonywać działania destrukcyjne. Jeśli ma wartość false, narzędzie może wykonywać tylko działania dodające. Domyślnie: true.
  • idempotentHint: jeśli ma wartość true, wielokrotne wywoływanie narzędzia z tymi samymi argumentami nie będzie miało dodatkowego wpływu na jego środowisko. Domyślnie: false.
  • openWorldHint: jeśli ma wartość true, narzędzie może wchodzić w interakcje z „otwartym światem” podmiotów zewnętrznych. Jeśli ma wartość false, narzędzie może wchodzić w interakcje tylko z podmiotami wewnętrznymi. Na przykład narzędzie do wyszukiwania w internecie byłoby narzędziem typu „otwarty świat”, a narzędzie do zarządzania pamięcią – nie.

Wskazówka destrukcyjna: ❌ | Wskazówka idempotentna: ✅ | Wskazówka tylko do odczytu: ✅ | Wskazówka dotycząca otwartego świata: ❌

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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