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

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

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

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

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

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

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

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

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

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

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

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

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

Claude Web / Cowork

Используйте локальный Claude Desktop

Веб-коннекторы Claude и локальные MCP Claude Desktop — разные способы подключения. Готовая инструкция ohmy-seo с API-ключом сейчас рассчитана на локальный Desktop или Claude Code.

  1. Для подключения сейчас выберите Claude Desktop или Claude Code и выполните соответствующую инструкцию.
  2. Не вставляйте JSON локального сервера в форму веб-коннектора. Она не запускает mcp-remote на вашем компьютере.
  3. Прямое подключение по URL требует отдельной совместимой авторизации; этот сценарий ohmy-seo пока не предоставляет.
Проверка подключения

Локальная настройка Desktop не переносит инструменты в claude.ai или Cowork. Проверяйте их в обычном чате Desktop.

Форматы сверены с документацией разработчиков 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"
      }
    }
  }
}

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

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

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

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

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

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

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

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

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

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

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

ПЕРВЫЙ ШАГ

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

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