MCP Reference: chatmcp.googleapis.com

A API Chat MCP oferece MCP remoto para recursos de chat do Google Chat.

Um servidor do Protocolo de Contexto de Modelo (MCP) atua como um proxy entre um serviço externo que fornece contexto, dados ou recursos a um modelo de linguagem grande (LLM) ou aplicativo de IA. Os servidores MCP conectam aplicativos de IA a sistemas externos, como bancos de dados e serviços da Web, traduzindo as respostas em um formato que o aplicativo de IA possa entender.

Configuração do servidor

Você precisa configurar o servidor MCP do Chat antes de usar. Para mais informações sobre como usar servidores remotos do MCP do Google e do Google Cloud, consulte Visão geral dos servidores do MCP no Google Cloud.

Endpoints de servidor

Um endpoint de serviço do MCP é o endereço de rede e a interface de comunicação (geralmente um URL) do servidor do MCP que um aplicativo de IA (o host do cliente do MCP) usa para estabelecer uma conexão segura e padronizada. É o ponto de contato para o LLM solicitar contexto, chamar uma ferramenta ou acessar um recurso. Os endpoints do Google MCP podem ser globais ou regionais.

O servidor MCP da API Chat tem o seguinte endpoint global do MCP:

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

Ferramentas do MCP

Uma ferramenta do MCP é uma função ou capacidade executável que um servidor do MCP expõe a um LLM ou aplicativo de IA para realizar uma ação no mundo real.

Ferramentas

O servidor MCP chatmcp.googleapis.com tem as seguintes ferramentas:

Ferramentas do MCP
list_messages Recupera mensagens de uma conversa específica do Google Chat (espaço, mensagem direta ou mensagem direta em grupo). Permite filtrar por conversa, período e número de mensagens. Além disso, a próxima página de mensagens pode ser recuperada para oferecer mais contexto. As mensagens particulares (visíveis apenas para um usuário) são filtradas.
search_conversations

Pesquisa conversas do Google Chat pelo nome de exibição.

Se apenas participantes forem fornecidos, essa ferramenta vai encontrar mensagens diretas individuais (se um participante for fornecido) ou conversas em grupo (se vários participantes forem fornecidos) que incluam os participantes especificados e o usuário que está fazendo a chamada.

Se apenas uma consulta for fornecida, essa ferramenta vai procurar conversas em que a consulta é uma substring sem diferenciação de maiúsculas e minúsculas do nome de exibição da conversa.

Se os participantes e a consulta forem fornecidos, essa ferramenta vai encontrar conversas por participantes e depois filtrá-las por nome de exibição.

Se nenhum participante ou consulta for fornecido, essa ferramenta vai listar todas as conversas de que o usuário que fez a chamada participa.

Essa ferramenta só lista as conversas de que o usuário que está ligando participa.

IMPORTANTE: uma lista "conversas" vazia não significa que não há mais resultados no geral. Se "next_page_token" estiver presente, mais páginas poderão ser buscadas. Se você receber uma lista vazia, mas um "next_page_token", pergunte ao usuário se você deve continuar a pesquisa.

Receber especificações da ferramenta MCP

Para receber as especificações de ferramentas do MCP de todas as ferramentas em um servidor MCP, use o método tools/list. O exemplo a seguir demonstra como usar curl para listar todas as ferramentas e especificações disponíveis no servidor MCP.

Solicitação 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
}'