MCP-сервер
Файлы
Каждое вложение, которое хранит почтовый ящик.
Инструменты файлов
| Инструмент | Что делает |
|---|---|
| listFiles | Каждое вложение, которое хранит ящик, отправленное и полученное, с поиском по имени, фильтром по виду и сортировкой: сначала новые, сначала старые, самые большие или по имени. Возвращается постранично. |
| getFile | Один файл со всеми ссылками для скачивания, с которыми он ушёл, и числом скачиваний по каждой. |
| deleteFile | Удаляет файл навсегда: его байты исчезают, и все ссылки для скачивания перестают работать. Чат всегда сначала спрашивает. |
Файл это часть письма, с которым он пришёл, поэтому для чтения нужен threads:read, а для удаления threads:write. Тот, кто ограничен некоторыми адресами, видит только файлы, пришедшие на них, а удалить файл может только владелец ящика.
Инструменты читают индекс файлов, а не байты. Скачать файл можно через GET /files/{id}/content в REST API или files.download в SDK.