接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y @retensy/[email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
claude mcp add retensy-mcp -- npx -y @retensy/mcp@0.65.0在終端機中執行。
{ "mcpServers": { "retensy-mcp": { "command": "npx", "args": [ "-y", "@retensy/[email protected]" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
MCP-сервер (+ скилл для Claude Code) для сборки и публикации воронок/автоматизаций ботов (Telegram, MAX и Instagram) в сервисе retensy /bots: из текстового описания → валидный граф сценария → заливка и публикация через API.
Получи токен. Залогинься на https://bots.retensy.com → открой /bots/mcp-tokens → создай токен → скопируй секрет zmcp_... (показывается один раз).
Подключи у своего клиента (env-переменные везде одни и те же: RETENSY_BASE_URL, RETENSY_MCP_TOKEN):
Claude Desktop — добавь в claude_desktop_config.json:
{
"mcpServers": {
"retensy-mcp": {
"command": "npx",
"args": ["-y", "@retensy/mcp@latest"],
"env": {
"RETENSY_BASE_URL": "https://bots.retensy.com",
"RETENSY_MCP_TOKEN": "zmcp_ваш_токен"
}
}
}
}
Claude Code — одной командой:
claude mcp add retensy-mcp -e RETENSY_BASE_URL=https://bots.retensy.com -e RETENSY_MCP_TOKEN=zmcp_ваш_токен -- npx -y @retensy/mcp@latest
Или как плагин (подтянет и скиллы, см. «Вариант A» ниже):
/plugin marketplace add retensy/retensy-mcp
/plugin install retensy-mcp@retensy
Cursor — Settings → MCP → Add new MCP Server (или .cursor/mcp.json в проекте) — тот же JSON-объект, что и для Claude Desktop выше (mcpServers.retensy-mcp с command/args/env).
Собери первую воронку. Опиши сценарий словами агенту — он сам соберёт граф и опубликует (см. «Использование»), либо перенеси готовую воронку из другого сервиса — см. «Перенос воронки из другого конструктора» ниже.
Проверить подключение в любом клиенте: спроси агента «настрой подключение» — вызовет setup и подскажет, если что-то не так.
list_bots, list_graphs, list_channels, get_graph, create_graph, update_graph, edit_graph_live, patch_graph, dry_run, publish_graph, unpublish_graph, import_funnel, list_templates, create_graph_from_template, clone_graph, copy_graph, rename_graph, set_active_graph, delete_graph, upload_file, list_files, delete_file, graph_analytics, list_bot_users, list_links (+ setup/set_token).create_bot (Telegram/MAX по токену), bot_stop/bot_resume, connect_integration/disconnect_integration (amoCRM, Битрикс24, GetCourse, Я.Метрика, ЮKassa; Google Таблицы — ссылкой на вход Google; креды хранятся зашифрованными и не возвращаются), integration_catalog/integration_status/integration_test (каталог Integration Core и живая проверка подключения), integration_ingress_url (URL ингресса «Внешних событий» — Tilda, JivoSite, WooCommerce, amoCRM, Битрикс24, GetCourse, CloudPayments, Robokassa, Т-Банк, Prodamus — для TRIGGER_WEBHOOK), channel_post (пост в канал Telegram/MAX).broadcast_preview (размер аудитории), broadcast_send (сейчас или по расписанию, сразу по нескольким ботам; сообщения или запуск сценария; полный фильтр аудитории audienceFilter, дедуп dedup и распределённый запуск stagger по ботам), broadcast_list/broadcast_get/broadcast_cancel, повторяющиеся (broadcast_recurring), черновики (broadcast_drafts, broadcast_duplicate), мульти-бот группы (broadcast_group — preview/list/get/pause/resume/cancel) + скилл send-broadcast.audience_search/audience_fields — кросс-бот поиск и фильтр (теги, даты, статус, условия по переменным), audience_tag_edit/audience_variable_edit — массовое редактирование тегов/переменных, audience_export — потоковая выгрузка выборки в CSV/XLSX, dialog_search — поиск по «Диалогам» (включая текст сообщений).migration_presets/migration_preview/migration_commit — generic CSV column-mapper для BotHelp/SaleBot/Senler/Leadteh/Smartsender/ManyChat (переносятся только подписчики — ни один из них не публикует документированный формат экспорта воронки).booking_calendar_* (буферы до/после брони, горизонт записи, типы встреч своей длительности, форма клиента, публичная страница /book/<slug>), booking_confirm/booking_reject — ручное подтверждение брони (confirmationMode:"MANUAL").publications_usage — месячная квота (общая для Telegram/MAX/Instagram/VK), vk_status/vk_connect/vk_disconnect/vk_post — подключение VK-сообщества токеном и публикация на стену.zmcp_…): article_publish, article_update, article_list, article_get — публикация статей в Markdown (как README на GitHub) в раздел /articles.agent_list/agent_get/agent_create/agent_update/agent_publish/agent_health/agent_test_chat/agent_unanswered, kb_docs/kb_add_qa/kb_add_text/kb_add_site/kb_reindex — настройка ИИ-агента и его базы знаний (раздел «ИИ-агенты»).upload_file грузит фото/видео/документы в библиотеку /bots/files (до 50 МБ) и возвращает публичный URL — его вставляешь в медиа-карточку сценария.site_* + скилл build-site.build-bot-funnel: учит агента собирать корректный граф (типы узлов, ветки, кнопки, задержки) и проверять его перед публикацией. Поддерживает Telegram, MAX и Instagram.rebuild-funnel-from-builder: переносит воронку из другого конструктора (BotHelp, SaleBot, Senler, Leadteh, Smartsender, ManyChat, PuzzleBot и др.) по export JSON/тексту, скриншотам или пересказу — в граф Retensy, новым черновиком, без перезаписи текущего сценария. См. «Перенос воронки из другого конструктора».build-publication-chain: учит агента собирать «Цепочки публикаций» (автопостинг source → граф обработки → N назначений) — линейно или графом (общий/раздельный ИИ-адаптер на ветках), UTM по назначению, согласование, фан-аут в один заход («1 источник → общий ИИ → 10 TG-каналов + 2 VK + 4 MAX»)./plugin marketplace add retensy/retensy-mcp
/plugin install retensy-mcp@retensy
Подтянутся MCP-сервер и скиллы build-bot-funnel, rebuild-funnel-from-builder, build-site, send-broadcast, build-publication-chain. Проверить: /mcp и /plugin.
Через npx без установки. Пример конфига (.mcp.json / настройки клиента):
{
"mcpServers": {
"retensy-mcp": {
"command": "npx",
"args": ["-y", "@retensy/mcp@latest"],
"env": {
"RETENSY_BASE_URL": "https://bots.retensy.com",
"RETENSY_MCP_TOKEN": "zmcp_ваш_токен"
}
}
}
}
См. также examples/.mcp.json.
Токен действует от твоего имени в пределах выбранных прав (см. «Права токена» ниже).
/bots/mcp-tokens.zmcp_... (показывается один раз).set_token и сохранит токен в ~/.retensy-bot-graph/token (применяется сразу, без рестарта), илиenv в .mcp.json (Вариант B), илиsetx RETENSY_MCP_TOKEN "zmcp_...", bash export RETENSY_MCP_TOKEN="zmcp_...".Отозвать токен можно там же — доступ блокируется мгновенно.
С 14.10 тот же токен
zmcp_...полностью покрывает и вебхук-сценарии (/api/scenarios—scenario_*), и управление подключениями сервисов (/api/integrations—connect_integration/disconnect_integration/integration_updateи остальныеintegration_*), не только/api/bots. Отдельного токена под эти инструменты не нужно.
С 17.10.2026 у токена есть права. Их проверяет сервер на каждом запросе, а не MCP-клиент, поэтому прямой вызов API (curl и т.п.) их тоже не обходит; MCP-клиент только объясняет отказ. Но права крупные — выдавай токену только то, что нужно для задачи.
read; «Полный доступ» = все семь. По умолчанию в кабинете предлагается
read + write:bots + write:sites — собирать ботов и сайты. Это не «безопасный» набор: он видит ПДн
подписчиков и заявок и меняет живые ответы ботов и ключи интеграций. В нём нет только рассылок, оплаты,
удаления и выгрузки.write:bots: цепочку можно создать выключенной или с согласованием каждого
поста (approvalMode: ALL), сценарий по расписанию, с отправкой в заданный чат/канал (target.mode chat/expression)
или вебхук-сценарий с получателем из тела запроса (recipientFrom) — оставить черновиком. Включить/опубликовать — нужен broadcast.
То же для сценария с письмом на любой адрес, кроме ровно {{var.email}} подписчика (и если сценарий сам не
перезаписывает email), и для сценария с триггером события Telegram/комментария и шагами отправки — там
«ответ в текущий чат» уходит в канал или группу. Правка живого вебхук-сценария и новый секрет живого
вебхука, который шлёт людям, тоже требуют broadcast.403 {"error":"insufficient_scope","requiredScope":"…"}, а инструмент
возвращает ошибку «Токену не хватает права «X» …». Это не сбой: добавь право токену кнопкой
«Изменить права» на /bots/mcp-tokens (действует со следующего запроса, переподключать клиента не нужно)
или выпусти новый токен.token_expired) — выпусти новый. Ротация сохраняет права и длительность срока; API ротации
принимает и новые права (scopes/preset) — так старый токен переводят на явные права.Не знаешь, что делать? Скажи агенту «настрой подключение» — он вызовет
setup, объяснит шаги и попросит токен. Любой инструмент при отсутствии токена тоже вернёт пошаговую инструкцию.
Дев-окружение:
RETENSY_BASE_URL=http://localhost:8066. Fallback без токена:RETENSY_SESSION_COOKIE= значение кукиSESSIONиз браузера.
Опиши воронку словами — агент соберёт граф и (через MCP) опубликует:
«Собери бота:
/start→ приветствие с кнопкой подписки на канал → вопрос с 3 кнопками (бизнес / эксперт / просто смотрю) → для каждой свою цепочку из 2 сообщений с задержкой 1 день → финал с регистрацией на вебинар. Залей в бота и опубликуй.»
Под капотом скилл соберёт nodes/edges, прогонит локальную проверку и вызовет import_funnel → создаст граф, зальёт узлы, прогонит dry-run /start, опубликует. При ошибках публикации — разберёт по code/nodeId, починит, повторит.
Сообщение рассылки — как в мастере кабинета: {type, text?, mediaUrl?, mediaUrls?, buttons?}, до 5 сообщений.
<b> <i> <u> <s> <code> <pre> <blockquote> <tg-spoiler> <a href="https://…">, перенос строки — \n.[{text, url}] — callback-кнопок в рассылке нет. Медиа — сначала upload_file, потом его url.tagsAll (есть все), tagsNone (нет ни одного). До 50 000 на бота, до 20 ботов одного владельца за раз.scheduledAt — ISO 8601; без часового пояса считается московским. Пусто — отправить сейчас.{"name": "Распродажа", "botIds": ["<id>"], "tagsAll": ["клиент"], "scheduledAt": "2026-10-10T10:00",
"messages": ["<b>Только сегодня</b> — скидка 30%",
{"type": "PHOTO", "mediaUrl": "https://…/sale.jpg", "text": "Успей до полуночи",
"buttons": [{"text": "В магазин", "url": "https://shop.example"}]}]}
Через API не делается то, что требует входа пользователя у стороннего сервиса, оплаты или входа в аккаунт.
Такие инструменты не падают, а возвращают {needsBrowser: true, url, instruction} или ошибку со ссылкой:
Граф — контейнер retensy-bot-graph (nodes[] + edges[]). Полная схема узлов/хэндлов и правила валидатора — в скилле:
Локальная проверка графа перед заливкой:
# Telegram (по умолчанию)
node skills/build-bot-funnel/validate.mjs path/to/import.json
# Instagram-бот
node skills/build-bot-funnel/validate.mjs path/to/import.json --platform=INSTAGRAM
# MAX-бот
node skills/build-bot-funnel/validate.mjs path/to/import.json --platform=MAX
Есть готовая воронка в BotHelp, SaleBot, Senler, Leadteh, Smartsender, ManyChat, PuzzleBot или
любом другом сервисе — скилл rebuild-funnel-from-builder
учит агента перенести её в Retensy: разобрать export JSON/текст/скриншоты/пересказ → построить
инвентарь блоков → сопоставить с реальными типами узлов Retensy (таблица в
reference/mapping.md) → прямо спросить
про то, что не мапится, вместо того чтобы выдумывать замену → собрать граф → проверить
validate.mjs/dry_run → залить новым черновиком (никогда не поверх текущего сценария) →
опубликовать только после явного подтверждения. Перенос самих подписчиков (не графа) — отдельно,
через migration_presets/migration_preview/migration_commit (CSV).
git clone https://github.com/retensy/retensy-mcp
cd retensy-mcp
RETENSY_MCP_TOKEN=zmcp_... node src/index.mjs # стартует stdio MCP-сервер
Зависимостей нет — это голый JSON-RPC по stdio (протокол MCP 2024-11-05).
При старте сервер сверяет свою версию с npm (результат кэшируется на 6 часов в
~/.retensy-bot-graph/update-check.json). Если вышла новая — уведомление появится в setup и
в первом ответе инструмента.
@retensy/mcp@latest — тогда свежая
версия подтягивается при запуске. Если пакет установлен глобально, сервер сам запустит
npm i -g @retensy/mcp@latest в фоне (отключается RETENSY_MCP_AUTOUPDATE=0).git pull — npm тут не при чём,
исполняется файл репозитория.Важно: запущенный процесс не может подменить собственный код — обновление вступает в силу после перезапуска MCP-сервера. Нет сети или npm недоступен — проверка молча пропускается, работа не ломается.
Чтобы мы узнавали, каких возможностей не хватает, при неудаче инструмента отправляется анонимный
отчёт: неизвестный инструмент, отказ публикации (errors[]), ошибка API.
Отчёт уходит на POST {RETENSY_BASE_URL}/api/mcp/report — то есть на тот же сервер, с которым
вы и так работаете. Адреса чата/вебхука, куда мы складываем отчёты, в пакете нет: он живёт в
переменной окружения на сервере. Так его нельзя вытащить из пакета и залить, а мы можем сменить
приёмник без выпуска новой версии.
Что уходит: имя инструмента, категория неудачи, текст ошибки, ключи аргументов, версия, платформа
и анонимный id установки (хэш от имени хоста и домашнего каталога — не сами значения).
Что НЕ уходит никогда: токены, cookie, пароли, креды интеграций, содержимое графов и текстов
рассылок. Значения аргументов по умолчанию скрыты — присылаются только безопасные поля вроде
graphId/botId/kind.
Если персональный токен настроен, он прикладывается к отчёту — тогда мы видим, у кого именно
не хватило возможности, и можем ответить. Токен прикладывается только когда приёмник совпадает
с RETENSY_BASE_URL: на сторонний RETENSY_MCP_REPORT_URL он не отправляется.
Отчёты дедуплицируются и ограничены 20 на запуск, отправка не блокирует ответ инструмента (таймаут 4 с) и при сбое сети молча игнорируется. На сервере — свои лимиты (30 в час с адреса, 500 в час всего), так что отчёты нельзя использовать для заливки.
Отдельно: если токен ещё не настроен вовсе, отчёт не отправляется — это обычное состояние нового пользователя, а не пробел в возможностях.
Партнёр настраивает MCP один раз, своим собственным токеном — дальше тот же токен работает со всеми проектами, доступ к которым ему дали клиенты.
zmcp_... всегда идентифицирует тебя. Он не привязан к конкретному боту или сайту — какие проекты видны и что с ними можно делать, решает не токен, а твоя роль в каждом отдельном проекте.list_bots и site_list показывают всё сразу: твои собственные проекты и те, куда тебя пригласили — у чужих в ответе есть ownerName (имя владельца) и accessRole (твоя роль в этом конкретном проекте: OWNER / ADMIN / EDITOR / VIEWER). Так ты сразу видишь, где ты владелец, а где гость с ограниченной ролью.botId/siteId явно в каждом вызове инструмента — ассистент не хранит «текущий проект». Переключение между проектами клиентов — это просто другой botId в следующем вызове, оно не меняет твой аккаунт и не путает данные между проектами.Токен = доступ к аккаунту по API в пределах его прав. Выдавай агенту минимально нужные права (для знакомства — «Только чтение»). Не коммить токен; держи в env. В конфигах храни ссылку ${RETENSY_MCP_TOKEN}, не само значение.
MIT — см. LICENSE.
MCP server to build and publish Telegram and MAX bot funnels/automations, broadcasts, service integrations, block-based websites (incl. free-layout Zero blocks, designs, templates, custom domains, for
{ "mcpServers": { "retensy-mcp": { "command": "npx", "args": [ "-y", "@retensy/[email protected]" ] } }}總覽
MCP server to build and publish Telegram and MAX bot funnels/automations, broadcasts, service integrations, block-based websites (incl. free-layout Zero blocks, designs, templates, custom domains, form leads) and Markdown blog articles in the Retensy Bots
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
@retensy/mcp 透過 stdio 在本機執行。
上次檢查時間:2026-11-17。 MCP server to build and publish Telegram and MAX bot funnels/automations, broadcasts, service integrations, block-based websites (incl. free-layout Zero blocks, designs, templates, custom domains, form leads) and Markdown blog articles in the Retensy Bots