FlipLink MCP-сервер
Управляйте FlipLink прямо из ИИ-ассистента. Позвольте Claude, Cursor или любому MCP-клиенту создавать, настраивать, публиковать флипбуки и управлять ими на естественном языке — со встроенной защитой от любых необратимых действий.
Подключись одним копированием
Скопируй стартовый промпт в Claude Code — он добавит MCP-сервер FlipLink и проверит подключение.
Замени YOUR_API_KEY на свой настоящий API-ключ FlipLink.
Set up and verify the FlipLink MCP server for me.
1. Add the server to this Claude Code session by running this in the terminal:
claude mcp add fliplink -e FLIPLINK_API_KEY=YOUR_API_KEY -e FLIPLINK_MCP_MODE=safe -- npx -y fliplink-mcp
2. Confirm it was added: run `claude mcp list` and check that "fliplink" appears and shows as connected.
3. Verify the config: confirm the "fliplink" server has FLIPLINK_API_KEY set in its env (it must be my real
key, not the YOUR_API_KEY placeholder, and must not be empty). Reading config: `claude mcp get fliplink`.
4. Test the connection: call the FlipLink "whoami" tool. If it returns my account, the MCP is live.
5. If "fliplink" is missing or won't connect, troubleshoot:
- Ensure Node.js 18+ and npx are installed (`node -v`).
- Re-run the add command and confirm FLIPLINK_API_KEY is present and correct (not the placeholder).
- Remove and re-add: `claude mcp remove fliplink` then re-run step 1; restart the session.
- Re-run `claude mcp list` to confirm it now shows connected.
Once "whoami" succeeds, list the FlipLink tools now available to you.Работает с твоими ИИ-инструментами
Claude
Cursor
ChatGPT
Codex
VS Code
Windsurf
Устанавливается через npx fliplink-mcp · работает с вашим API-ключом · 87 инструментов
Как это работает
MCP-сервер FlipLink — это небольшая программа, которую ИИ-клиент запускает на вашем компьютере. Он предоставляет тот же REST API FlipLink в виде MCP-инструментов, чтобы ассистент мог вызывать их на естественном языке. Это третий вход к тому же API — собрат CLI. В самом API ничего не меняется: этот сервер — просто ещё один клиент, и все проверки безопасности выполняются локально, прежде чем запрос покинет ваш компьютер.
Установка
Вручную ничего устанавливать не нужно — ИИ-клиент сам запускает сервер через npx. Понадобится только ваш собственный API-ключ FlipLink (см. ниже).
Claude Code
claude mcp add fliplink -e FLIPLINK_API_KEY=<YOUR_KEY> -- npx -y fliplink-mcpClaude Desktop · Cursor · Codex
Добавьте это в конфигурацию MCP вашего клиента (блок mcpServers):
{
"mcpServers": {
"fliplink": {
"command": "npx",
"args": ["-y", "fliplink-mcp"],
"env": {
"FLIPLINK_API_KEY": "<YOUR_KEY_FROM_SUBSCRIPTION_PAGE>",
"FLIPLINK_MCP_MODE": "safe"
}
}
}
}Получите API-ключ
Каждый пользователь подставляет свой собственный ключ — мы никогда не вписываем его за вас. Войдите в аккаунт, скопируйте ключ со страницы подписки и вставьте его в конфигурацию выше как FLIPLINK_API_KEY.
Если ключа нет, каждый инструмент возвращает понятную инструкцию, как его добавить — так что ассистент проведёт вас через настройку ещё до того, как вы откроете документацию.
Стартовый промпт
Вставьте это в новую сессию ИИ, чтобы сразу настроить безопасный сценарий работы:
You now have the FlipLink MCP server connected (tools like whoami,
flipbook_create_by_file, leads_list). First, call whoami to confirm my account is reachable.
If it returns an auth error, ask me to paste my FlipLink API key (I get it from
https://go.fliplink.me/Subscription) and remind me to put it in the MCP server config as
FLIPLINK_API_KEY, then stop until I confirm.
Once connected you can create, list, and configure my flipbooks. For any delete, sale/pricing,
or access-control change, show me a one-line preview and wait for my explicit "yes" before doing it.
Here's what I want to do: <describe your task>Режимы
Инструменты разбиты по уровням риска, а режим решает, какие уровни доступны. Задайте FLIPLINK_MCP_MODE в конфигурации (по умолчанию — safe).
| Режим | Что доступно | Примечания |
|---|---|---|
| readonly | Только чтение (19 инструментов) | whoami, списки, запросы данных |
| safe (по умолчанию) | Чтение + обратимая запись + контроль доступа (79 инструментов) | Без инструментов удаления и продаж |
| full | Всё (87 инструментов) | Удаление и продажи требуют подтверждения |
Не знакомы с терминами? Узнайте, что такое API и автоматизация.
Модель безопасности
В режиме full необратимые (удаление) и денежные (продажа / цены) инструменты никогда не срабатывают с первого вызова. Сервер возвращает однострочный предпросмотр и недолговечный confirm_token; ассистент обязан показать вам предпросмотр и вызвать инструмент повторно с этим токеном. Токен привязан к конкретным аргументам и действует 5 минут. Эта проверка живёт в сервере — API FlipLink её не видит.
У каждого инструмента есть и MCP-аннотации (readOnlyHint, destructiveHint, idempotentHint), чтобы клиенты могли показывать собственные запросы на подтверждение.
Инструменты
Инструменты генерируются из спецификации API и называются по схеме <noun>_<verb> — например flipbook_publish, flipbook_set_skin, leads_list, cname_add. Единственный верхнеуровневый инструмент проверки — whoami. Полное описание параметров каждого эндпоинта смотрите в документации REST API.
Частые вопросы
- Что такое MCP-сервер?
MCP-сервер (Model Context Protocol) — это небольшая программа, которую ваш ИИ-клиент запускает локально и которая предоставляет ассистенту набор инструментов. Сервер FlipLink открывает тот же REST API FlipLink в виде инструментов, поэтому Claude, Cursor или любой MCP-клиент может создавать, настраивать и публиковать флипбуки на естественном языке.
- Какие ИИ-клиенты поддерживаются?
Любой клиент с поддержкой MCP — в том числе Claude Code, Claude Desktop, Cursor и Codex. Достаточно добавить FlipLink в конфигурацию
mcpServersклиента, и он запустит сервер по запросу командойnpx fliplink-mcp.- Что такое режимы readonly, safe и full?
Режим определяет, какие инструменты доступны.
readonlyоткрывает 19 инструментов только для чтения;safe(по умолчанию) добавляет обратимые операции записи и управление доступом — всего 79 инструментов;fullоткрывает все 87, причём инструменты удаления и коммерции защищены шагом подтверждения. Режим задаётся переменнойFLIPLINK_MCP_MODE.- Безопасно ли доверять управление флипбуками ИИ?
Да. В режиме full разрушительные действия (удаление) и денежные операции (продажа, цены) никогда не выполняются с первого вызова — сервер возвращает однострочный предпросмотр и недолговечный токен подтверждения, привязанный к конкретным аргументам, и ассистент должен подтвердить операцию, прежде чем что-либо произойдёт. Все ограничения работают локально; сам API FlipLink остаётся без изменений.
- Нужен ли мне собственный ключ API?
Да — каждый пользователь указывает свой ключ со страницы подписки FlipLink и задаёт его как
FLIPLINK_API_KEYв конфигурации. Если ключ отсутствует, каждый инструмент возвращает понятную инструкцию по настройке, чтобы ассистент мог провести вас по шагам.