MCP-сервер для SEO: позиции сайта в Claude Code и Codex

Содержание

• Что это
• Адрес и авторизация
• Доступные инструменты
• Подключение в Claude Code
• Подключение в Codex
• Claude Desktop и другие клиенты
• Тарификация

Что это

MCP (Model Context Protocol) - это открытый протокол, по которому языковые модели вызывают внешние инструменты. MCP-сервер JSON SEO даёт вашему AI-агенту прямой доступ к поисковой выдаче: модель сама запрашивает позиции, выдачу и регионы, без ручного дёргания API.

Все вызовы используют ваш существующий API-ключ и тот же баланс. Никаких отдельных токенов и тарифов.

Адрес и авторизация

Эндпоинт MCP-сервера (HTTP transport):

https://jsonseo.ru/mcp

Авторизация Bearer-токеном в заголовке, как и в обычном API. Используйте тот же API-ключ:

Authorization: Bearer ВАШ_КЛЮЧ

Клиенты, у которых в настройках только поле адреса и некуда вписать заголовок (например, «Add custom connector» в Claude Desktop), могут передать ключ прямо в адресе:

https://jsonseo.ru/mcp?key=ВАШ_КЛЮЧ

Доступные инструменты

Какой вид частотности выбирать

Параметр kind у wordstat_frequency. Модель получает эти же правила в инструкциях сервера, но и человеку полезно знать:

• exact (по умолчанию) - точная частотность: сколько раз ищут ровно эту фразу в этих словоформах. Для прогноза трафика и приоритезации запросов - всегда она.
• base - базовая: любые формы, порядок и хвосты. Только для оценки объёма ниши; как прогноз трафика завышена в разы.
• phrase - фразовая: состав слов зафиксирован. Показывает спрос на формулировку без хвостов.
• superexact - сверхточная: плюс порядок слов. Нужна, когда порядок меняет смысл («билеты москва казань» против обратного направления).

Подробный разбор с примерами - в статье про виды частотности в Вордстате.

Экономия токенов

• Нужен только номер позиции сайта → используйте *_position.
• Нужен список без сниппетов → у *_search передайте compact: true (вернёт только позицию, домен и URL).
• Нужна выдача только до конкретного сайта → передайте его домен в break_domain, поиск остановится на нём (и спишется меньше).
• Нужна только частотность фразы → используйте wordstat_frequency, а не wordstat.

Регионы для геолокации

• Яндекс: числовой ID региона. Найдите его инструментом yandex_regions (например, «Казань» → 43) или в справочнике регионов.
• Google: числовой ID региона в параметре region. Найдите его инструментом google_regions (например, «Москва» → 1011969) или в справочнике регионов Google. Можно задать и координатами.
• Bing: координаты точки (широта/долгота). Например, центр Москвы: lat=55.7558, lon=37.6173.

Подключение в Claude Code

Через каталог плагинов

JSON SEO опубликован в каталоге Anthropic как плагин: кроме самого сервера он содержит три навыка, которые учат Claude подбирать регион, экономить вызовы и считать прогноз Директа одним запросом.

1. На claude.ai откройте «Customize» → «Plugins», найдите JSON SEO и нажмите «Add».
2. Запустите Claude Code под тем же аккаунтом — плагин подтянется сам и появится в /plugin на вкладке «Installed» как jsonseo@synced. Если сессия уже открыта, выполните /reload-plugins.
3. Откройте /mcp, выберите jsonseo и нажмите Authenticate. Откроется браузер: войдите в JSON SEO и нажмите «Разрешить».

Без плагина, одной командой

Добавьте сервер напрямую, ключ не нужен:

claude mcp add --transport http jsonseo https://jsonseo.ru/mcp

Затем в диалоге Claude Code откройте /mcp, выберите jsonseo и нажмите Authenticate. Откроется браузер: войдите в JSON SEO и нажмите «Разрешить».

Если удобнее ключом, добавьте сервер с заголовком (подставьте свой API-ключ):

claude mcp add --transport http jsonseo https://jsonseo.ru/mcp \
  --header "Authorization: Bearer ВАШ_КЛЮЧ"

Проверьте, что сервер подключён:

claude mcp list

После этого в диалоге можно просить, например: «Найди позицию сайта example.com в Яндексе по запросу „купить ноутбук“ в Москве». Модель сама вызовет yandex_regions и yandex_position.

Подключение в Codex

Codex поддерживает Streamable HTTP MCP-серверы в CLI и IDE-расширении. Добавьте сервер и войдите через браузер, ключ не нужен:

codex mcp add jsonseo --url https://jsonseo.ru/mcp
codex mcp login jsonseo

Откроется страница входа JSON SEO — войдите и нажмите «Разрешить». В ~/.codex/config.toml появится запись:

[mcp_servers.jsonseo]
enabled = true
url = "https://jsonseo.ru/mcp"

Проверить список серверов можно командой codex mcp list, подробности по одному — codex mcp get jsonseo. В TUI Codex доступна команда /mcp для просмотра активных MCP-серверов.

Вариант с API-ключом

Если вход через браузер недоступен (сервер CI, контейнер), передайте ключ переменной окружения:

export JSONSEO_API_KEY=ВАШ_КЛЮЧ
codex mcp add jsonseo --url https://jsonseo.ru/mcp --bearer-token-env-var JSONSEO_API_KEY

[mcp_servers.jsonseo]
enabled = true
url = "https://jsonseo.ru/mcp"
bearer_token_env_var = "JSONSEO_API_KEY"

Либо прямо в config.toml заголовком:

[mcp_servers.jsonseo]
enabled = true
url = "https://jsonseo.ru/mcp"
http_headers = { "Authorization" = "Bearer ВАШ_КЛЮЧ" }

Claude Desktop и другие клиенты

Проще всего — из каталога: «Settings» → «Connectors» → «Browse connectors», найдите JSON SEO и нажмите «Connect». То же самое есть на claude.ai в разделе «Customize». Если каталог недоступен, удалённый сервер добавляется руками:

1. Настройки: Ctrl+, либо меню в левом верхнем углу → «File» → «Settings».
2. Раздел «Connectors» → кнопка «Add» → «Add custom connector».
3. Имя — jsonseo, адрес — https://jsonseo.ru/mcp. Поля «OAuth Client ID» и «Client Secret» оставьте пустыми: Claude зарегистрируется сам.
4. Нажмите «Add», затем «Connect»: войдите в JSON SEO и нажмите «Разрешить».

Ключ API можно передать и в адресе — для клиентов, у которых есть только поле адреса и нет входа через браузер:

https://jsonseo.ru/mcp?key=ВАШ_КЛЮЧ

Клиенты, которые читают конфиг в формате JSON (Cursor и другие), а также те случаи, когда ключ хочется держать в заголовке, а не в адресе, подключаются через мост mcp-remote:

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

Файл конфигурации Claude Desktop лежит здесь (Настройки → «Developer» → «Edit Config» открывает его же):

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

После правки файла Claude Desktop нужно полностью закрыть и запустить заново — конфигурация читается только при старте. Для этого варианта нужен Node.js: мост запускается через npx.

Клиенты с нативной поддержкой HTTP-транспорта и произвольных заголовков могут указывать URL https://jsonseo.ru/mcp и заголовок Authorization напрямую.

Тарификация

0.01₽ × количество страниц выдачи, как и в обычном API.

Частые вопросы