MCP Reference: chatmcp.googleapis.com

Chat MCP API は、Google Chat 機能のリモート MCP を提供します。

Model Context Protocol（MCP）サーバーは、大規模言語モデル（LLM）または AI アプリケーションにコンテキスト、データ、機能を提供する外部サービスとの間のプロキシとして機能します。MCP サーバーは、AI アプリケーションをデータベースやウェブサービスなどの外部システムに接続し、そのレスポンスを AI アプリケーションが理解できる形式に変換します。

サーバーの設定

使用する前に、Chat MCP サーバーを構成する必要があります。Google と Google Cloud のリモート MCP サーバーの使用方法について詳しくは、Google Cloud MCP サーバーの概要をご覧ください。

サーバー エンドポイント

MCP サービス エンドポイントは、安全で標準化された接続を確立するために AI アプリケーション（MCP クライアントのホスト）が使用する MCP サーバーのネットワーク アドレスと通信インターフェース（通常は URL）です。これは、LLM がコンテキストをリクエストしたり、ツールを呼び出したり、リソースにアクセスしたりするための接続ポイントとなります。Google MCP エンドポイントをグローバルまたはリージョンにすることができます。

Chat API MCP サーバーには、次のグローバル MCP エンドポイントがあります。

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

MCP ツール

MCP ツールは、現実世界でアクションを実行する目的で MCP サーバーが LLM または AI アプリケーションに対して公開する関数または実行可能な機能です。

ツール

chatmcp.googleapis.com MCP サーバーには、次のツールがあります。

MCP ツール
list_messages 指定された Google Chat の会話（スペース、ダイレクト メッセージ（DM）、グループ DM）からメッセージを取得します。スレッド、期間、メッセージ数でフィルタできます。また、メッセージの次のページを取得して、コンテキストを増やすこともできます。非公開メッセージ（1 人のユーザーにのみ表示されるメッセージ）は除外されます。
search_conversations

表示名で Google Chat の会話を検索します。

参加者のみが指定されている場合、このツールは、指定された参加者と呼び出し元のユーザーを含む 1 対 1 のダイレクト メッセージ（参加者が 1 人の場合）またはグループ チャット（参加者が複数の場合）を検索します。

クエリのみが指定されている場合、このツールは、クエリが会話の表示名の大文字と小文字を区別しない部分文字列である会話を検索します。

参加者とクエリの両方が指定されている場合、このツールは参加者で会話を検索し、表示名でフィルタします。

参加者もクエリも指定されていない場合、このツールは、呼び出し元のユーザーがメンバーであるすべての会話を一覧表示します。

このツールは、呼び出し元のユーザーがメンバーである会話のみを一覧表示します。

重要: 「conversations」リストが空の場合でも、全体の結果がなくなるわけではありません。'next_page_token' が存在する場合は、さらにページを取得できます。空のリストと 'next_page_token' が返された場合は、検索を続行するかどうかをお客様に確認してください。

MCP ツールの仕様を取得する

MCP サーバー内のすべてのツールの MCP ツール仕様を取得するには、tools/list メソッドを使用します。次の例は、curl を使用して、MCP サーバー内で現在使用可能なすべてのツールとその仕様を一覧表示する方法を示しています。

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