Золотенков
Выпустить ключ

Протокол контекста модели (MCP)

Подключите ИИ-агента к своему производству

Одна настройка дает агенту инструменты Золотенков МРП. Отдельный сервер или программная прослойка на вашей стороне не нужны.

Клиента вы выбираете сами: ниже готовые рецепты для 8 самых распространенных — Claude Code, Codex CLI, Gemini CLI, Cursor, VS Code с Copilot, приложения Claude — и для самостоятельных агентов OpenClaw и OpenHands, которые работают без человека за экраном. Для любого другого клиента дальше есть общий формат.

Шаг 1

Выпустите отдельный ключ для агента

В разделе «Настройки → API-ключи» создайте ключ, назовите его по агенту и оставьте только необходимые действия. Значение показывается один раз.

Открыть API-ключи

Безопасный профиль на старте

  • ●Начните с прав только на чтение.
  • ●Выберите короткий срок действия ключа.
  • ●Не передавайте ключ в сообщении агенту — храните его в настройках клиента.
  • ●Добавляйте право записи только под проверенный сценарий.

Шаг 2

Настройте своего клиента

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

Транспорт
streamable HTTP (http)
Адрес
https://mrp.zolotenkov.ru/api/external/v1/mcp
Заголовок
Authorization: Bearer <ключ>

Две строки в терминале

Где окажется настройка: личная настройка ~/.claude.json — вне репозитория, во всех ваших проектах

терминал 
read -rs ZOLOTENKOV_MRP_TOKEN && export ZOLOTENKOV_MRP_TOKEN

claude mcp add --transport http zolotenkov-mrp --scope user \
  https://mrp.zolotenkov.ru/api/external/v1/mcp \
  --header "Authorization: Bearer $ZOLOTENKOV_MRP_TOKEN"
  • Первая строка просит ключ и кладет его в переменную окружения ZOLOTENKOV_MRP_TOKEN: значение не отобразится на экране и не попадет в историю команд.
  • Флаг --scope user пишет сервер в вашу личную настройку. Альтернативный --scope project положил бы его в файл .mcp.json в корне проекта, а этот файл уезжает в git всей команде вместе с ключом.
  • Успех подтверждается строкой Added zolotenkov-mrp. Она означает, что настройка записана, а не что связь проверена.

Проверка в этом клиенте: claude mcp list в терминале или команда /mcp внутри сессии: рядом с zolotenkov-mrp должно стоять «Connected».

Откуда взяты рецепты. Путь Claude Code мы проходим целиком сами — от команды до подключенного сервера. Остальные собраны по документации самих клиентов: расположение файла, имя поля с адресом и поддержка заголовка Authorization меняются от версии к версии, поэтому при расхождении верьте документации своего клиента, а не этой странице — и напишите нам.
Ключ не место в репозитории. Настройка внутри проекта — файл .mcp.json у Claude Code, .cursor/mcp.json у Cursor, .vscode/mcp.json у VS Code — попадает в git и уезжает всей команде. Кладите туда только подстановку из переменной окружения, а не готовое значение. Ключ нельзя коммитить и нельзя присылать сообщением самому агенту: у каждого человека свой ключ и свои права.

Клиента нет среди вкладок

Настройка через файл JSON

Тот же сервер описывается блоком ниже — с него начинают все клиенты, которых нет среди вкладок. Это не универсальный формат: имя файла, его расположение и поддержка заголовка Authorization у каждого клиента свои — сверьтесь с его документацией. Клиент без поддержки удаленных серверов по HTTP подключить так нельзя.

Собственному агенту на любом SDK этого протокола отдельного рецепта не нужно: адрес и заголовок те же.

конфигурация клиента 
{
  "mcpServers": {
    "zolotenkov-mrp": {
      "type": "http",
      "url": "https://mrp.zolotenkov.ru/api/external/v1/mcp",
      "headers": {
        "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ"
      }
    }
  }
}

Шаг 3

Проверьте соединение и чтение

Записанная настройка — еще не подключенный сервер. Проверка занимает две минуты и сразу отличает неверный ключ от нехватки прав.

  1. 1. Перечитайте настройку. Клиент читает конфигурацию при запуске: закройте сессию или окно редактора и откройте заново. У Claude Code это новая сессия командой claude.
  2. 2. Посмотрите состояние серверов. Команда или экран для этого свои у каждого клиента — они названы в его вкладке на шаге 2: например, claude mcp list и /mcp у Claude Code, codex mcp list у Codex CLI, «MCP: List Servers» у VS Code. Рядом с zolotenkov-mrp должно стоять «Connected» или его местный эквивалент. Ответ вида «Failed to connect» означает, что до сервера дошли, но он отказал, — причина в той же строке.
  3. 3. Проверьте чтение. Попросите агента прочитать список заказов покупателей или остатки. Успешный ответ с вашими данными и есть подтверждение подключения.

Две разные неполадки, которые легко перепутать

Сервер не подключился, в ответе 401
Ключ неверный, отозван или истек — либо потерялась переменная окружения и в заголовок ушла пустая строка. Выпустите ключ заново и повторите шаг 2.
Сервер подключен, но нужного инструмента нет в списке
Это не ошибка связи, а отсутствие права у ключа. Инструмент не появляется вовсе — не «появляется и отказывает». Добавьте нужное право ключу в «Настройках → API-ключи».

Только после успешной проверки чтения добавляйте права создания и изменения документов.

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