MCP Tools Reference: chatmcp.googleapis.com

Инструмент: send_message

Отправляет сообщение из Google Chat в диалог.

Этот инструмент использует в качестве входных данных идентификатор беседы, необязательный идентификатор ветки обсуждения и текст сообщения. Идентификаторы бесед можно найти с помощью инструмента search_conversations. Он возвращает созданное сообщение.

В следующем примере показано, как использовать curl для вызова инструмента MCP send_message .

Запрос Curl 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "send_message",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

Запрос на отправку сообщения в чат Google.

SendMessageRequest

JSON-представление 
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
Поля
conversationId

string

Обязательно. Идентификатор беседы (например, 'spaces/AAAA...'), на которую нужно отправить сообщение.

threadId

string

Необязательный параметр. Идентификатор ветки обсуждения (например, 'spaces/AAAA.../threads/BBBB...'), в которую будет отправлено сообщение. Если не указан, сообщение будет отправлено в новую ветку обсуждения.

messageText

string

Обязательно. Основное содержимое сообщения. Базовое форматирование можно добавить, используя подмножество Markdown. Информацию о форматировании сообщений см. в разделе «Форматирование сообщений» . Поддерживается следующее форматирование:

  • Жирным шрифтом: *text*
  • Курсив: _text_
  • Зачеркнуто: ~text~
  • Моноширинный шрифт: text
  • Моноширинный блок: 
```
line 1
line 2
```
  • Маркированный список: 
* item 1
* item 2
  • Цитата в блочном формате: > quoted text
  • Гиперссылка: <url|display text>
  • Укажите пользователя: <users/{user_id}>

Схема вывода

Ответ на отправку сообщения в чате Google.

Отправить сообщениеОтвет

JSON-представление 
{
  "message": {
    object (ChatMessage)
  }
}
Поля
message

object ( ChatMessage )

Отправленное сообщение.

Сообщение в чате

JSON-представление 
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}
Поля
messageId

string

Имя ресурса сообщения. Формат: spaces/{space}/messages/{message}

threadId

string

Ветка обсуждения, к которой относится это сообщение. Если сообщение не относится к какой-либо ветке, это поле будет пустым. Формат: пробелы/{пробел}/ветки/{ветка}

plaintextBody

string

Текст сообщения в обычном формате.

sender

object ( User )

Отправитель сообщения.

createTime

string

Только вывод. Отметка времени создания сообщения.

threadedReply

boolean

Является ли сообщение ответом на сообщение в ветке обсуждения.

attachments[]

object ( ChatAttachmentMetadata )

Приложения, вложенные в сообщение.

reactionSummaries[]

object ( ReactionSummary )

Сводка реакций с помощью эмодзи, включенная в сообщение.

Пользователь

JSON-представление 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Поля
userId

string

Имя ресурса пользователя чата. Формат: users/{user}.

displayName

string

Отображаемое имя пользователя чата.

email

string

Адрес электронной почты пользователя. Это поле заполняется только в том случае, если тип пользователя — HUMAN.

userType

enum ( UserType )

Тип пользователя.

Метаданные вложения чата

JSON-представление 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
Поля
attachmentId

string

Имя ресурса вложения. Формат: пробелы/{пробел}/сообщения/{сообщение}/вложения/{вложение}.

filename

string

Название вложенного файла.

mimeType

string

Тип содержимого (MIME-тип).

source

enum ( Source )

Источник вложения.

РеакцияКраткое содержание

JSON-представление 
{
  "emoji": string,
  "count": integer
}
Поля
emoji

string

Строка в формате Юникода для эмодзи или пользовательское имя эмодзи.

count

integer

Общее количество реакций с использованием соответствующего эмодзи.

Тип пользователя

Тип пользователя Google Chat.

Перечисления
USER_TYPE_UNSPECIFIED Не указано.
HUMAN Пользователь-человек.
APP Пользователь приложения.

Источник

Источник вложения.

Перечисления
SOURCE_UNSPECIFIED Сдержанный.
DRIVE_FILE Это файл из Google Диска.
UPLOADED_CONTENT Файл загружен в чат.

Аннотации инструментов

Подсказка о разрушительном эффекте: ❌ | Подсказка об идемпотентности: ❌ | Подсказка только для чтения: ❌ | Подсказка об открытом мире: ✅