Как подключить FlipLink к Claude через MCP-сервер

Представь, что ты можешь просто попросить Claude — “преврати этот PDF во флипбук и опубликуй его” — и он действительно это делает. Именно это и даёт MCP-сервер FlipLink для Claude. После подключения Claude может создавать, выводить списком, публиковать и вести твои флипбуки через обычный разговор — кликать по панели управления больше не нужно.

Это руководство проведёт тебя через всю настройку — меньше пяти минут от старта до первой задачи.

Что тебе понадобится

Прежде чем что-то подключать, убедись, что у тебя есть:

• Node.js 18 или новее — сервер запускается через npx, поэтому Node — единственная зависимость во время выполнения. (Сервер не нужно устанавливать вручную; твой AI-клиент запускает его по требованию.)
• API-ключ FlipLink — войди на go.fliplink.me и возьми ключ на странице Subscription. Этот ключ авторизует каждое действие Claude, так что относись к нему как к паролю.

Вот и всё. Если ты ещё не работал с MCP-сервером (model context protocol), стоит потратить две минуты на чтение: что такое MCP-сервер.

Подключи FlipLink к Claude Code (одна команда)

Если ты пользуешься Claude Code, вся настройка — это одна команда. Подставь свой ключ и запусти:

claude mcp add fliplink -e FLIPLINK_API_KEY=<YOUR_KEY> -- npx -y fliplink-mcp

Эта команда регистрирует FlipLink как MCP-сервер, передаёт твой API-ключ через переменную окружения и говорит Claude запускать сервер через npx всякий раз, когда он понадобится. Флаг -y позволяет npx скачать пакет без интерактивного запроса. Перезапусти сессию Claude Code — и инструменты FlipLink станут доступны.

Подключи Claude Desktop (блок конфигурации)

Claude Desktop (и другие клиенты, например Cursor или Codex) используют вместо этого JSON-конфиг. Добавь запись mcpServers вот так:

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

Замени <YOUR_KEY> на свой настоящий ключ, сохрани конфиг и перезапусти клиент. При следующем запуске инструменты FlipLink загрузятся автоматически. Значение FLIPLINK_MCP_MODE задаёт, какие действия разрешены — подробнее об этом ниже.

Проверь подключение

Прежде чем просить Claude о настоящей работе, убедись, что всё подключено. Самая простая проверка — это инструмент состояния верхнего уровня whoami. Просто попроси Claude:

“Запусти инструмент FlipLink whoami.”

Claude вызывает инструмент и возвращает данные твоего аккаунта и максимальный размер загрузки. Если ключ отсутствует или указан неверно, сервер вместо этого отвечает понятной инструкцией по настройке — так непонятная ошибка превращается в исправимую.

🚀

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

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

Drop your PDF here or click to browse

Макс. 40 МБ

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

Как выглядит вызов инструмента

Тебе никогда не приходится вводить имя инструмента самому. Ты описываешь, что хочешь, простыми словами, а Claude выбирает нужный инструмент, заполняет аргументы и запускает его. Инструменты FlipLink генерируются прямо из спецификации API и названы по схеме <noun>_<verb> — так что по ходу работы Claude ты будешь видеть вызовы вроде flipbook_create_by_file, flipbook_publish, flipbook_set_skin или leads_list.

За кулисами каждый инструмент сопоставлен с реальным эндпоинтом API FlipLink. Если когда-нибудь захочешь увидеть форму запросов, параметры и живую консоль Try-It, полный справочник по API описывает каждый из них — и там же находится твой API-ключ.

Твоя первая задача

А теперь самое интересное. Передай Claude PDF и попроси:

“Создай флипбук из этого PDF и назови его Q3 Report.”

Claude вызывает flipbook_create_by_file, загружает файл и возвращает ID нового флипбука и ссылку для общего доступа. Дальше можно продолжать в том же разговоре:

“Теперь опубликуй его и дай мне ссылку для общего доступа.”

Claude последовательно выполняет flipbook_publish и flipbook_get_share_link и возвращает ссылку, которую можно сразу отправить. Никаких переключений между вкладками, никаких ручных шагов — просто разговор, который создаёт настоящие, опубликованные флипбуки. Чтобы увидеть более широкую картину того, что это открывает, посмотри автоматизацию флипбуков на естественном языке.

Пара слов о режимах (безопасный по умолчанию)

MCP-сервер поставляется с защитным механизмом, который стоит понимать: настройка FLIPLINK_MCP_MODE контролирует, к каким инструментам может обращаться Claude.

• readonly — 19 инструментов, только чтение. Claude может выводить списки и просматривать, но никогда ничего не меняет.
• safe — 79 инструментов, режим по умолчанию. Чтение плюс обратимая запись и управление доступом; без удаления, без коммерческих действий. Это правильная отправная точка почти для всех.
• full — все 87 инструментов, включая разрушительные и связанные с деньгами действия.

Даже в режиме full есть вторая страховка: инструменты удаления и продажи/тарификации никогда не срабатывают с первого вызова. Сервер возвращает превью в одну строку плюс токен подтверждения с коротким сроком жизни (привязанный к этим конкретным аргументам, с истечением через пять минут), и Claude обязан показать тебе превью и вызвать инструмент снова с этим токеном, прежде чем произойдёт что-то необратимое. Если хочешь полный разбор того, как работают эти защитные механизмы, прочитай защитные механизмы MCP-сервера.

Начни общаться со своими флипбуками

Подключение FlipLink к Claude превращает управление флипбуками в разговор. Одна команда (или один блок конфигурации), быстрая проверка whoami — и ты уже просишь Claude собирать и публиковать флипбуки за тебя — безопасно, ведь режим safe защищает тебя из коробки.

Готов начать? Возьми ключ на странице Subscription, запусти команду настройки и попроси Claude создать его первый флипбук.

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

• Обзор MCP-сервера FlipLink
• Что такое MCP-сервер?
• Защитные механизмы MCP-сервера (readonly / safe / full)
• Автоматизация флипбуков на естественном языке
• Функция «Доступ к API»
• Справочник по FlipLink CLI