Статьи

Пусть ассистент сделает скриншот

MCP — тот же API съёмки поверх Streamable HTTP. Адрес — /mcp на том же хосте. В заголовке Authorization тот же bearer-токен. Инструменты: list_devices, create_screenshot, create_screenshots и get_screenshot.

Статьи по API скриншотов

Что принимают инструменты

create_screenshot принимает те же поля, что POST /api/v1/screenshots, и ещё wait_seconds. Ожидание по умолчанию — 25 секунд, и оно не может быть больше 45. Ноль возвращает ответ, как только задание поставлено в очередь. Снимок из кэша возвращается сразу. create_screenshots принимает массив screenshots не более чем из 50 элементов. Ожидание у него по умолчанию равно нулю и общее на весь пакет. list_devices возвращает идентификаторы пресетов. get_screenshot принимает id.

Что приходит в ответе

create_screenshot и get_screenshot возвращают тот же JSON, что GET /api/v1/screenshots/:id. Готовые PNG, JPG или WebP размером не больше 1 МБ дополнительно возвращаются как изображение. HTML и Markdown размером не больше 100 КБ дополнительно возвращаются как текст. PDF и файлы крупнее остаются в image_url. create_screenshots возвращает массив JSON в порядке запроса и файлы не прикладывает. Клиент вроде Cursor отправляет адрес /mcp и заголовок bearer.

Чем этот адрес не является

GET, PUT, PATCH и DELETE на /mcp возвращают 405. Уведомление вроде notifications/initialized возвращает 202 с пустым телом. Токен по-прежнему токен API, поэтому нужен действующий тариф, и месячный лимит действует. Секреты каналов здесь не используются. Если ассистент не должен видеть токен, не добавляйте этот сервер в его конфигурацию.

Поля

Имена, которые принимает этот запрос
wait_seconds Сколько секунд ждёт create_screenshot. По умолчанию 25. Максимум 45. Ноль возвращает задание из очереди.
screenshots Массив для create_screenshots. Не больше 50 элементов. Те же поля, что у одной съёмки.
url Публичная страница. Вместо неё можно отправить html или markdown. Источник один.
viewport_device Необязательный идентификатор пресета. list_devices возвращает каталог.

Вопросы

Нужен ли для MCP второй токен?

Нет. Bearer-токен со страницы аккаунта и есть доступ к MCP. Он передаётся в заголовке Authorization.

Ассистент получит PNG в результате инструмента?

Да, если файл — готовые PNG, JPG или WebP не больше 1 МБ. Файлы крупнее и PDF возвращаются как image_url, чтобы скачать их отдельно.

Ассистент может снять 50 страниц?

Да. create_screenshots принимает до 50 элементов. У этого инструмента wait_seconds по умолчанию равен нулю, поэтому увеличьте его, если ассистент должен ждать, пока пакет завершится.

Другие статьи

Альтернативы, которые используют эти поля

Сравнения

Отправьте первый адрес

Создайте аккаунт, скопируйте bearer-токен и отправьте POST с публичным адресом, HTML или Markdown.