Создаём ИИ-агента, который собирает флипбуки

Что, если бы “опубликуй отчёт за этот месяц как флипбук” компьютер делал сам — без панели управления, без загрузки файлов, без копирования ссылки в письмо вручную? В этом и суть ИИ-агента для документов: ты описываешь результат, а агент вызывает нужные инструменты в нужном порядке, чтобы этого добиться.

В этом руководстве показано, как собрать такого агента с помощью MCP-сервера FlipLink и Claude. Агент возьмёт только что сгенерированный PDF-отчёт, создаст из него флипбук, опубликует его и вернёт ссылку для доступа — именно то, что можно поставить на расписание и забыть. Заодно честно разберём, где полностью автономный агент упирается в реальные ограничения и когда обычный скрипт (CLI) подходит лучше.

Сценарий: месячный отчёт, который публикуется сам

Представь повторяющуюся задачу. Первого числа каждого месяца какой-то конвейер выдаёт report.pdf — цифры продаж, рассылку, презентацию для совета директоров. Сегодня человек загружает его в панель управления, публикует, копирует ссылку и вставляет её куда-нибудь. Мы хотим автоматизировать это с помощью агента, который способен рассуждать о шагах, а не жёстко прописывать каждый из них вручную.

Агенту нужно уметь: создать флипбук из файла, опубликовать его и получить ссылку для доступа. Если MCP-сервер FlipLink подключён, эти действия соответствуют реальным инструментам, которые модель может вызывать напрямую.

Шаг 1 — Подключаем MCP-сервер

Model Context Protocol — это способ, которым ИИ-клиент (Claude, Cursor и другие) находит и вызывает внешние инструменты. MCP-сервер FlipLink предоставляет API FlipLink в виде набора инструментов, которые модель может использовать в диалоге.

Полное пошаговое описание см. в материале Подключаем FlipLink к Claude через MCP-сервер. Если коротко — ставить вручную ничего не нужно, клиент запускает сервер через npx:

claude mcp add fliplink -e FLIPLINK_API_KEY=YOUR_API_KEY -- npx -y fliplink-mcp

Или в виде блока конфигурации mcpServers (Claude Desktop, Cursor, Codex):

{
  "mcpServers": {
    "fliplink": {
      "command": "npx",
      "args": ["-y", "fliplink-mcp"],
      "env": { "FLIPLINK_API_KEY": "YOUR_API_KEY", "FLIPLINK_MCP_MODE": "safe" }
    }
  }
}

Инструменты генерируются из спецификации FlipLink и называются по схеме <noun>_<verb> — так что агент увидит flipbook_create_by_file, flipbook_publish, flipbook_get_share_link, а также проверку состояния верхнего уровня whoami и другие. Ключ можно получить, войдя на go.fliplink.me.

Шаг 2 — Пишем промпт для агента

Агент по сути — это модель плюс цикл: он читает цель, решает, какой инструмент вызвать, читает результат и решает, что делать дальше, пока цель не достигнута. Качество этого цикла почти целиком зависит от понятного промпта, в котором названы инструменты, их порядок и условие успеха.

Вот реалистичный системный и пользовательский промпт для агента, публикующего месячный отчёт:

SYSTEM:
You are a publishing agent for FlipLink. Your job is to turn a PDF report
into a published flipbook and return its share link. You have FlipLink MCP
tools available (names follow the pattern noun_verb).

Operating rules:
1. Start by calling `whoami` to confirm the API key works and check the
   remaining flipbook quota. If `whoami` fails, STOP and report the error.
2. Create the flipbook from the file with `flipbook_create_by_file`
   (field File = the PDF path; set Name and Title from the task).
3. Read the result. Every FlipLink response has a top-level `Result` field
   that is "OK" or "ERROR". If `Result` is "ERROR", STOP and report the
   `Message` — do NOT retry blindly or proceed.
4. On success, capture the returned flipbook ID.
5. Publish it with `flipbook_publish` using that ID. Check `Result` again.
6. Fetch the share link with `flipbook_get_share_link`.
7. Report back: the flipbook ID, the published share URL, and the quota left.

Never invent tool names or IDs. If a step has no clear next action,
stop and explain rather than guessing.

TASK:
Publish this month's report. File: ./reports/2026-06-report.pdf
Title: "June 2026 Report". Name: "june-2026-report".

Этот промпт работает благодаря двум вещам. Во-первых, он велит агенту ветвиться по полю Result — FlipLink возвращает прикладные ошибки как HTTP 200 с Result: "ERROR", поэтому наивная проверка “вернул ли вызов 200?” молча приняла бы сбои за успехи. Во-вторых, он задаёт явное условие остановки для каждого пути с ошибкой, и это не даёт автономному запуску свалиться в бесконечные повторы.

Шаг 3 — Ограничители для автономных запусков

Здесь нужно смотреть на вещи трезво. По умолчанию MCP работает в режиме safe (79 инструментов): чтение плюс обратимая запись, без удаления и без коммерческих инструментов. Наш агент для месячного отчёта только создаёт, публикует и читает — всё это укладывается в режим safe — так что для этой задачи можно оставить настройки по умолчанию, и агент отработает от начала до конца без трения.

С разрушительными действиями история другая. Если твоему агенту когда-нибудь понадобится удалить флипбук или затронуть цены и продажи, он должен работать в режиме full (87 инструментов). В режиме full инструменты удаления и оплаты никогда не срабатывают с первого вызова: сервер возвращает однострочный предпросмотр плюс короткоживущий confirm_token (привязанный к конкретным аргументам, срок жизни — 5 минут), и ассистент обязан вызвать инструмент повторно уже с этим токеном. Этот барьер живёт в сервере — сам API FlipLink остаётся без изменений.

Будь честен в том, что это означает для “полной автономности”:

• Агент, который читает, создаёт и публикует, в режиме safe может работать автономно и чисто. Ни одно его действие не требует подтверждения.
• Агент, который удаляет, не может одновременно быть и без трения, и автономным. Барьер с confirm-token стоит там не случайно. Либо человек одобряет разрушительный шаг, либо твой обвязочный код работает в режиме full и явно обрабатывает в коде цепочку предпросмотр → confirm-token → повторный вызов. Не проектируй конвейер, который рассчитывает, что флипбук молча удалит себя сам без подтверждения, — этого не будет, и в этом весь смысл.

Полный разбор режимов и работы confirm-token см. в материале Безопасность и ограничители MCP-сервера. У инструментов также есть MCP-аннотации (readOnlyHint, destructiveHint, idempotentHint), так что аккуратная обвязка может оценить риск до того, как что-либо вызовет.

🚀

Попробуйте FlipLink бесплатно

Преобразуйте PDF за секунды. Без регистрации и кредитной карты — просто загрузите файл.

Drop your PDF here or click to browse

Макс. 40 МБ

На платных тарифах от $39 лимит вырастает до 150 MB.

Шаг 4 — Ставим на расписание

Когда агент стабильно отрабатывает вручную, поставь его на таймер. Как именно — зависит от твоего клиента: cron-задача, которая запускает Claude в безголовом режиме с промптом задачи, плановый workflow или собственная оркестрация. Механика здесь не рассматривается; важно то, что плановый запуск делают безопасным именно промпт и режим, а не сам планировщик. Держи агента в режиме safe для задач создания и публикации, и запуск останется автономным, не упираясь в стену подтверждений.

Шаг 5 — Проверяем результат

Не верь на слово “агент сказал, что всё получилось”. Проверь реальный артефакт:

• Итоговый отчёт агента должен содержать ID флипбука и ссылку для доступа. Открой ссылку — должен загрузиться опубликованный флипбук.
• Сверь квоту через whoami до и после, чтобы убедиться, что создание действительно заняло один слот, а не завершилось тихой ошибкой.
• Поскольку результат каждого инструмента несёт поле Result, грамотно собранный агент при сбое покажет точное поле Message. Если запуск вернул Result: "ERROR", прочитай сообщение, а не запускай заново — превышение квоты или слишком большой файл сами собой при повторе не исправятся.

Когда CLI — инструмент лучше

Вот честный контраргумент ко всему сказанному выше: для безголовой, детерминированной задачи в CI LLM-агент обычно вообще не нужен.

ИИ-агент хорош, когда задача требует суждения — решить, как что-то озаглавить, отреагировать на неоднозначный ввод или связать шаги, которые ты не расписал до конца. Но “возьми вот этот конкретный файл, создай флипбук, опубликуй его, выведи ссылку” не содержит никакой неоднозначности. Запускать ради этого LLM — значит добавить стоимость, задержку и недетерминированность безо всякой пользы, и при этом тебе всё равно придётся обрабатывать то же ветвление по Result.

Для такого случая возьми CLI FlipLink. Он сгенерирован из той же спецификации, что MCP-сервер и API, поэтому не может разойтись с ними, и возвращает чистые коды выхода (0 — успех, 1 — ошибка запроса, 2 — прикладная ошибка), по которым CI может ветвиться без всякого разбора вывода:

fliplink config set-key "$FLIPLINK_API_KEY"
ID=$(fliplink flipbook create ./reports/2026-06-report.pdf \
  --title "June 2026 Report" --name june-2026-report --json | jq -r '.ID')
fliplink flipbook publish "$ID"
fliplink flipbook share-link "$ID"

Вот и весь месячный процесс, никакой модели не нужно. Полный конвейер — включая запуск внутри непрерывной интеграции — описан в материале Автоматизируем публикацию флипбуков в CI/CD.

Практическое правило: бери ИИ-агента, когда задача требует суждения; бери CLI, когда задача должна выполняться одинаково каждый раз. Многие команды используют и то, и другое — агента для разовых запросов “опубликуй это за меня”, а CLI для плановых, механических запусков.

Начни собирать

ИИ-агент для документов убирает ручную середину публикации: ты называешь результат, а он вызывает инструменты. С FlipLink MCP в режиме safe агент, который создаёт и публикует, работает от начала до конца без трения — а там, где в дело вступают разрушительные действия, барьер с confirm-token делает автономные запуски честными, а не опасными.

Готов? Подключи MCP-сервер, направь агента на отчёт и смотри, как он его публикует. Для детерминированного пути в CI всё необходимое есть в документации CLI. Полный каталог эндпоинтов лежит в справочнике по API.

Дополнительное чтение

• Подключаем FlipLink к Claude через MCP-сервер
• Безопасность и ограничители MCP-сервера
• Автоматизация флипбуков на естественном языке
• Автоматизируем публикацию флипбуков в CI/CD
• Документация CLI FlipLink
• Справочник по API FlipLink