К содержанию
SerpJet Документация Войти
Разделы
  1. Документация
  2. ИИ-агенты и MCP

Подключить ИИ-агента по MCP: ключ, права и настройка клиента

Создайте ключ в профиле: «Подключение ИИ-агента по MCP» → «Создать ключ MCP», выберите права и сохраните ключ. В клиенте укажите адрес сервера, транспорт Streamable HTTP и заголовок Authorization: Bearer с ключом.

Проверено
Содержание
  1. Создать ключ
  2. Настроить MCP-клиент
  3. Проверить подключение
  4. Заменить или отозвать ключ

MCP — открытый протокол, по которому ИИ-агенты подключаются к внешним сервисам. Через MCP-сервер SerpJet агент (например, Codex, Claude Code или другой MCP-клиент) работает с вашим аккаунтом так же, как вы в панели: создаёт и настраивает проекты, управляет темами и статьями, смотрит аналитику. Что именно доступно агенту — в статье Что агент может через MCP, что остаётся в браузере и как повторять команды.

Создать ключ

  1. Откройте Профиль → блок «Подключение ИИ-агента по MCP» → «Создать ключ MCP».
  2. Задайте название ключа, например «Codex на рабочем ноутбуке». Название видно только вам и помогает понять, какой ключ отзывать.
  3. Отметьте права ключа — разделы, в которых агент сможет читать данные и выполнять действия:
    • Проекты — все ваши проекты: создание, настройки, темы, генерация, статьи, публикация, аналитика и удаление.
    • Аккаунт — данные профиля и настройки аккаунта.
    • Оплата — баланс, платежи и партнёрские начисления.
    • Поддержка — чтение и отправка обращений.
  4. Нажмите «Выпустить ключ» и сразу скопируйте его. Полный ключ показывается один раз; позже в списке видны только название, последние символы, дата и права.

Выдавайте каждому агенту отдельный ключ и только те права, которые нужны для задачи. Для ведения проектов обычно достаточно права «Проекты». На аккаунт можно выпустить до 20 ключей.

Настроить MCP-клиент

В том же блоке профиля есть адрес сервера MCP — скопируйте его кнопкой рядом. В настройках клиента:

  • выберите транспорт Streamable HTTP;
  • укажите адрес сервера;
  • добавьте заголовок Authorization: Bearer <ключ>.

Клиент должен уметь передавать собственный заголовок Bearer. Вход через OAuth не поддерживается, поэтому клиенты, которые подключают серверы только через OAuth, к SerpJet не подключатся.

Codex

Добавьте сервер в config.toml и перед запуском задайте переменную окружения SERPJET_MCP_TOKEN с ключом:

[mcp_servers.serpjet]
url = "https://serpjet.ru/mcp"
bearer_token_env_var = "SERPJET_MCP_TOKEN"

Claude Code

claude mcp add --transport http serpjet https://serpjet.ru/mcp \
  --header "Authorization: Bearer <ключ>"

Подставьте адрес сервера из профиля, если он отличается от указанного в примере.

Проверить подключение

Попросите агента прочитать что-нибудь из раздела, на который у ключа есть права: с правом «Проекты» — список ваших проектов (он совпадёт с экраном «Проекты»), с правом «Аккаунт» — данные профиля, с правом «Оплата» — баланс, с правом «Поддержка» — список обращений. Если клиент сообщает об ошибке авторизации, проверьте, что ключ скопирован целиком, не отозван и передаётся в заголовке Authorization со словом Bearer.

Заменить или отозвать ключ

  • В списке «Активные ключи» нажмите «Отозвать» у нужного ключа. Агент сразу теряет доступ по этому ключу; остальные ключи продолжают работать.
  • Чтобы заменить ключ, выпустите новый, пропишите его в клиенте, переподключите клиент и отзовите старый.
  • Если ключ мог попасть к посторонним — отзовите его сразу. Не отправляйте ключ в переписке, в том числе в поддержку.

Ключи MCP не связаны с ключом внешнего API доставки: замена одного не влияет на другой.

Не нашли ответ? Напишите в поддержку из панели — укажите проект и что вы видите на экране.