Перейти к документации
MCP-сервер

Чаты с ассистентом

Разговоры с ассистентом в приложении.

Инструменты чатов с ассистентом

ИнструментЧто делает
listChatsЧаты с ассистентом в приложении, сначала новые, с их названиями и числом сообщений в каждом. query ищет по названиям. Возвращаются по странице за раз.
getChatОдин чат по его id.
renameChatДать чату новое название.
deleteChatУдалить чат и каждое сообщение в нём навсегда. Ничего из того, что ассистент сделал в почтовом ящике, не отменяется.

К чатам есть доступ только у владельца рабочего пространства, через клиент, подключённый со всеми адресами. Для чтения нужна threads:read, а для изменений нужна threads:write.

У ассистента в приложении нет этих инструментов, поэтому чат никогда не переименовывает и не удаляет сам себя.

Справочник

listChats

Разрешенияthreads:readТолько в MCP, не в ассистенте приложенияНабор инструментовcore

The conversations held with the assistant in the OpenEmail app, as its Chats page lists them, newest first, each with its title, id and how many messages it holds. query searches the titles. Only the workspace owner reaches them. One page at a time: when more follow, the last line gives a cursor to pass back for the next page.

Входные данные

querystring
До 200 символов
sortstring
Одно из"newest""oldest""title"
limitinteger
Не меньше 1Не больше 100
cursorstring
От 1 до 2048 символов

Также доступно в

API
GET /chats
SDK
chats.list()chats.listAll()chats.iterate()

getChat

Разрешенияthreads:readТолько в MCP, не в ассистенте приложенияНабор инструментовcore

One chat with the assistant by its id: its title, how many messages it holds and when it last changed.

Входные данные

idstringОбязательно
Не пустое

Также доступно в

API
GET /chats/{id}
SDK
chats.get()

renameChat

Разрешенияthreads:writeТолько в MCP, не в ассистенте приложенияНабор инструментовcore

Give a chat with the assistant a new title.

Входные данные

idstringОбязательно
Не пустое
titlestringОбязательно
От 1 до 120 символов

Также доступно в

API
PATCH /chats/{id}
SDK
chats.rename()

deleteChat

Разрешенияthreads:writeТолько в MCP, не в ассистенте приложенияНабор инструментовcore

Delete a chat with the assistant and every message in it, for good. Nothing it did in the mailbox is undone. Ask the person first.

Входные данные

idstringОбязательно
Не пустое

Также доступно в

API
DELETE /chats/{id}
SDK
chats.delete()