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 Desktop

Через локальный мост

Для настольного Claude на macOS и Windows: локальный процесс mcp-remote передаёт запросы в облачный ohmy-seo. Собирать наши пакеты для этого не нужно.

  1. Установите Node.js LTS и убедитесь, что команда npx доступна на компьютере с Claude.
  2. Откройте локальную MCP-конфигурацию Claude Desktop: файл claude_desktop_config.json. На macOS он находится в ~/Library/Application Support/Claude/, на Windows — в %APPDATA%\Claude\.
  3. Добавьте ohmy-seo в объект mcpServers, замените YOUR_API_KEY ключом из кабинета и сохраните файл. Если серверы уже настроены, сохраните их записи.
  4. Полностью закройте Claude Desktop, запустите заново и включите ohmy-seo в инструментах чата.
claude_desktop_config.json
{
  "mcpServers": {
    "ohmy-seo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ohmy-seo.ru/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${OHMY_SEO_AUTH}"
      ],
      "env": {
        "OHMY_SEO_AUTH": "Bearer YOUR_API_KEY"
      }
    }
  }
}

mcp-remote — сторонний локальный мост; npx скачает его при первом запуске. Эта настройка относится к локальным MCP Claude Desktop, а не к веб-коннекторам или Cowork. На Windows при ошибке запуска npx используйте npx.cmd.

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

Попросите показать аккаунты через ohmy-seo. Если сервер не появился, проверьте JSON, доступность npx и журнал локального MCP.

Локальные MCP в Claude Desktop ↗Документация mcp-remote ↗

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