MCP Reference: chatmcp.googleapis.com

Interfejs Chat MCP API udostępnia zdalny MCP dla funkcji czatu Google Chat.

Serwer Model Context Protocol (MCP) działa jako serwer proxy między usługą zewnętrzną, która udostępnia kontekst, dane lub funkcje dużemu modelowi językowemu (LLM) lub aplikacji AI. Serwery MCP łączą aplikacje AI z systemami zewnętrznymi, takimi jak bazy danych i usługi internetowe, tłumacząc ich odpowiedzi na format zrozumiały dla aplikacji AI.

Konfiguracja serwera

Przed użyciem musisz skonfigurować serwer MCP Google Chat. Więcej informacji o korzystaniu z serwerów MCP Google i Google Cloud znajdziesz w omówieniu serwerów MCP Google Cloud.

Punkty końcowe serwera

Punkt końcowy usługi MCP to adres sieciowy i interfejs komunikacyjny (zwykle adres URL) serwera MCP, którego aplikacja AI (host klienta MCP) używa do nawiązywania bezpiecznego, standardowego połączenia. Jest to punkt kontaktowy, za pomocą którego LLM może prosić o kontekst, wywoływać narzędzie lub uzyskiwać dostęp do zasobu. Punkty końcowe Google MCP mogą być globalne lub regionalne.

Serwer MCP interfejsu Chat API ma ten globalny punkt końcowy MCP:

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

Narzędzia MCP

Narzędzie MCP to funkcja lub wykonywalna możliwość, którą serwer MCP udostępnia dużemu modelowi językowemu lub aplikacji AI, aby umożliwić jej wykonanie działania w świecie rzeczywistym.

Narzędzia

Serwer MCP chatmcp.googleapis.com ma te narzędzia:

Narzędzia MCP
list_messages Pobiera wiadomości z określonej rozmowy w Google Chat (pokoju, czatu lub czatu grupowego). Umożliwia filtrowanie według wątku, zakresu czasu i liczby wiadomości. Możesz też pobrać następną stronę wiadomości, aby uzyskać więcej kontekstu. Wiadomości prywatne (widoczne tylko dla jednego użytkownika) są odfiltrowywane.
search_conversations

Wyszukuje rozmowy w Google Chat według nazwy wyświetlanej.

Jeśli podasz tylko uczestników, to narzędzie znajdzie wiadomości bezpośrednie 1:1 (jeśli podasz jednego uczestnika) lub czaty grupowe (jeśli podasz wielu uczestników), które obejmują podanych uczestników i użytkownika dzwoniącego.

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

Jeśli podasz zarówno uczestników, jak i zapytanie, to narzędzie znajdzie rozmowy z udziałem tych uczestników, a następnie odfiltruje je według wyświetlanej nazwy.

Jeśli nie podasz uczestników ani zapytania, to narzędzie wyświetli listę wszystkich rozmów, w których uczestniczy użytkownik wywołujący.

To narzędzie wyświetla tylko rozmowy, w których uczestniczy dany użytkownik.

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

Uzyskiwanie specyfikacji narzędzi MCP

Aby uzyskać specyfikacje narzędzi MCP dla wszystkich narzędzi na serwerze MCP, użyj metody tools/list. Poniższy przykład pokazuje, jak za pomocą curl wyświetlić listę wszystkich narzędzi i ich specyfikacji dostępnych obecnie na serwerze MCP.

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