MCP-сервер для LLM

Содержание

• Что это
• Адрес и авторизация
• Доступные инструменты
• Подключение в 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 ВАШ_API_КЛЮЧ

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

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

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

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

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

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

Добавьте сервер одной командой (подставьте свой API-ключ):

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

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

claude mcp list

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

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

Codex поддерживает Streamable HTTP MCP-серверы в CLI и IDE-расширении. Конфигурация хранится в ~/.codex/config.toml или в проектном .codex/config.toml для доверенных проектов.

Добавьте JSON SEO MCP-сервер в config.toml:

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

Если не хотите хранить API-ключ в файле, используйте переменную окружения:

export JSONSEO_API_KEY=ВАШ_API_КЛЮЧ
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"

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

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

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

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

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

Тарификация

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

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