Как использовать FlipLink в Cursor и других MCP-клиентах

Если ты уже работаешь в Cursor, тебе не нужно выходить из редактора, чтобы взаимодействовать с FlipLink. Подключи MCP-сервер FlipLink — и встроенный ИИ Cursor сможет создавать флипбуки, публиковать их, выгружать лиды и многое другое, просто по запросу на обычном языке. Та же конфигурация работает в Claude Desktop, Codex и любом другом инструменте, который понимает Model Context Protocol.

В этом руководстве разберём настройку для Cursor, а затем покажем универсальную конфигурацию, которая подходит для любого MCP-клиента.

Что такое MCP-клиент

MCP-клиент — это любое приложение, которое умеет подключаться к MCP-серверам и давать своему ИИ доступ к инструментам, которые эти серверы предоставляют. Cursor, Claude Desktop и Codex — всё это MCP-клиенты. Model Context Protocol — это открытый стандарт, который позволяет им общаться с сервером вроде fliplink-mcp без всякого дополнительного кода-обвязки.

Когда ты подключаешь MCP-сервер FlipLink, клиент запускает его в фоне, и ИИ получает набор инструментов FlipLink — например, flipbook_create_by_file, flipbook_publish и leads_list. Только знакомишься с темой? Начни с того, что такое MCP-сервер, а потом возвращайся сюда.

Где находится конфигурация MCP в Cursor

Cursor управляет MCP-серверами через свои настройки. Открой настройки Cursor, найди раздел MCP / Model Context Protocol и выбери добавление нового MCP-сервера. Cursor позволяет вставить описание сервера в формате JSON — той же структуры mcpServers, которую использует каждый MCP-клиент.

Ничего не нужно устанавливать вручную. Клиент запускает сервер через npx по требованию, поэтому единственные требования — это Node.js 18+ и API-ключ FlipLink. Получи ключ, войдя на go.fliplink.me и открыв страницу Subscription.

Блок сервера FlipLink

В настройках MCP в Cursor добавь MCP-сервер с этой записью mcpServers. Замени <YOUR_KEY> на свой API-ключ FlipLink:

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

Несколько замечаний по этому блоку:

• command + args говорят клиенту запустить сервер через npx — глобальная установка не нужна.
• FLIPLINK_API_KEY аутентифицирует каждый вызов. Относись к нему как к паролю; держи его подальше от общих репозиториев.
• FLIPLINK_MCP_MODE определяет, сколько инструментов будет доступно. safe (значение по умолчанию) даёт чтение, а также обратимые записи и управление доступом — без удалений и коммерческих действий. Используй readonly для режима «смотри, но не трогай» или full — для всего сразу. Полный разбор смотри в статье режимы безопасности MCP.

После сохранения перезапусти Cursor (или перезагрузи MCP-сервер из настроек), чтобы он подхватил новую запись.

Проверка: попроси Cursor вызвать whoami

Самый быстрый способ убедиться, что соединение работает, — инструмент проверки состояния. В чате Cursor напиши:

Используй MCP FlipLink и вызови whoami.

Инструмент whoami — это проверка аккаунта на верхнем уровне. Если ключ действителен, в ответ ты получишь данные своего аккаунта и максимальный размер загрузки. Если ключ отсутствует или указан неверно, инструмент вернёт понятные инструкции по настройке вместо невнятной ошибки — это сигнал, что нужно исправить значение FLIPLINK_API_KEY и перезапустить клиент.

Как только whoami заработает, попробуй что-нибудь настоящее:

Создай флипбук из ./deck.pdf с названием "Q3 Report", а затем дай мне ссылку для шеринга.

ИИ Cursor вызовет flipbook_create_by_file и flipbook_get_share_link за тебя — никаких ручных вызовов API не потребуется.

🚀

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

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

Drop your PDF here or click to browse

Макс. 40 МБ

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

Другие клиенты используют ту же конфигурацию

Прелесть MCP в том, что конфигурация универсальна. Тот же блок mcpServers, что и выше, работает в Claude Desktop, Codex и любом другом MCP-клиенте — различается только меню, куда ты его вставляешь. В каждом клиенте ищи настройки MCP или Model Context Protocol и добавляй сервер с той же структурой JSON.

Если твой клиент предлагает вариант транспорта stdio, выбирай именно его: fliplink-mcp обменивается данными через stdio — ровно то, что настраивают command + args. В транспорте нет ничего специфичного для FlipLink — это стандартная конфигурация stdio, которую использует каждый MCP-сервер.

Специально для Claude Code можно вообще обойтись без JSON и выполнить одну команду:

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

Отдельное пошаговое руководство для этого клиента есть в статье как подключить FlipLink к Claude через MCP.

FAQ по устранению неполадок

В: Сервер FlipLink не появляется в Cursor. Что делать? О: Сначала убедись, что установлен Node.js 18+ (node --version), ведь npx без него не работает. Затем ещё раз проверь, что JSON корректен — пропущенная запятая или скобка молча уберёт сервер. Наконец, полностью перезапусти клиент, чтобы он заново прочитал конфигурацию.

В: Инструменты появляются, но каждый вызов завершается сообщением о настройке. О: Это значит, что API-ключ не доходит до сервера. Проверь, что FLIPLINK_API_KEY задан в блоке env и что его значение — это твой настоящий ключ со страницы Subscription. После правки сохрани и перезапусти.

В: Почему ИИ не может удалить флипбук или выполнить действие с продажей? О: Ты в режиме safe, который намеренно скрывает разрушительные и коммерческие инструменты. Переключи FLIPLINK_MCP_MODE на full, чтобы включить их — но учти, что удаление и денежные операции всё равно требуют шага подтверждения перед запуском. Смотри режимы безопасности MCP.

Подведём итог

Чтобы добавить FlipLink в Cursor, нужен один блок JSON и перезапуск. Как только всё подключено, ИИ твоего редактора берёт на себя создание, публикацию флипбуков и выгрузку лидов через обычный язык — и та же конфигурация без изменений подходит к любому другому MCP-клиенту, которым ты пользуешься.

Похожие материалы

• MCP-сервер FlipLink — полный список инструментов, режимы и детали безопасности
• Что такое MCP-сервер?
• Как подключить FlipLink к Claude через MCP
• Режимы безопасности MCP (readonly / safe / full)
• Документация FlipLink CLI
• Справочник по API