Стратегическая Мастерскаяmaster-strategy.ru

Агент не подключается к платформе: что проверить

Агент не подключается к платформе: что проверить

Подключение агента к платформе — это один адрес и вход в браузере, без копирования ключей. Если вход не проходит, ниже — что проверить по порядку и какие сведения передать поддержке.

Кому и что нужно заранее

  • Агент, который умеет подключаться к внешним сервисам: Claude Code, claude.ai, Claude Desktop или Codex.
  • Аккаунт на платформе. Если его нет, вы создадите его прямо на шаге входа — вместе с бесплатным пробным периодом.
  • Адрес подключения и готовые команды для каждого клиента — на странице «Подключить агента». Вкладка курса «Работать через агента» ведёт в настройки подключений.

Как открыть

Подключение начинается не на платформе, а в агенте: вы даёте ему адрес — он сам открывает браузер. Экран подключения на платформе человек видит только в этот момент.

Что делать

  1. Дайте агенту адрес. Готовой командой со страницы «Подключить агента»: для Claude Code — claude mcp add --transport http thinkdo <адрес>, для Codex — codex mcp add thinkdo --url <адрес>, для claude.ai и Claude Desktop — «Настройки» → «Коннекторы» → «Добавить свой коннектор».
  2. Запустите вход. В Claude Code: /mcp → thinkdo → Authenticate; в Codex: codex mcp login thinkdo; в коннекторе — Connect. В открывшемся браузере выберите «Войти и продолжить», если аккаунт есть, или «Создать аккаунт и продолжить», если нет.
  3. Нажмите «Разрешить». Рядом платформа показывает адрес возврата — эту строку стоит сверить: ответ уходит туда.
  4. Вернитесь в агента. Проверка одна: спросите «кто я на платформе» — агент назовёт вашу учётку.
  5. Если браузера рядом нет (агент на сервере, доступ по SSH) — на экране «Доступ разрешён» есть блок «Агент на сервере (VPS, SSH)?» со строкой для второго окна. Код действует 60 секунд и срабатывает один раз.

Если что-то не так

  • Открыли адрес подключения в браузере и видите Missing or invalid Authorization header — так и должно быть: адрес предназначен агенту, а не человеку. Вставьте его в агента по инструкции выше.
  • «Запрос устарел — повторите подключение в клиенте» или «Ссылка неполная — повторите подключение в клиенте» — начатое подключение живёт 10 минут, а ссылку из старой вкладки использовать нельзя. Запустите вход в агенте заново.
  • «Запрос начат в другом браузере — повторите подключение в клиенте» — открыть ссылку подключения нужно в том же браузере, где вы начали вход.
  • «Разрешил, а агент молчит» — спросите «кто я на платформе». Если ответа нет, откройте «Профиль» → «Настройки профиля» → раздел «Подключения агентов»: у каждой строки есть «выдан <дата>» и либо «последний выход <дата>», либо «ни разу не выходил на связь». Это отсутствие зафиксированной успешной связи, а не точный диагноз. Проверьте адрес, повторите вызов; отметка обновляется не чаще раза в 5 минут.
  • В списке «активных ключей нет» — в этой учётке нет активных подключений: проверьте выбранную учётку, завершение входа и возможный отзыв.
  • Подключение исчезло после чистки в настройках — кнопки «отозвать» и «отозвать все» убирают подключения намеренно. Выдайте его заново тем же путём.
  • Просит подтвердить почту — подключение уже работает; подтверждение включает ИИ-бюджет пробного периода, а не доступ.
  • Вместо «Выдать ключ» написано «Подключение агента доступно с тарифа Pro» — так показывается ограничение на ключ для скриптов и CI. Что доступно на вашем тарифе, видно по ссылке «Посмотреть тарифы».
  • Codex на macOS: браузер не открывается, подключение выглядит как тайм-аут — известная проблема, похожая на openai/codex#34684, наблюдалась 13.10.2026 на версии 0.155.0-alpha.9. Сам таймаут её не доказывает. Обновите Codex до стабильного релиза и проверьте codex mcp login --help. Если версия поддерживает параметр, попробуйте codex mcp login thinkdo --oauth-client-registration dcr. Временный обход — Claude Code либо мост mcp-remote (нужен Node.js), отдельным подключением: codex mcp add thinkdo-bridge -- npx -y mcp-remote "https://lab.master-strategy.ru/mcp/". На время проверки используйте только нужное подключение, чтобы не путать учётки.
  • Нужен ключ для скрипта или CI — «Профиль» → «Настройки профиля» → «Подключения агентов» → «Выдать ключ». Ключ действует 90 дней, и значение показывается один раз: «Скопируйте ключ сейчас — повторно он не покажется». Перед выдачей можно задать «Имя подключения» — по нему видно, каким ключом ходит агент.

Ещё три проверки

  • VPN или прокси: если правила вашей сети допускают, повторите одну попытку без него или в другой сети. Браузер и агент могут использовать разные настройки. Один успешный вход в браузере не доказывает, что агент тоже имеет доступ.
  • Две учётки: спросите агента «кто я на платформе» через нужное подключение. На экране согласия проверьте почту; если она чужая — «Это не вы? Выйти» и новый вход.
  • Доступ работал и пропал: браузерное подключение обычно обновляется клиентом автоматически. Если обновление не удалось, повторите вход. Статический ключ по окончании 90 дней нужно заменить новым. Начальный 401 без входа нормален; повторный 401 после входа требует проверки авторизации. При 403 или отказе отдельного действия проверьте учётку и права на материал, а не выдавайте ключи вслепую.

Что передать поддержке

В разделе «Поддержка» сообщите ОС, название и точную версию агента, адрес подключения, время попытки с часовым поясом, текст ошибки и последний успешный шаг: открылся браузер, нажали «Разрешить», агент назвал учётку. Укажите наличие VPN/прокси. Не присылайте ключи, токены, пароль, код и полную ссылку возврата.

Что важно знать

  • Агент действует вашими правами. Что видите вы — видит и он; чужие материалы подключение не открывает.
  • Отозвать можно в любой момент. После отзыва агент получает отказ и просит войти заново.
  • Ключ и вход через браузер — разные вещи. Браузерный вход ключей не требует; ключ нужен скриптам и CI. Отметка «последний выход» обновляется не чаще раза в 5 минут — по ней судят, выходил ли агент на связь.
  • Подключений может быть несколько. У каждого своё имя и своя дата: если ответы приходят «не от того имени», посмотрите, каким подключением ходит агент.
  • Материалы остаются у вас. Отзыв подключения не удаляет ваши материалы и курсы.

Продолжение — в статье «Первая лекция вашим ученикам — из ваших материалов, за один разговор с агентом»: там подключение разобрано для задачи преподавателя, от подготовки лекции до потока учеников.

обновлено 14.10.2026

теги: help · подключение · агент · mcp · ключ · codex · claude-code

Этот материал — часть открытой витрины базы «Экспертная база: создание баз знаний и ведение менторинга». Применение в собственных задачах через рабочие сессии и навыки эксперта — на платформе.

ЗарегистрироватьсяВойти

Регистрация бесплатна и открывает каталог баз знаний. Полный доступ к базе и рабочим сессиям — по подписке; в поток с сопровождением — по заявке.