MCP Tools Reference: chatmcp.googleapis.com

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

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

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

Идентификаторы диалогов можно найти с помощью инструмента search_conversations .

Возвращает созданное сообщение.

Приведённый ниже пример кода демонстрирует, как использовать curl для вызова инструмента MCP send_message .

Запрос Curl 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

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~~
  • Моноширинный шрифт: text
  • Моноширинный блок: 
```
line 1
line 2
```
  • Маркированный список: 
* item 1
* item 2
  • Упорядоченный список: 
1. item 1
2. item 2
  • Цитата в блочном формате: > quoted text
  • Гиперссылка: [label](url)
  • Упоминание пользователя: используйте самозакрывающийся HTML-тег chat-user с атрибутами data-email="user@example.com" или data-user="users/USER_ID" . Предпочтительнее использовать атрибут data-user с USER_ID , если он известен, в противном случае используйте атрибут data-email с адресом электронной почты пользователя. При использовании атрибута data-user обязательно включите префикс users/, который отображается в значениях, возвращаемых другими инструментами. Примечание: допускается не более 10 упоминаний в одном сообщении. Упоминание всех пользователей (например, с помощью @all или HTML-тега users/all ) строго запрещено.
  • Пользовательские эмодзи: используйте самозакрывающийся HTML-тег chat-emoji с атрибутами data-custom-emoji="customEmojis/abc" или data-emoji-name=":xyz:" .

Схема вывода

Ответ на отправку сообщения в чате 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

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

threadId

string

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

plaintextBody

string

Текст сообщения, оформленный в формате Markdown.

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 Файл загружен в чат.

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

Аннотации к инструментам отправляются клиентам MCP для описания основных рисков, связанных с данным инструментом. Большинство клиентов считают эти подсказки недостоверными, но они могут использоваться для определения момента отправки пользователю запроса на подтверждение.

Наряду со строкой заголовка, определены следующие логические подсказки:

  • readOnlyHint : Если true, инструмент не изменяет свою среду. По умолчанию: false.
  • destructiveHint : Если true, то инструмент может выполнять деструктивные действия. Если false, то инструмент может выполнять только аддитивные действия. По умолчанию: true.
  • idempotentHint : Если true, то многократный вызов инструмента с одними и теми же аргументами не окажет дополнительного влияния на его окружение. По умолчанию: false.
  • openWorldHint : Если true, то инструмент может взаимодействовать с «открытым миром» внешних объектов. Если false, то инструмент может взаимодействовать только с внутренними объектами. Например, инструмент веб-поиска будет представлять собой открытый мир, а инструмент для работы с памятью — нет.

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

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.create