Подключить ИИ-агента по MCP: ключ, права и настройка клиента
Создайте ключ в профиле: «Подключение ИИ-агента по MCP» → «Создать ключ MCP», выберите права и сохраните ключ. В клиенте укажите адрес сервера, транспорт Streamable HTTP и заголовок Authorization: Bearer с ключом.
MCP — открытый протокол, по которому ИИ-агенты подключаются к внешним сервисам. Через MCP-сервер SerpJet агент (например, Codex, Claude Code или другой MCP-клиент) работает с вашим аккаунтом так же, как вы в панели: создаёт и настраивает проекты, управляет темами и статьями, смотрит аналитику. Что именно доступно агенту — в статье Что агент может через MCP, что остаётся в браузере и как повторять команды.
Создать ключ
- Откройте Профиль → блок «Подключение ИИ-агента по MCP» → «Создать ключ MCP».
- Задайте название ключа, например «Codex на рабочем ноутбуке». Название видно только вам и помогает понять, какой ключ отзывать.
- Отметьте права ключа — разделы, в которых агент сможет читать данные и выполнять действия:
- Проекты — все ваши проекты: создание, настройки, темы, генерация, статьи, публикация, аналитика и удаление.
- Аккаунт — данные профиля и настройки аккаунта.
- Оплата — баланс, платежи и партнёрские начисления.
- Поддержка — чтение и отправка обращений.
- Нажмите «Выпустить ключ» и сразу скопируйте его. Полный ключ показывается один раз; позже в списке видны только название, последние символы, дата и права.
Выдавайте каждому агенту отдельный ключ и только те права, которые нужны для задачи. Для ведения проектов обычно достаточно права «Проекты». На аккаунт можно выпустить до 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 доставки: замена одного не влияет на другой.
Не нашли ответ? Напишите в поддержку из панели — укажите проект и что вы видите на экране.