Как подключить Яндекс Метрику к ChatGPT и Claude через MCP

Вы открываете чат с ChatGPT или Claude и спрашиваете обычным языком: «Какие страницы дали больше всего отказов на прошлой неделе?» или «Покажи динамику органики из Яндекса за месяц». AI сам лезет в вашу Метрику, достаёт цифры и отвечает таблицей с выводами. Без выгрузок, без копания в отчётах, без переключения вкладок.

Так работает связка Метрики с AI через MCP. Подключение занимает буквально пару минут, и дальше вы просто разговариваете с ассистентом про свой сайт. Ниже разберём всю настройку по шагам: от регистрации до первого вопроса в чате, с инструкциями для claude.ai, ChatGPT, Claude Desktop, Cursor, VS Code и Claude Code — и с решением проблем, если что-то не завелось.

Что нужно для подключения

Список короткий:

• Аккаунт Яндекса, у которого есть доступ к нужным счётчикам Метрики и (по желанию) сайтам в Вебмастере. Это обычно тот же аккаунт, под которым вы заходите в Метрику.
• Подписка Seely. Тариф Starter от 349 руб/мес даёт 1 счётчик и 1 сайт, тариф Unlimited 2990 руб/мес снимает лимиты.
• Любой MCP-клиент. Подойдут claude.ai, ChatGPT (на платном тарифе), Claude Desktop, Cursor или VS Code.

Три способа подключения: выберите свой

Дальше в статье будут пошаговые инструкции под каждый клиент, но сначала полезно понять, какой из трёх путей ваш. От этого зависит, понадобится ли вам вообще API-ключ.

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

Шаг 1. Регистрация и авторизация через Яндекс

Заходите на seely.ru и нажимаете вход. Авторизация идёт через Яндекс OAuth: вы подтверждаете доступ к своему аккаунту, и Seely получает токен, через который потом обращается к API Метрики и Вебмастера от вашего имени.

При первой регистрации заводится пробный период, дальше оформляется подписка. Выбор тарифа зависит от того, сколько сайтов вы хотите подключить:

• Starter (от 349 руб/мес): один счётчик Метрики и один сайт Вебмастера. Хватает, если у вас один проект.
• Unlimited (2990 руб/мес): без ограничений по числу счётчиков и сайтов. Берут агентства и владельцы нескольких проектов.

После авторизации вы попадаете в личный кабинет по адресу seely.ru/dashboard. Дальше работа идёт оттуда.

Шаг 2. Выбор счётчиков Метрики и сайтов Вебмастера

В кабинете есть раздел с настройками MCP. Тут вы отмечаете, к каким данным AI получит доступ:

• Счётчики Метрики. Из списка ваших счётчиков выбираете те, по которым ассистент будет отвечать. На Starter это один счётчик, на Unlimited сколько угодно.
• Сайты Вебмастера. Аналогично отмечаете хосты, по которым нужны данные индексации, запросов и позиций.

Это важный шаг по двум причинам. Во-первых, AI физически не сможет обратиться к счётчику, который вы не выбрали: на стороне сервера стоит проверка доступа. Во-вторых, без хотя бы одного выбранного счётчика или сайта инструменты просто не появятся в чате. Так что не пропускайте этот пункт.

Выбрали нужное, сохранили. Теперь получаем ключ.

Шаг 3. Получение API-ключа

Этот шаг нужен не всем. Если вы подключаетесь к claude.ai или ChatGPT через OAuth, ключ можно пропустить — переходите сразу к шагу 4.

Для остальных клиентов в кабинете есть ваш персональный API-ключ. Он выглядит так: yamcp_ и дальше длинная строка символов. Этот ключ заменяет логин и пароль: по нему сервер понимает, что запрос пришёл именно от вас, проверяет подписку и подставляет ваши счётчики.

Скопируйте ключ целиком. Один и тот же ключ работает и для Яндекс MCP, и для Google MCP (Search Console и GA4), если вы их подключите позже. В этой статье фокус на Яндексе, поэтому используем эндпоинт https://seely.ru/api/mcp.

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

Шаг 4. Настройка в claude.ai

Веб-версия Claude подключается через OAuth, поэтому ключ здесь не нужен.

1. Откройте Settings → Connectors → Add custom connector.
2. В поле адреса вставьте https://seely.ru/api/mcp и нажмите Connect.
3. Claude откроет страницу seely.ru. Войдите через Яндекс ID, если ещё не залогинены.
4. На экране «Запрос доступа» проверьте, какое приложение и к каким данным запрашивает доступ, и нажмите «Разрешить».

Всё. Клиент получит собственные токены доступа: они живут час и обновляются автоматически. Какие приложения подключены, видно в кабинете в блоке «Подключённые приложения» — там же кнопка «Отозвать».

Шаг 5. Настройка в ChatGPT

Для подключения MCP в ChatGPT нужен платный тариф (Pro, Plus, Business, Enterprise или Education) и включённый режим разработчика. Поддержка коннекторов идёт через Developer Mode, который пока в бете.

Включаем Developer Mode. Откройте Settings → Connectors → Advanced settings и включите Developer Mode (beta).

Создаём коннектор. Перейдите в Connectors → Create и заполните поля:

• Name: Seely Yandex
• Description: SEO-аналитика Яндекс.Метрики и Вебмастера
• URL: https://seely.ru/api/mcp
• Authentication: OAuth

При подключении ChatGPT перенаправит вас на seely.ru: войдите через Яндекс ID и нажмите «Разрешить». Ключ вводить не нужно.

Раньше в ChatGPT приходилось передавать ключ прямо в адресе через параметр ?token= и выбирать No authentication. Этот способ ещё работает, но мы не рекомендуем его: адрес с ключом попадает в скриншоты, историю браузера и логи, откуда его сложно убрать.

Подтверждаем. Отметьте галочку I trust this application и нажмите Create.

Включаем в чате. В окне диалога нажмите + → More → Developer Mode → Add sources и активируйте Seely. После этого ассистент сможет вызывать инструменты Метрики прямо по ходу разговора.

Небольшое замечание: на мобильных устройствах действия записи (например, отправка страницы на переобход через queue_webm_recrawl) могут быть отключены. Чтение данных работает везде, а вот команды, которые что-то меняют, надёжнее запускать с десктопа.

Шаг 6. Настройка в Claude Desktop

Самый быстрый путь — готовое расширение. Скачайте файл seely-yandex.mcpb и откройте его двойным кликом (или через Settings → Extensions → Install). При установке вставьте API-ключ в поле «API-ключ Seely» — он сохранится в системном хранилище ключей, а не в текстовом файле.

Если предпочитаете настроить вручную, сервер прописывается через конфигурационный файл. Найдите его по пути для вашей системы:

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

Откройте файл (если его нет, создайте) и добавьте блок mcpServers:

{
  "mcpServers": {
    "seely-yandex": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://seely.ru/api/mcp",
        "--header",
        "Authorization:Bearer ВАШ_API_КЛЮЧ"
      ]
    }
  }
}

Здесь ключ передаётся через заголовок Authorization в формате Bearer. Утилита mcp-remote ставится автоматически через npx, отдельно её устанавливать не нужно (понадобится только Node.js на компьютере).

Сохраните файл и полностью перезапустите Claude Desktop. После перезапуска инструменты Seely появятся в чате: их видно по иконке инструментов, и AI начнёт обращаться к Метрике, когда вы про неё спрашиваете.

Шаг 7. Настройка в Cursor и VS Code

В обоих редакторах есть кнопка установки: откройте кабинет, вставьте API-ключ и нажмите «Установить в Cursor» или «Установить в VS Code». Клиент откроет диалог подтверждения с готовым конфигом — останется согласиться.

Вручную для Cursor создайте файл .cursor/mcp.json в корне проекта. Cursor поддерживает удалённые HTTP-серверы напрямую, никаких дополнительных утилит не нужно:

{
  "mcpServers": {
    "seely-yandex": {
      "url": "https://seely.ru/api/mcp",
      "headers": {
        "Authorization": "Bearer ВАШ_API_КЛЮЧ"
      }
    }
  }
}

Для VS Code структура почти такая же, только секция называется servers и нужен параметр "type": "http". Открыть файл: Command Palette → MCP: Open User Configuration.

Одна особенность Cursor: он показывает максимум 40 инструментов на один сервер. У Seely Yandex их 69, поэтому в списке отобразятся не все, а основные. Это ограничение самого редактора, а не сервера. Если нужны ещё и данные Google, подключайте https://seely.ru/api/google/mcp отдельным сервером — лимит в 40 инструментов считается для каждого сервера свой.

Шаг 8. Настройка в Claude Code

Claude Code работает с удалёнными HTTP-серверами нативно. Одна команда в терминале, флаги идут до имени сервера:

claude mcp add --transport http --scope user seely-yandex https://seely.ru/api/mcp --header "Authorization: Bearer ВАШ_API_КЛЮЧ"

Флаг --scope user делает сервер доступным во всех проектах. Проверить результат: claude mcp list. Готовая команда с подставленным ключом есть в кабинете.

Проверка, что всё работает

Если подключались по API-ключу, можно убедиться, что сервер отвечает, ещё до похода в чат. Самый быстрый способ: запросить список инструментов через curl прямо из терминала.

curl -X POST "https://seely.ru/api/mcp" \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'

Если в ответ прилетел JSON со списком инструментов (get_organic_traffic_dynamics, get_high_bounce_pages_organic и десятки других), значит, ключ валиден, подписка активна и сервер на связи.

Теперь самое интересное: первый вопрос в чате. Откройте ChatGPT или Claude и напишите что-то конкретное про ваш сайт. Например:

Покажи показатель отказов по страницам за последние 7 дней. Выдели топ-5 страниц с самыми высокими отказами.

Или про динамику трафика:

Дай дневную динамику органического трафика из Яндекса за последние 28 дней. Падение есть или трафик стабильный?

AI вызовет нужный инструмент, заберёт данные из вашей Метрики и вернёт ответ с таблицей и интерпретацией. Если это произошло, поздравляем: связка работает, и дальше можно спрашивать что угодно обычными словами.

Решение типичных проблем

Если с первого раза что-то пошло не так, почти всегда дело в одном из этих пунктов.

Инструменты не отображаются в чате. Проверьте три вещи по порядку: ключ начинается с yamcp_, подписка активна (не истёк пробный период или оплата), и в кабинете выбран хотя бы один счётчик или сайт. Чаще всего забывают именно про последнее: без выбранного счётчика список инструментов остаётся пустым.

Ошибка аутентификации. Скорее всего, в ключ закрался лишний пробел при копировании (в начале или в конце строки). Скопируйте ключ заново и проверьте, что вокруг него нет пробелов. Второй вариант: подписка истекла, тогда нужно продлить её в кабинете.

ChatGPT не показывает коннектор. Убедитесь, что Developer Mode действительно включён в Settings → Connectors → Advanced settings. Затем обновите страницу и нажмите Refresh в разделе Connectors. Бывает, что коннектор появляется только после перезагрузки интерфейса.

Cursor показывает не все инструменты. Это не баг. Cursor ограничивает список 40 инструментами на сервер, а у Seely Yandex их 69. Основные инструменты по Метрике и Вебмастеру в списке есть, и этого достаточно для повседневной работы.

Клиент просит войти заново. При OAuth токены доступа живут час и обновляются автоматически. Если клиент всё же просит повторный вход, значит доступ был отозван — либо вами в кабинете, либо истёк срок сессии. Пройдите подключение заново.

Ошибка 401 после отзыва доступа. Так и должно быть: кнопка «Отозвать» в блоке «Подключённые приложения» лишает клиент доступа мгновенно. Чтобы вернуть его, подключите коннектор заново.

Если ни один пункт не подошёл, начните с проверки через curl из раздела выше: она сразу покажет, проблема на стороне ключа и подписки или на стороне клиента.

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

Все клиенты, которые подключились через OAuth, видны в кабинете в блоке «Подключённые приложения»: название приложения, дата подключения и кнопка «Отозвать». Отзыв срабатывает мгновенно — следующий же запрос клиента получит 401.

Для подключений по API-ключу отдельного списка нет: ключ один на все клиенты. Если нужно отключить всех сразу, перевыпустите ключ в кабинете. Это ещё один довод в пользу OAuth: там доступ отзывается точечно, по одному приложению.

Отдельно стоит помнить, что Seely работает только на чтение и видит лишь те счётчики и сайты, которые вы отметили в настройках. Единственное исключение — отправка страниц на переобход в Вебмастере, и она запускается только по вашей прямой просьбе.

Что дальше

• Если хочется понять, что вообще такое MCP и почему AI может ходить в ваши данные, прочитайте что такое MCP-сервер простыми словами.
• Когда подключение готово, попробуйте 10 вопросов, которые стоит задать AI про свой сайт: подборка промптов, с которых удобно начать.
• Если остались сомнения, стоит ли вообще давать AI доступ к аналитике, — разбор рисков и чек-лист в статье про безопасность такого подключения.
• А если смотрите шире, чем разовые проверки, загляните в материал про AI для SEO: как встроить ассистента в регулярную работу с сайтом.
• Короткий разбор возможностей и первых промптов — в статье про то, что умеет Seely.