Как подключить MCP-сервер: Claude Code, Codex, Cursor и Desktop

· MCP · инструкция

Подключить MCP-сервер - это несколько строк в конфиг клиента, а не вечер с документацией. Клиенту нужно сообщить всего три вещи:

  1. адрес эндпоинта - https://jsonseo.ru/mcp;
  2. тип транспорта - обычно HTTP;
  3. токен авторизации - заголовок Authorization: Bearer с вашим ключом.

Дальше модель сама увидит инструменты сервера и начнёт ими пользоваться. Разберём это на четырёх клиентах - Claude Code, Codex, Cursor и Claude Desktop, - на примере сервера JSON SEO для позиций, выдачи и Вордстата.

Что понадобится в любом случае: адрес эндпоинта https://jsonseo.ru/mcp и ваш API-ключ из личного кабинета. Ключ тот же, что и для обычного API, отдельный токен для MCP заводить не нужно. Если ещё не понимаете, что вообще происходит под капотом, начните со статьи что такое MCP-сервер, а сюда вернитесь за командами.

Claude Code

Самый быстрый путь. MCP-сервер для Claude добавляется одной командой в терминале, подставьте свой ключ:

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/config.toml (или в проектном .codex/config.toml для доверенных проектов). Добавьте туда блок сервера:

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

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

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

Список подключённых серверов покажет codex mcp list, а в TUI Codex за это отвечает команда /mcp. Вариант с переменной окружения безопаснее: сам ключ остаётся только в окружении и не попадает в файл, который легко случайно закоммитить.

Claude Desktop, Cursor и остальные

Клиенты, которые хранят конфиг в JSON (Claude Desktop, Cursor и им подобные), исторически ждут запуск локального процесса. Чтобы подсунуть им HTTP-сервер, используют мост mcp-remote - он поднимается через npx и проксирует запросы на удалённый эндпоинт:

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

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

Как убедиться, что всё работает

Первый признак - сервер виден в списке (claude mcp list, codex mcp list или меню MCP в приложении). Второй, куда более наглядный, - попросите модель сделать что-то, чего без сервера она сделать не может. «Какая частотность у фразы заказать пиццу в точной форме?» - и если в ответ прилетело живое число, значит, инструмент wordstat_frequency отработал, ключ принят, баланс списался.

Если сервер не подключается, чаще всего дело в трёх вещах. Опечатка в токене - перепроверьте ключ в кабинете. Клиент не умеет HTTP-транспорт напрямую - тогда идите через mcp-remote. И забытый префикс Bearer в заголовке: должно быть именно Authorization: Bearer и дальше ключ, а не голый ключ.

Что дальше

После подключения модели становятся доступны все инструменты сервера: выдача Яндекса, Google и Bing, позиции по домену, подсказки, частотность, график и география показов из Вордстата, прогноз бюджета Директа. Полный список с параметрами и правилами тарификации - в документации MCP. А зачем всё это в повседневной работе оптимизатора, разобрано в заметке про проверку позиций через Claude Code. Каким ещё серверам стоит найти место в конфиге - в подборке лучших MCP-серверов.

Читайте дальше