Подключение MCP бот-конструктора: Claude, Cursor, VS Code

MCP-сервер zaytsv-mcp — это открытый коннектор (Node ≥ 18, без зависимостей), который позволяет вашему ИИ-агенту собирать воронки ботов прямо в сервисе Zaytsv /bots. Вы описываете сценарий словами, а агент через MCP создаёт, проверяет и публикует граф бота — без ручного клика по редактору.

В этой инструкции вы шаг за шагом подключите сервер к разным клиентам: Claude Code, Cursor, VS Code, Codex и Windsurf. Все команды и конфиги ниже — рабочие, копируйте их как есть. Начинается всё с одного — с токена.

Шаг 1. Получите токен (нужен для всех клиентов)

Токен — это ключ доступа к вашему аккаунту по API. Без него ни один клиент не подключится.

Залогиньтесь на https://zaytsv.ru.
Откройте страницу https://zaytsv.ru/bots/mcp-tokens.
Создайте токен и скопируйте секрет вида zmcp_.... Он показывается только один раз — сохраните его сразу.
При необходимости токен можно мгновенно отозвать там же.

Важно понимать: токен zmcp_... даёт полный доступ к вашему аккаунту через API. Храните его в переменных окружения или в конфиге клиента, не коммитьте в репозиторий и не пересылайте в открытых каналах.

На странице /bots/mcp-tokens есть готовые кнопки, которые экономят время:

«Установить в один клик» для Cursor и VS Code — это deep-link с уже зашитым токеном.
«Создать токен и скопировать команду» для Claude Code — копирует готовую команду установки.

Если вы используете эти кнопки, большую часть шагов ниже выполнять вручную не нужно. Ручные сниппеты пригодятся для нестандартных клиентов и для понимания, что именно происходит.

Шаг 2. Claude Code — плагин (рекомендуется)

Самый простой путь для Claude Code — установить плагин. Он сразу даёт MCP-сервер zaytsv-mcp и скилл build-bot-funnel, который умеет собирать воронку из текстового описания.

Добавьте маркетплейс и установите плагин:

/plugin marketplace add skiddgoddamn/zaytsv-mcp
/plugin install zaytsv-mcp@zaytsv

Проверьте, что всё подключилось:

/mcp и /plugin

После установки передайте агенту токен (см. раздел про передачу токена ниже) — и можно собирать ботов.

Шаг 3. Claude Code — одной командой

Если плагины вам не нужны, подключите сервер напрямую одной командой. Подставьте свой токен вместо <токен>:

claude mcp add zaytsv-mcp --scope user --env ZAYTSV_BASE_URL=https://zaytsv.ru --env ZAYTSV_MCP_TOKEN=<токен> -- npx -y zaytsv-mcp

Обратите внимание на порядок аргументов: флаги --env идут до разделителя --, а после -- указывается команда запуска сервера (npx -y zaytsv-mcp). Если перепутать порядок, переменные окружения не дойдут до сервера.

Шаг 4. Cursor (и любой generic MCP-клиент)

Для Cursor проще всего нажать кнопку «Установить в один клик» на странице /bots/mcp-tokens. Но если вы настраиваете подключение вручную, добавьте сервер в .mcp.json (или в настройки клиента) под ключом mcpServers:

{
  "mcpServers": {
    "zaytsv-mcp": {
      "command": "npx",
      "args": ["-y", "zaytsv-mcp"],
      "env": {
        "ZAYTSV_BASE_URL": "https://zaytsv.ru",
        "ZAYTSV_MCP_TOKEN": "zmcp_ваш_токен"
      }
    }
  }
}

Этот же формат подходит для большинства MCP-совместимых клиентов, включая Windsurf, — везде, где конфигурация ожидает ключ верхнего уровня mcpServers. Замените zmcp_ваш_токен на ваш реальный секрет.

Шаг 5. VS Code

В VS Code используется свой файл и свой ключ. Создайте файл .vscode/mcp.json и используйте ключ верхнего уровня servers (а не mcpServers, как в Cursor):

{
  "servers": {
    "zaytsv-mcp": {
      "command": "npx",
      "args": ["-y", "zaytsv-mcp"],
      "env": {
        "ZAYTSV_BASE_URL": "https://zaytsv.ru",
        "ZAYTSV_MCP_TOKEN": "zmcp_ваш_токен"
      }
    }
  }
}

После сохранения файла включите сервер в Copilot Agent mode → Tools. Если на странице /bots/mcp-tokens нажать «Установить в один клик» для VS Code, deep-link с токеном настроит это автоматически.

Шаг 6. Codex

Для Codex есть два пути.

Через конфиг. Откройте ~/.codex/config.toml и добавьте секцию [mcp_servers.zaytsv-mcp] вместе с подтаблицей переменных окружения [mcp_servers.zaytsv-mcp.env]:

[mcp_servers.zaytsv-mcp]
command = "npx"
args = ["-y", "zaytsv-mcp"]

[mcp_servers.zaytsv-mcp.env]
ZAYTSV_BASE_URL = "https://zaytsv.ru"
ZAYTSV_MCP_TOKEN = "zmcp_ваш_токен"

Через CLI. Либо добавьте сервер одной командой:

codex mcp add zaytsv-mcp --env ZAYTSV_BASE_URL=https://zaytsv.ru --env ZAYTSV_MCP_TOKEN=zmcp_... -- npx -y zaytsv-mcp

Шаг 7. Windsurf и другие клиенты

Windsurf и прочие MCP-совместимые редакторы работают по тому же принципу, что и Cursor. Используйте конфиг с ключом mcpServers из Шага 4, подставив адрес ZAYTSV_BASE_URL=https://zaytsv.ru и ваш токен. Если клиент поддерживает deep-link, кнопка установки в один клик на странице токенов тоже сработает.

Как передать токен агенту и не «спалить» его

У вас есть три способа дать агенту токен:

Просто прислать zmcp_... в чат. Агент сам вызовет инструмент set_token и сохранит секрет в файл ~/.zaytsv-bot-graph/token. Применяется сразу, без перезапуска клиента — это самый быстрый вариант.
Через env в конфиге клиента (как в примерах выше).
Через переменную окружения ZAYTSV_MCP_TOKEN в системе.

Если не уверены, с чего начать, напишите агенту команду «настрой подключение» — он вызовет инструмент setup и проведёт вас по шагам.

Безопасность сводится к нескольким правилам:

Токен = полный доступ к аккаунту по API. Относитесь к нему как к паролю.
Храните его в env или в системной переменной окружения, а не в коде проекта.
Никогда не коммитьте токен в git и не вставляйте в публичные конфиги.
Если токен мог утечь, отзовите его на /bots/mcp-tokens и создайте новый — это мгновенно.

FAQ

Нужно ли что-то устанавливать заранее?
Только Node.js версии 18 или новее. Сам сервер zaytsv-mcp подтягивается через npx -y при запуске и не имеет внешних зависимостей.

В чём разница между ключами mcpServers и servers?
Это особенности разных клиентов. Cursor, Windsurf и generic-клиенты ждут ключ mcpServers в .mcp.json. VS Code использует ключ servers в файле .vscode/mcp.json. Перепутаете ключ — сервер не подхватится.

Можно ли сменить токен без перезапуска клиента?
Да. Просто пришлите новый zmcp_... в чат — агент вызовет set_token и сохранит его в ~/.zaytsv-bot-graph/token, изменения применятся сразу.

Что делать, если токен скомпрометирован?
Зайдите на /bots/mcp-tokens, отзовите старый токен (это мгновенно) и создайте новый. Затем обновите его в конфиге или переменной окружения вашего клиента.

Готово — пора собирать ботов

После подключения MCP ваш агент умеет создавать, проверять и публиковать воронки ботов прямо в Zaytsv /bots. Достаточно описать сценарий словами — остальное сделает агент.

Создайте токен и подключите свой клиент за пару минут на странице https://zaytsv.ru/bots/mcp-tokens.