Статьи
MCP — тот же API съёмки поверх Streamable HTTP. Адрес — /mcp на том же хосте. В заголовке Authorization тот же bearer-токен. Инструменты: list_devices, create_screenshot, create_screenshots и get_screenshot.
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 возвращает каталог. |
Нет. Bearer-токен со страницы аккаунта и есть доступ к MCP. Он передаётся в заголовке Authorization.
Да, если файл — готовые PNG, JPG или WebP не больше 1 МБ. Файлы крупнее и PDF возвращаются как image_url, чтобы скачать их отдельно.
Да. create_screenshots принимает до 50 элементов. У этого инструмента wait_seconds по умолчанию равен нулю, поэтому увеличьте его, если ассистент должен ждать, пока пакет завершится.
Создайте аккаунт, скопируйте bearer-токен и отправьте POST с публичным адресом, HTML или Markdown.