CLI, API или MCP во FlipLink: какую интеграцию выбрать?

FlipLink даёт три способа автоматизировать флипбуки, не открывая панель управления: инструмент командной строки, REST API и MCP-сервер для ИИ-ассистентов. Звучит как три разных продукта, но это не так. Это три двери к одному и тому же движку — те же эндпоинты, те же данные, тот же аккаунт.

Поэтому настоящий вопрос не «что лучше?», а «что подходит именно для того, что ты делаешь прямо сейчас?». В этом руководстве — беспристрастное сравнение и простое правило «выбери одно».

Три двери, один API

Всё, что FlipLink умеет делать программно, проходит через один REST API по адресу https://go.fliplink.me с авторизацией через заголовок X-Api-Key. И CLI, и MCP-сервер построены прямо поверх того же API — более того, список команд CLI и список инструментов MCP генерируются из одной и той же спецификации эндпоинтов, так что они не могут рассинхронизироваться.

Отсюда полезный вывод: что можно сделать в одном, можно сделать и во всех трёх. Разница лишь в том, кто за рулём и сколько кода ты хочешь написать — а не в возможностях.

Матрица выбора

У всех трёх одна и та же модель ответа: каждый ответ — это JSON с полем Result верхнего уровня, равным "OK" или "ERROR", и один и тот же лимит в 300 запросов в минуту на ключ.

Когда что выбирать

CLI — для скриптов, терминалов и CI/CD

Используй CLI, когда живёшь в терминале или в пайплайне. Это самый быстрый путь от «у меня есть PDF» до «у меня есть опубликованный флипбук» без написания HTTP-клиента. Заверни его в shell-скрипт, cron-задачу или шаг GitHub Actions — и получишь повторяемую автоматизацию. Добавь --json к любой команде и передай вывод в jq для скриптов. Смотри как начать работу с CLI.

API — для приложений

Используй API, когда FlipLink — это функция внутри того, что ты создаёшь: клиентский портал, который генерирует флипбуки при регистрации, дашборд, который подтягивает данные сбора лидов, или синхронизация с CRM. Ты получаешь полный контроль и можешь вызывать его из любого языка, который умеет в HTTP. В справочнике по API есть каждый эндпоинт и живая консоль Try-It.

MCP — для ИИ-ассистентов и тех, кто не пишет код

Используй MCP-сервер, когда человеку (или агенту), который делает работу, незачем знать о существовании эндпоинтов. Подключи FlipLink к Claude, Cursor или другому MCP-клиенту — и можно сказать «опубликуй презентацию за третий квартал и дай мне ссылку для общего доступа» обычными словами. Ассистент сам подберёт нужный инструмент и заполнит параметры. Это вариант с наименьшим порогом входа для тех, кто не пишет код, — и он идёт с защитными ограничениями, так что разрушительные действия сначала требуют подтверждения.

🚀

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

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

Drop your PDF here or click to browse

Макс. 40 МБ

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

Их можно сочетать

Они не исключают друг друга. Частая схема использует все три: API питает твоё боевое приложение, CLI запускает ночные пакетные задачи в CI, а MCP-сервер позволяет команде создавать разовые флипбуки, попросив об этом ИИ-ассистента. Один аккаунт, одни флипбуки, одни данные — просто разные двери для разных моментов.

Одна задача, три способа

Вот ровно один и тот же результат — создать флипбук из PDF — через каждую дверь.

CLI — одна команда в твоём терминале:

fliplink flipbook create ./q3-report.pdf --title "Q3 Report" --name q3

API — HTTP-запрос, который ты делаешь из кода:

curl -X POST 'https://go.fliplink.me/api/create-by-file' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -F 'File=@q3-report.pdf' \
  -F 'Name=q3' \
  -F 'Title=Q3 Report'

MCP — естественный язык в твоём ИИ-клиенте:

«Создай флипбук из q3-report.pdf с названием ‘Q3 Report’.»

За кулисами ассистент вызывает инструмент flipbook_create_by_file с теми же параметрами, что и запрос curl выше. Все три возвращают один и тот же JSON — {"Result":"OK","ID":"90001","URL":"https://go.fliplink.me/view/<slug>", ...} — потому что все три обращаются к одному эндпоинту.

Краткое руководство «выбери одно»

• Пишешь скрипт или CI/CD-пайплайн? → CLI
• Встраиваешь создание флипбуков в своё приложение? → API
• Хочешь, чтобы это делал ИИ-ассистент или человек без кода? → MCP
• Не уверен? Начни с CLI — это самый быстрый способ увидеть результат, а то, что ты освоишь, напрямую переносится на API.

Через какую дверь ни войди, ты используешь один и тот же движок FlipLink. Выбери тот, что подходит под то, как ты работаешь сегодня, — всегда можно добавить ещё один позже.

Читайте также

• Как начать работу с FlipLink CLI
• Подключи FlipLink к Claude через MCP-сервер
• Что такое MCP-сервер?
• Как использовать FlipLink API для своих интеграций
• Автоматизация и интеграции
• Доступ к API