---
title: "MCP инструменты — Heretic Lazy Shot"
description: "Полный справочник MCP-инструментов Heretic Lazy Shot. Захват, OCR, маркеры, beautify и поиск — управляйте приложением из Claude, Cursor и любого MCP-совместимого агента."
canonical: https://giglabo.com/ru/heretic/applications/heretic-lazy-shot/docs/mcp-tools
locale: ru
---

# MCP инструменты — Heretic Lazy Shot

> Markdown twin of https://giglabo.com/ru/heretic/applications/heretic-lazy-shot/docs/mcp-tools
> Fetch this instead of the HTML page: same content, a fraction of the bytes.
> Site structure and the full page list for agents: https://giglabo.com/llms.txt

Полный справочник MCP-инструментов Heretic Lazy Shot. Захват, OCR, маркеры, beautify и поиск — управляйте приложением из Claude, Cursor и любого MCP-совместимого агента.

## MCP инструменты

Heretic Lazy Shot открывает все основные действия через встроенный сервер **Model Context Protocol**. Любой MCP-совместимый агент снимет, распознаёт текст, расставит маркеры и откроет композитор без мышки.

> **Гигиена ключей.** Каждый захват требует короткий описательный `keyword`, например `chrome-settings` или `login-page`. При совпадении ключ автоматически суффиксируется (`login-page` → `login-page2`). Всегда показывайте пользователю *возвращённый* ключ.

## Захват

| Инструмент | Когда использовать |
| --- | --- |
| `capture_display` | Целый монитор |
| `capture_region` | Прямоугольник в пикселях на мониторе |
| `capture_window` | Конкретное приложение по названию / процессу (нечёткий матч — предпочтительно) |
| `capture_active_window` | Активное окно — рискованно из-под агента (может захватить собственный терминал) |
| `capture_tracked_window` | Выбор из стека недавно активных окон (нужен флаг `windowTracker`) |

### Примеры

```json
// capture_window — конкретное приложение
{ "query": "Chrome", "keyword": "chrome-settings" }
```

```json
// capture_region — прямоугольник на мониторе 0
{ "x": 100, "y": 200, "width": 800, "height": 600, "keyword": "header-crop" }
```

```json
// capture_display — монитор 0 целиком
{ "display": 0, "keyword": "full-desktop" }
```

## Обнаружение и списки

| Инструмент | Назначение |
| --- | --- |
| `list_displays` | Подключённые мониторы и геометрия |
| `list_tracked_windows` | Недавно активные окна — вызывайте перед `capture_tracked_window` |
| `list_screenshots` | Листать галерею; фильтр по статусу / типу / сортировке |
| `search_screenshots` | Поиск по имени файла, ключу, метаданным — с диапазоном дат и типом |
| `get_screenshot` | Полные метаданные снимка (по id или ключу) |
| `get_app_status` | Версия, порт MCP, флаги фич |
| `list_ocr_languages` | Доступные / установленные пакеты OCR |
| `list_marker_presets` / `search_marker_presets` / `get_marker_preset` | Сохранённые пресеты маркеров |

```json
// search_screenshots
{ "query": "dashboard", "date_from": "2026-04-01", "type": "window" }
```

Значения `type`: `region | window | display | beautify | markers`.

## Действия над снимком

| Инструмент | Назначение |
| --- | --- |
| `assign_keyword` | Переименовать / тегировать — вызывайте сразу после захвата для стабильного имени |
| `edit_screenshot` | Открыть в композиторе Beautify. `edit_existing: true` перезаписывает; по умолчанию создаётся копия |
| `delete_screenshot` | Мягкое удаление |
| `open_screenshot` | Открыть в системном просмотрщике (Preview на macOS) |
| `show_window` | Показать или скрыть окно самого lazy-shot |

```json
// переименовать после захвата
{ "id": "chrome-settings", "keyword": "chrome-settings-dark" }

// открыть в композиторе (по умолчанию — копия)
{ "id": "chrome-settings" }
```

## Маркеры — `add_markers`

Наложить нумерованные или подписанные пины. Можно передать массив маркеров **или** указать сохранённый пресет.

```json
{
  "screenshot_id": "chrome-settings",
  "keyword": "chrome-settings-annotated",
  "markers": [
    { "x": 120, "y": 80,  "label": "1", "color": "#FF0000", "size": 32 },
    { "x": 340, "y": 200, "label": "2", "color": "#00AA00" }
  ]
}
```

Для переиспользуемых схем сохраните пресет в приложении и вызывайте через `get_marker_preset`.

## OCR

Две точки входа:

- `ocr_screenshot` — OCR по элементу галереи (по id или ключу)
- `ocr_image_path` — OCR по любому файлу внутри директории screenshots / app-data

Ключевые параметры:

| Параметр | Значения | Примечание |
| --- | --- | --- |
| `format` | `text` · `metadata` · `text_and_metadata` | `metadata` возвращает боксы слов и confidence |
| `variant` | `fast` · `best` | `best` — только если `fast` искажает текст |
| `lang` | например `eng`, `rus`, `eng+rus` | Неустановленные пакеты скачиваются автоматически при первом вызове (~4 МБ) |

```json
{ "id": "login-page", "lang": "eng+rus", "format": "text_and_metadata" }
```

## Формат ответа

Инструменты захвата возвращают унифицированный объект, чтобы агенты могли связывать цепочки:

```json
{
  "id": "chrome-active-view-222",
  "keyword": "chrome-active-view",
  "path": "/Users/you/Pictures/lazy-shot/chrome-active-view-222.png",
  "width": 2880,
  "height": 1800,
  "type": "window"
}
```

Связывайте `capture_window` → `add_markers` → `edit_screenshot` → `ocr_screenshot` по `id` или `keyword` из каждого шага.

## Промпт-рецепты

### «Оформи активную вкладку Chrome»

```
Захвати окно Chrome с ключом "chrome-active-view",
затем открой его в редакторе beautify.
```

Под капотом: `capture_window({ query: "Chrome", keyword: "chrome-active-view" })` → `edit_screenshot({ id: "chrome-active-view" })`.

### «Сними баг и расставь три маркера»

```
Захвати область x=0 y=0 w=1400 h=900 на мониторе 0 с ключом "bug-42".
Расставь три нумерованных маркера в (120,80), (340,200) и (540,420).
Сохрани результат как "bug-42-annotated" и открой его.
```

### «OCR страницы логина на англ + рус»

```
Захвати текущее окно Chrome как "login-page", затем прогоняй OCR
с lang=eng+rus и format=text_and_metadata. Верни распознанный текст.
```

### «Найди все скриншоты дашборда за апрель»

```
search_screenshots: query="dashboard", type="window",
date_from="2026-04-01". Верни id и пути.
```

### «Пересними из стека отслеживаемых окон»

```
list_tracked_windows. Если Slack есть в списке — выполни
capture_tracked_window с ключом "slack-thread".
Иначе захвати Slack через capture_window.
```

## Безопасность

- Все инструменты работают **локально** — никаких облачных вызовов и сетевого исхода
- `capture_active_window` рискованно из-под агента (может захватить собственный терминал) — предпочитайте `capture_window` с явным `query`
- Конфликт ключей суффиксируется автоматически (`rabbit` → `rabbit2`) — используйте *возвращённый* ключ в последующих вызовах
- Неустановленные пакеты OCR скачиваются автоматически при первом вызове (~4 МБ)

Настройка Claude Desktop, Claude Code, Cursor и Copilot — в разделе [интеграции](https://giglabo.com/ru/heretic/applications/heretic-lazy-shot/docs/integrations).

## Related

- HTML version of this page: https://giglabo.com/ru/heretic/applications/heretic-lazy-shot/docs/mcp-tools
- Site map for agents: https://giglabo.com/llms.txt