MCP · маркетинг-стек

Как настроить MCP-серверы для маркетинга:
Wordstat, Telegram и Claude

Пошаговый стек: протокол → клиент Claude → Wordstat и Telegram MCP → права, HITL и проверка tool-call

1 Протокол MCP

2 Wordstat MCP

3 Telegram MCP

4 HITL и verify

Wordstat Telegram Claude HITL

Чат с Claude удобен для черновиков. Но он не видит ваш Wordstat, не читает Telegram-канал и не знает состояние рекламных кампаний. Вы копируете цифры вручную, вставляете в диалог, получаете совет «на глаз» — и снова копируете обратно.

MCP-сервер закрывает этот разрыв: нейросеть получает безопасный «разъём» к сервисам и вызывает инструменты сама. Ниже — стек за один вечер: клиент Claude → Wordstat + Telegram MCP → права, HITL и проверка tool-call.

Claude-клиент Wordstat MCP Telegram MCP HITL

mcp-stack · evening

$ claude mcp list

# wordstat · telegram · filesystem

→ tool: wordstat.getTop ✓

→ telegram: read-only ✓

→ write: HITL pending

Зачем маркетологу MCP, если уже есть чат с нейросетью

Коротко. MCP не делает модель умнее. Он делает её полезнее: вместо общих советов агент тянет живые данные и действует по правилам, которые вы задали.

Чем протокол отличается от «просто спросить у Claude»

Когда вы просто спрашиваете в чате, модель отвечает из обучения и из текста, который вы ей вставили. Когда подключён MCP, модель может вызвать tool — готовое действие на стороне сервера: «сними частотность», «покажи последние посты», «положи черновик в файл».

Маркер: простыми словами. MCP (Model Context Protocol) — открытый стандарт, по которому ИИ-приложение подключается к внешним системам. Удобная аналогия из официальной документации: «USB-C для AI». Один сервер можно подключить к разным клиентам.

Где заканчивается текст в чате и начинается работа с данными

Граница простая. Пока агент только пересказывает ваши скрины — это чат. Когда в интерфейсе виден вызов инструмента и в ответе появляются цифры или сообщения из API — это работа с данными. Именно эту границу мы проверим в конце гайда чек-листом.

Для маркетолога и контентщика практический смысл такой: семантика из Wordstat, черновики и публикации в Telegram, позже — срезы по Директу — без бесконечного копипаста между вкладками браузера и окном нейросети.

MCP простыми словами: клиент, сервер и tool

В протоколе три роли. Их путают чаще всего — разберём на пальцах.

Маркер: простыми словами. Host — программа, в которой вы сидите (Claude Desktop, Claude Code, Cursor). Client — «переводчик» внутри хоста, который говорит с серверами по протоколу MCP. Server — отдельная программа с набором tools (действий), resources (данных) и иногда готовых prompts.

Anthropic опубликовал протокол в ноябре 2024. К 2026 его поддерживают Claude, Cursor, VS Code и другие клиенты. Вам не нужно «писать протокол» — нужно правильно выбрать клиент и подключить готовые серверы под задачи маркетинга.

Схема «клиент → MCP → инструмент» на одном примере

Вы в Claude пишете: «Сними топ запросов по „автоматизация контента“».
Клиент видит Wordstat MCP с tool вроде getTop.
Сервер ходит в Yandex Cloud Search API и возвращает таблицу частотностей.
Claude собирает ответ уже по живым цифрам, а не «примерно так бывает».

Локально сервер чаще общается через stdio — запускается на вашем компьютере. Удалённые сервисы используют Streamable HTTP.

Маркер: простыми словами. Tool (инструмент) — одно конкретное действие, которое сервер умеет выполнить по запросу модели: снять частотность, прочитать чат, отправить пост. Tool call — факт, что модель реально вызвала этот инструмент, а не «придумала», что вызвала.

Read-only и write: какие действия нельзя отдавать агенту сразу

Тип	Примеры	Правило для новичка
Read-only	Wordstat, чтение постов, список чатов	Подключайте первым вечером
Write	Публикация в Telegram, смена ставок, пауза кампаний	Только с подтверждением человека

Маркер: простыми словами. HITL (human-in-the-loop) — человек в цикле: агент готовит действие, но отправка или запись происходит только после вашего «да».

Без HITL на запись вы рискуете утренним постом «от лица бренда» или тихой правкой ставок, которую заметите слишком поздно. Чтение данных — безопасный старт. Запись — привилегия, а не дефолт.

Визуализация · не hero

Мост MCP: клиент → tools → HITL

Схема цикла маркетингового стека: Claude вызывает инструменты через протокол, Wordstat отдаёт живые частоты (read-only), а запись в Telegram ждёт подтверждения человека.

Клиент — Claude Desktop / Code как host с MCP-клиентом.
Wordstat MCP — безопасный старт: снять частотность без копипаста.
Telegram MCP — черновик готов, отправка только после HITL.
Проверка — в логе виден реальный tool-call, а не «отчёт из головы».

Дальше разберём, какой клиент взять и как собрать первый рабочий mcp.json на три сервера.

Редакционная метафора стека: не скриншот Claude, а поток tool-call с шлюзом HITL на запись.

Какой клиент выбрать: Claude Desktop, Claude Code или Cursor как оболочка

Для маркетингового минимума достаточно одного клиента. Не ставьте сразу три «на всякий случай»: каждый съедает время на настройку и место в контексте модели.

Claude DesktopБыстрый старт через меню Settings → Developer → Edit Config

Claude CodeЦикл «агент + файлы + tools», команды claude mcp add

Cursor как клиентЗапасной MCP-хост, без ухода в Cursor Agents

Claude Desktop — быстрый старт без терминальной боли

Берите Desktop, если хотите открыть конфиг через меню и увидеть список серверов в интерфейсе.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Шаги: Settings → Developer → Edit Config → секция mcpServers → сохранить → полностью закрыть и снова открыть Claude. Признак успеха: в UI видна иконка tools или список MCP-серверов.

Claude Code — когда нужен цикл «агент + файлы + tools»

Берите Claude Code, если работаете с папкой проекта, черновиками на диске и хотите команды вроде claude mcp add и проверку /mcp в сессии.

пользовательский: ~/.claude.json
проектный: .mcp.json в корне проекта

Есть scopes user / project / local. С Desktop на macOS или WSL серверы можно импортировать командой claude mcp add-from-claude-desktop. Важно: конфиги Desktop и Claude Code сами не синхронизируются.

Cursor только как MCP-клиент: без ухода в Cursor Agents

Cursor умеет MCP через ~/.cursor/mcp.json, проектный .cursor/mcp.json или UI Settings → Tools & MCP. В этой статье Cursor — запасной клиент, не тема про Cursor Agents и агентные воркфлоу IDE.

Практический лимит: суммарно около 40 tools на все MCP. Если подключить «толстый» Telegram MCP на сотню инструментов, часть tools станет невидимой агенту. Режьте набор: read-only, meta-режим, меньше серверов сразу.

Доступ из России. Claude Desktop, Claude Code и Cursor — зарубежные сервисы: аккаунт, подписка и оплата могут потребовать рабочий способ оплаты и доступа. Если Claude недоступен, тот же MCP-стек можно поднять в Cursor как MCP-клиенте. Wordstat и Telegram при этом остаются российскими «ногами» стека.

Первый рабочий mcp.json: подключение без магии

Ниже — пошаговый how-to на один вечер. Цель: клиент Claude + Wordstat + Telegram (сначала read-only). Filesystem — по желанию, чтобы складывать черновики в папку.

Минимальный конфиг на три сервера

Выберите клиент

Desktop или Claude Code — откройте файл конфига.

Добавьте mcpServers

Точные command и args сверяйте с README выбранного репозитория.

Сохраните и перезапустите

Для Desktop нужен полный quit, не просто закрытие окна.

Проверьте список серверов

Claude Code: claude mcp list и /mcp; Desktop — иконка tools; Cursor — зелёный статус.

Тестовый tool call

«Вызови Wordstat getTop по запросу „mcp сервер“ и покажи сырые цифры».

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/путь/к/папке-контента"]
    },
    "wordstat": {
      "command": "uvx",
      "args": ["yandex-wordstat-mcp"],
      "env": {
        "YANDEX_API_KEY": "ваш-ключ",
        "YANDEX_FOLDER_ID": "ваш-folder-id"
      }
    },
    "telegram": {
      "command": "uv",
      "args": ["run", "telegram-mcp"],
      "env": {
        "TELEGRAM_API_ID": "...",
        "TELEGRAM_API_HASH": "...",
        "TELEGRAM_EXPOSED_TOOLS": "read-only"
      }
    }
  }
}

Для Wordstat берите open-source под Yandex Cloud Search API (например, обёртки с tools getTop / getDynamics / регионы). Для Telegram — репозитории с явным read-only режимом. Не копируйте чужой JSON слепо: одна опечатка в command — и сервер «зелёный» не станет.

Признак успеха. В UI или логах виден tool call. Цифры совпадают с кабинетом Wordstat / Yandex Cloud. Telegram отвечает на read-команду, но сам ничего не публикует.

Типичные ошибки новичка

Сохранили конфиг, но не перезапустили клиент — серверы невидимы. Решение: полный перезапуск.
Поставили не тот пакет Telegram с PyPI — имя занято другим проектом. Решение: ставить только по инструкции нужного GitHub README.
Вставили ключи прямо в чат «чтобы модель помогла настроить» — секрет утёк в историю. Решение: только env в конфиге или .env вне git.

Где хранить секреты, чтобы не утекли в промпт

API-ключи и Telegram session — в переменных окружения конфига или в .env, который в .gitignore.
Не коммитьте .mcp.json с секретами в публичный репозиторий.
Session string Telegram = полный доступ к аккаунту. Относитесь к нему как к паролю от почты.

Маркер: простыми словами. Session string — сохранённая «сессия входа» в Telegram-аккаунт. У кого есть строка, тот может действовать от вашего имени. Поэтому её нельзя слать в чат, в тикет поддержки и в git.

Официальный filesystem-сервер @modelcontextprotocol/server-filesystem часто ставят первым «для проверки», что MCP вообще работает. Для маркетолога это удобный ящик черновиков постов до HITL-публикации.

Wordstat MCP: семантика и частотность без ручного копипаста

Раньше маркетолог открывал Wordstat в браузере, копировал таблицы, вставлял в чат. С Wordstat MCP агент сам снимает топ, динамику и регионы через API — в том же диалоге, где вы планируете статью или рекламный текст.

Какие запросы агент должен уметь снимать сам

топ связанных запросов;
динамика спроса;
распределение по регионам;
сравнение двух-трёх семян под семантическое ядро.

Промпт для проверки: «Сними частотность по „автоматизация маркетинга“ и „нейросеть для рекламы“, сравни и предложи структуру H2 без воды».

Как понять, что ответ пришёл из API, а не из «памяти модели»

В интерфейсе есть запись о вызове tool Wordstat.
Цифры можно перепроверить тем же запросом в кабинете.
Если tool не вызван, а модель «на глаз» пишет частоты — это галлюцинация отчёта. Переспросите: «Сначала вызови tool, потом отвечай».

Важно для РФ. Актуальный доступ к Wordstat v2 идёт через Yandex Cloud Search API: нужны Api-Key и Folder ID. Старый OAuth Wordstat v1 в новых MCP-пакетах часто уже убран.

Маркер: простыми словами. Folder ID — идентификатор каталога в Yandex Cloud, к которому привязан Search API. Api-Key — ключ доступа к этому API. Оба нужны серверу, чтобы ходить в Wordstat от вашего имени.

Если не хотите держать Python или Node локально, есть hosted-коннекторы Wordstat MCP с OAuth. Для новичка локальный uvx или npm обычно проще контролировать: ключи остаются у вас, список tools виден сразу.

Каталоги вроде PulseMCP помогают найти сервер, но карточки — community-проекты разного качества. Перед установкой смотрите GitHub: свежие коммиты, понятный README с env и явный режим прав.

Telegram MCP: черновики, каналы и безопасная публикация

Telegram — канал дистрибуции. MCP даёт агенту читать переписки и каналы и, если разрешите, публиковать. Ошибка здесь стоит дороже, чем в Wordstat: пост уходит аудитории.

Права бота: читать можно, писать — только с подтверждением

Стартуйте с read-only. В популярных Telegram MCP это делается переменной вроде TELEGRAM_EXPOSED_TOOLS=read-only. Пока агент только читает, он может:

собрать последние посты своего или конкурентного канала;
вытащить черновики из избранного;
помочь с планом контента на фактах, а не на догадках.

Write (отправка сообщения, постинг) включайте отдельно и только когда реально нужен.

HITL: человек утверждает пост до отправки

Агент готовит текст — можно с опорой на цифры Wordstat.
Вы правите тон, факты и офер.
Только после «ок» разрешаете tool на публикацию.

Так вы сохраняете скорость автоматизации контента и не отдаёте канал на автопилот. Тот же принцип HITL потом перенесёте на Директ и любые write-tools.

Практический совет из кейсов сообщества: не подключайте Telegram MCP со всеми сотнями tools сразу. Сначала read-only или урезанный набор. Иначе агент путает вызовы, а в Cursor ещё и упирается в лимит tools.

Опционально: Яндекс Директ через MCP, когда стек уже дышит

Не начинайте вечер с Директа. Сначала стабилизируйте Wordstat и Telegram. Директ — следующий уровень, когда агент уже доказал, что вызывает tools и не врёт отчёты.

Когда Директ-MCP окупает настройку

Имеет смысл, если вы:

каждое утро вручную снимаете срезы кампаний;
хотите один доступ к данным для Claude, Telegram-бота и веб-дашборда;
готовы держать токен Яндекса на стороне сервиса, а ассистенту отдавать только результаты tools.

Рабочий паттерн рынка: одно ядро API → три потребителя (дашборд, Telegram, MCP). Claude через MCP — для глубокого разбора; Telegram — для утреннего среза; веб — для «светофора» KPI.

Какие кампании нельзя отдавать агенту без ручного контроля

массовое изменение ставок;
остановка и запуск крупных кампаний;
правки объявлений на весь аккаунт.

Отдельный подводный камень рекламных API: ответ может прийти с HTTP 200, а ошибка лежать внутри тела. Правило: на запись нельзя верить «зелёному» статусу — читайте результат операции и сверяйте в кабинете Директа.

Нейросеть для рекламы здесь — не «сгенерируй креатив и забудь», а связка: данные из кабинета → разбор агентом → ваше решение → точечная правка с проверкой.

Типичные сбои: сервер «зелёный», а агент врёт отчёт

Зелёный индикатор MCP значит «процесс поднялся». Это ещё не значит, что агент вызвал нужный tool и операция прошла.

Слишком много tools в контексте — агент путает вызовы

Подключили filesystem, браузер, полный Telegram, Директ и ещё пять «на будущее» — модель начинает выбирать не тот инструмент или отвечать словами без вызова. Лечение: два-три сервера на старте; у Telegram — read-only или meta-режим с малым числом tools; в Cursor помните про потолок около 40 tools.

Лишние серверы ещё и раздувают контекст: клиент тратит токены на описания tools ещё до вашего первого вопроса. Для вечернего стека маркетолога жадность вредна.

HTTP 200 у API ≠ успешное действие

Особенно коварно в Директе и похожих API записи. Чек после write-действия:

Был tool call?
В теле ответа нет Errors?
В кабинете видно изменение?

Если чего-то из трёх нет — действие не считать выполненным. Красивый текст «кампания на паузе» без этих трёх пунктов — отчёт-галлюцинация.

Секреты в env vs секреты в чате

Можно	Нельзя
Ключи в `env` конфига MCP	Ключи в промпте «настройте за меня»
`.env` + `.gitignore`	Коммит session string
Отдельный тестовый бот/аккаунт	Полный доступ к личному Telegram «поиграть»

Ещё один риск community-серверов — токсичные описания tools. Не ставьте MCP «с улицы» без просмотра списка действий и активности репозитория.

Чек-лист запуска: агент реально трогает данные

Три проверки: Wordstat ответил, Telegram принял команду, лог tool-call виден

Клиент показывает подключённые MCP-серверы.
Запрос к Wordstat даёт tool call и цифры, совпадающие с кабинетом.
Telegram в read-only отвечает на безопасную команду.
В истории или логах виден вызов инструмента, а не только красивый текст.
Секреты не лежат в git и не светились в чате.
Write-действия выключены или требуют вашего подтверждения.

Что считать «готово к ежедневной работе»

Стек готов, когда вы без стресса делаете утренний ритуал:

«Сними спрос по теме недели» — Wordstat MCP.
«Собери черновик поста и положи в папку» — filesystem или чат.
«Покажи последние посты канала» — Telegram read-only.
Публикация — только после вашего OK.

Если агент стабильно пропускает tool и фантазирует — уменьшите число серверов и ужесточите формулировку: «Сначала вызови tool X, без вызова не отвечай».

Это и есть рабочий AI-агент для маркетинга в бытовом смысле слова: не «умный чат», а связка клиент + MCP + проверенные tools.

Частые вопросы про MCP-стек маркетолога

Что такое MCP-сервер простыми словами?

Это программа-посредник: с одной стороны понимает MCP, с другой умеет ходить в Wordstat, Telegram, файлы или рекламный кабинет. Клиент Claude не хранит пароли сервисов «в голове модели» — он вызывает сервер с tools.

Как подключить MCP к Claude за один вечер?

Откройте конфиг Desktop или добавьте сервер через Claude Code (claude mcp add / .mcp.json), пропишите один-два сервера с env-ключами, перезапустите, проверьте список и сделайте тестовый tool call. Не цельтесь в «все каталоги сразу».

Нужен ли свой сервер или хватит готовых?

Для старта хватит готовых open-source: Wordstat MCP + Telegram MCP + клиент Claude. Свой сервер нужен, если готового нет или API кастомный. Писать сервер с нуля имеет смысл позже, когда упрётесь в потолок готовых обёрток.

Чем Wordstat MCP полезнее обычного Wordstat в браузере?

Агент сам снимает частотности в том же диалоге, без копипаста таблиц, и сразу использует цифры для семантики, H2 и рекламных текстов. Вы проверяете tool call, а не переносите Excel руками.

Безопасно ли давать агенту доступ к Telegram?

Да — если стартуете с read-only, не коммитите session и ключи, а публикацию оставляете за HITL: человек утверждает пост до отправки. Полный write без подтверждения для новичка — плохая идея.

От разрозненных нейросетей к контент-заводу на агентах

Типичная боль: ChatGPT в одной вкладке, Wordstat во второй, Telegram в третьей, Директ в четвёртой. Каждый ответ «умный», а процесс всё равно ручной. MCP-стек — первый шаг, когда нейросети перестают быть разрозненными чатами и становятся конвейером: спрос → черновик → канал → (позже) реклама.

Когда минимум Wordstat + Telegram уже стабилен, следующий уровень — единые правила прав, HITL на любую запись и общий пайплайн контента: исследование, текст, утверждение, публикация, отчёт. Это и есть логика контент-завода и автоматизации маркетинга на агентах: меньше копипаста, больше проверяемых действий.

Собрать такой конвейер системно — от MCP и Claude до автопубликаций — можно в сообществе Maya Pro и на курсах по автоматизации. Перед масштабированием закройте чек-лист этого гайда: агент реально вызывает tools, секреты не утекли, write только с вашим «да».

Что проверяли по источникам

Определение и архитектура MCP — официальная документация протокола и русские how-to по подключению к Claude.
Шаги клиентов Desktop / Claude Code / Cursor — документация Claude Code и актуальные гайды по MCP.
Wordstat через Yandex Cloud Search API, Telegram MCP с read-only, риск HTTP 200 при записи в рекламных API — открытые кейсы и README серверов.
Лимит ~40 tools в Cursor и опасность перегруза Telegram tools — практика клиентов и community-кейсы.