MCP Reference: chatmcp.googleapis.com

L'API Chat MCP fournit un MCP distant pour les fonctionnalités de chat Google Chat.

Un serveur MCP (Model Context Protocol) sert de proxy entre un service externe qui fournit du contexte, des données ou des capacités à un grand modèle de langage (LLM) ou à une application d'IA. Les serveurs MCP connectent les applications d'IA à des systèmes externes tels que des bases de données et des services Web, et traduisent leurs réponses dans un format que l'application d'IA peut comprendre.

Configuration du serveur

Vous devez configurer le serveur MCP Chat avant de l'utiliser. Pour en savoir plus sur l'utilisation des serveurs MCP distants Google et Google Cloud, consultez Présentation des serveurs MCP Google Cloud.

Points de terminaison du serveur

Un point de terminaison de service MCP est l'adresse réseau et l'interface de communication (généralement une URL) du serveur MCP qu'une application d'IA (l'hôte du client MCP) utilise pour établir une connexion sécurisée et standardisée. Il s'agit du point de contact permettant au LLM de demander du contexte, d'appeler un outil ou d'accéder à une ressource. Les points de terminaison Google MCP peuvent être globaux ou régionaux.

Le serveur MCP de l'API Chat possède le point de terminaison MCP global suivant :

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

Outils MCP

Un outil MCP est une fonction ou une capacité exécutable qu'un serveur MCP expose à un LLM ou à une application d'IA pour effectuer une action dans le monde réel.

Outils

Le serveur MCP chatmcp.googleapis.com comporte les outils suivants :

Outils MCP
list_messages Récupère les messages d'une conversation Google Chat spécifiée (espace, message privé ou message privé de groupe). Permet de filtrer les résultats par fil de discussion, plage horaire et nombre de messages. De plus, la page suivante des messages peut être récupérée pour fournir plus de contexte. Les messages privés (messages visibles par un seul utilisateur) sont filtrés.
search_conversations

Recherche des conversations Google Chat par nom à afficher.

Si seuls les participants sont fournis, cet outil recherche les messages privés à deux (si un seul participant est fourni) ou les discussions de groupe (si plusieurs participants sont fournis) qui incluent les participants spécifiés et l'utilisateur appelant.

Si seule une requête est fournie, cet outil recherche les conversations dont le nom à afficher contient la requête en tant que sous-chaîne non sensible à la casse.

Si les participants et la requête sont fournis, cet outil recherche les conversations par participants, puis les filtre par nom à afficher.

Si aucun participant ni aucune requête ne sont fournis, cet outil liste toutes les conversations dont l'utilisateur appelant est membre.

Cet outil ne liste que les conversations dont l'utilisateur qui appelle est membre.

IMPORTANT : Une liste de conversations vide ne signifie pas qu 'il n'y a plus de résultats. Si "next_page_token" est présent, d'autres pages peuvent être récupérées. Si vous obtenez une liste vide, mais un "next_page_token", demandez à l'utilisateur si vous devez poursuivre la recherche.

Obtenir les spécifications de l'outil MCP

Pour obtenir les spécifications des outils MCP pour tous les outils d'un serveur MCP, utilisez la méthode tools/list. L'exemple suivant montre comment utiliser curl pour lister tous les outils et leurs spécifications actuellement disponibles sur le serveur MCP.

Requête 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
}'