ohmy-seo
К содержанию
ИНСТРУКЦИЯ · AI-КЛИЕНТЫ

Подключите ohmy-seo
к своему AI-клиенту

Выберите приложение и скопируйте его настройки. Один ключ ohmy-seo открывает доступ к вашим подключённым аккаунтам; права и доступные инструменты зависят от сервиса.

Сначала — аккаунты и API-ключ

  1. Войдите в кабинет

    Используйте Яндекс для входа, затем отдельно добавьте рабочие аккаунты Яндекса и Google.

  2. Создайте ключ ohmy-seo

    Выпустите персональный API-ключ в кабинете. Ключи Яндекса и Google в конфигурацию MCP не подставляются.

  3. Выберите приложение ниже

    Добавьте сервер и ключ в настройки клиента, затем откройте новую сессию.

Все шаблоны содержат заглушку YOUR_API_KEY. Замените её своим ключом только в личной конфигурации — не в сообщении AI и не в публичном репозитории. Если файл уже содержит настройки, добавьте запись ohmy-seo, сохранив остальные.

Настройка приложения

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

VS Code / Copilot

Прямое HTTP-подключение

Для чата агента в VS Code. Редактор запросит ключ отдельно — его не нужно вписывать в JSON.

  1. В палитре команд выполните MCP: Open User Configuration или откройте .vscode/mcp.json проекта.
  2. Добавьте servers и inputs из шаблона, сохранив существующие записи.
  3. Запустите ohmy-seo из редактора MCP-конфигурации, подтвердите доверие серверу и введите ключ в запросе VS Code.
mcp.json в VS Code
{
  "inputs": [
    {
      "type": "promptString",
      "id": "ohmy-seo-key",
      "description": "API-ключ ohmy-seo",
      "password": true
    }
  ],
  "servers": {
    "ohmy-seo": {
      "type": "http",
      "url": "https://mcp.ohmy-seo.ru/mcp",
      "headers": {
        "Authorization": "Bearer ${input:ohmy-seo-key}"
      }
    }
  }
}

Этот вариант с интерактивным вводом относится к агенту расширения VS Code. Для сессий Agent Host конфигурации с inputs не пересылаются; используйте поддерживаемую этим режимом отдельную настройку.

Проверка подключения

Выполните MCP: List Servers, проверьте ohmy-seo и включите его инструменты в чате агента.

Подключение MCP в VS Code ↗Схема mcp.json ↗

Форматы сверены с документацией разработчиков 14 сентября 2026. Доступность MCP может зависеть от версии клиента и правил вашей организации.

Первый запрос: проверить доступы

Покажи доступные через ohmy-seo аккаунты и источники данных. Ничего не изменяй. Если нужный источник не подключён, объясни, какое подключение требуется.

Выберите из ответа аккаунт, сайт или счётчик, укажите период и задачу. Готовые запросы есть в библиотеке вопросов.

Для изменения настроек сначала попросите показать план, объект и новые значения. Облачный сервер требует подтверждения в вызове инструмента записи; проверяйте запрос на действие в своём AI-клиенте.

Общие параметры подключения
Адрес
https://mcp.ohmy-seo.ru/mcp
Транспорт
Streamable HTTP
Заголовок авторизации
Authorization: Bearer YOUR_API_KEY

Локальная установка: Google Ads, Roistat и другие пакеты

Выберите нужный пакет в репозитории, установите зависимости и соберите проект. Требуются Node.js 22 или новее и pnpm. Облачный адрес предоставляет сервисы Яндекса, Search Console, GA4 и GTM в рамках ваших прав; Google Ads и Roistat устанавливаются отдельно.

git clone https://github.com/VKirill/ohmy-seo.git
cd ohmy-seo
pnpm install
pnpm -r build

Настройте переменные из .env.example выбранного пакета согласно его README. Для Google Ads нужны OAuth и доступ к рекламному API; Roistat использует собственный API-ключ. Подключение Google в облачном кабинете не настраивает локальный Google Ads.

Пример stdio-конфигурации для Roistat

В конфигурации MCP-клиента замените абсолютный путь, API-ключ и ID проекта. Храните файл с секретами вне публичного репозитория.

{
  "mcpServers": {
    "mcp-roistat": {
      "command": "node",
      "args": [
        "/absolute/path/to/ohmy-seo/packages/roistat/dist/index.js"
      ],
      "env": {
        "ROISTAT_API_KEY": "YOUR_ROISTAT_API_KEY",
        "ROISTAT_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

Документация каждого пакета

yandex-seo ↗google-ads ↗google-search-console ↗ga4 ↗gtm ↗roistat ↗mutagen ↗xmlstock ↗

Локальная синхронизация токенов с облачным кабинетом — отдельный режим, зависящий от брокера. Самостоятельная установка пакетов требует собственных настроек доступа.

Если подключение не заработало

Сервер отсутствует в списке инструментов

Проверьте конфигурацию именно для вашего приложения, транспорт Streamable HTTP и заголовок авторизации. Для переменных окружения убедитесь, что их видит процесс клиента; после настройки откройте новую сессию. В Claude Code используйте claude mcp list и /mcp. Для stdio проверьте абсолютный путь и наличие собранного файла.

Ошибка авторизации

При 401 проверьте, что используется API-ключ ohmy-seo без лишних пробелов, а не токен Яндекса или Google. В заголовке Authorization перед ключом должно стоять Bearer и один пробел. Если клиент предлагает OAuth-вход, выберите настройку по API-ключу из соответствующей вкладки. Если ключ отозван, создайте новый в кабинете.

Аккаунт есть, но нужных данных нет

Проверьте права на сайт, счётчик или рекламный аккаунт. Наличие Google-подключения не добавляет Google Ads. Для Директа проверьте статус доступа приложения.

Отчёт отличается от интерфейса сервиса

Сверьте период, часовой пояс, фильтры, цель и модель атрибуции. Учитывайте задержки API и ограничения выборки. Попросите AI показать параметры запроса.

ПЕРВЫЙ ШАГ

Подключите рабочий аккаунт

Войдите через Яндекс, добавьте сервисы и создайте ключ для MCP.

Перейти к подключению Как подключить MCP