MCP Reference: chatmcp.googleapis.com

La API de Chat MCP proporciona MCP remoto para las funciones de Google Chat.

Un servidor de Protocolo de contexto del modelo (MCP) actúa como proxy entre un servicio externo que proporciona contexto, datos o capacidades a un modelo de lenguaje grande (LLM) o una aplicación de IA. Los servidores de MCP conectan aplicaciones de IA a sistemas externos, como bases de datos y servicios web, y traducen sus respuestas a un formato que la aplicación de IA puede comprender.

Configuración del servidor

Debes configurar el servidor de Chat MCP antes de usarlo. Para obtener más información sobre el uso de servidores de MCP remotos de Google y Google Cloud, consulta Descripción general de los servidores de MCP de Google Cloud.

Extremos del servidor

Un extremo de servicio de MCP es la dirección de red y la interfaz de comunicación (por lo general, una URL) del servidor de MCP que usa una aplicación de IA (el host para el cliente de MCP) para establecer una conexión segura y estandarizada. Es el punto de contacto para que el LLM solicite contexto, llame a una herramienta o acceda a un recurso. Los extremos de MCP de Google pueden ser globales o regionales.

El servidor de MCP de la API de Chat tiene el siguiente extremo de MCP global:

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

Herramientas de MCP

Una herramienta de MCP es una función o capacidad ejecutable que un servidor de MCP expone a un LLM o una aplicación de IA para realizar una acción en el mundo real.

Herramientas

El servidor de MCP chatmcp.googleapis.com tiene las siguientes herramientas:

Herramientas de MCP
list_messages Recupera mensajes de una conversación de Google Chat especificada (espacio, mensaje directo [MD] o MD grupal). Permite filtrar por conversación, intervalo de tiempo y cantidad de mensajes. Además, se puede recuperar la siguiente página de mensajes para permitir más contexto. Se filtran los mensajes privados (mensajes visibles solo para un usuario).
search_conversations

Busca conversaciones de Google Chat por nombre visible.

Si solo se proporcionan participantes, esta herramienta busca mensajes directos 1:1 (si se proporciona un participante) o chats grupales (si se proporcionan varios participantes) que incluyan a los participantes especificados y al usuario que llama.

Si solo se proporciona una consulta, esta herramienta busca conversaciones en las que la consulta es una subcadena que no distingue mayúsculas de minúsculas del nombre visible de la conversación.

Si se proporcionan participantes y una consulta, esta herramienta busca conversaciones por participantes y, luego, las filtra por nombre visible.

Si no se proporcionan participantes ni una consulta, esta herramienta muestra todas las conversaciones de las que el usuario que llama es miembro.

Esta herramienta solo muestra las conversaciones de las que el usuario que llama es miembro.

IMPORTANTE: Una lista de "conversaciones" vacía no significa que no haya más resultados en general. Si está presente "next_page_token", se pueden recuperar más páginas. Si obtienes una lista vacía, pero un "next_page_token", pregúntale al usuario si debes continuar con la búsqueda.

Obtén especificaciones de la herramienta de MCP

Para obtener las especificaciones de la herramienta de MCP para todas las herramientas de un servidor de MCP, usa el método tools/list. En el siguiente ejemplo, se muestra cómo usar curl para enumerar todas las herramientas y sus especificaciones disponibles actualmente en el servidor de MCP.

Solicitud 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
}'