Подключение AI-агента

Reconstruct предоставляет данные захваченных интерфейсов через сервер MCP. Выберите агента для просмотра инструкций:

• Codex
• Claude
• Cursor
• Cline
• GitHub Copilot в VS Code
• Gemini CLI
• MiMo
• Muse Code
• Grok Build
• Hermes Agent
• OpenClaw
• OpenMausBot
• Другие клиенты MCP

Перед началом

Конечная точка Reconstruct MCP — https://reconstruct.dev/mcp, транспорт — Streamable HTTP. Подключиться можно через OAuth в браузере или персональный токен.

Способ	Как работает	Когда использовать
Вход через браузер по OAuth	Клиент MCP открывает вход Reconstruct в браузере. Войдите, разрешите доступ и вернитесь в клиент. Создавать или копировать токен на платформе не нужно.	Интерактивные агенты и редакторы с поддержкой OAuth.
Персональный токен доступа	Создайте токен MCP в настройках платформы и добавьте в учётные данные клиента.	Клиенты без OAuth и автоматизированные окружения без входа через браузер.

Оба способа подключаются к одному серверу MCP и используют подписку и квоту вашей учётной записи Reconstruct.

Вход через браузер по OAuth

Перед подключением по OAuth выпускать персональный токен на платформе не требуется.

1. Добавьте https://reconstruct.dev/mcp как удалённый HTTP-сервер MCP в клиенте.
2. Выберите OAuth или вход через браузер. Если клиент запрашивает параметры, используйте значения ниже.
3. Запустите Sign in (Войти), Connect (Подключить) или команду входа MCP клиента. Точное действие зависит от клиента.
4. В браузере войдите в учётную запись Reconstruct и разрешите запрошенный доступ. Если регистрация закрыта, обратитесь в поддержку за доступом к учётной записи.
5. Вернитесь в клиент и обновите инструменты. Попросите вызвать list_products для подтверждения подключения.

Параметр	Значение
URL сервера	https://reconstruct.dev/mcp
Транспорт	Streamable HTTP
ID клиента OAuth	reconstruct-mcp для предварительно настроенных клиентов; Claude Desktop регистрируется автоматически
Области доступа	openid aud-mcp
Секрет клиента	Оставьте пустым
Издатель OAuth	https://reconstruct.dev/sso/realms/reconstruct
Конечная точка авторизации	https://reconstruct.dev/sso/realms/reconstruct/protocol/openid-connect/auth
Конечная точка токена	https://reconstruct.dev/sso/realms/reconstruct/protocol/openid-connect/token

После входа клиент получает и сохраняет учётные данные OAuth и использует их для MCP. Копировать токен или задавать CR_RECONSTRUCT_MCP_TOKEN не нужно. При переводе существующего подключения на OAuth удалите вручную настроенные заголовки Authorization и параметры bearer-токена.

См. примеры OAuth для Codex, Claude Code, Cursor, Cline, OpenMausBot или другого клиента MCP. Используйте адреса обратного вызова из руководства клиента. Если клиент просит войти снова, повторите его процесс входа MCP.

Совместимость клиентов

Примеры входа в браузере охватывают Claude, Cursor, Claude Code, Codex, Grok Build и Muse Code с зарегистрированными адресами обратного вызова. Руководства Gemini CLI, VS Code, MiMo Code, MiMo Desktop, Hermes Agent и OpenClaw используют персональные токены; VS Code также предлагает установку одним нажатием с автоматической регистрацией. Claude Desktop и веб-коннектор поддерживают автоматическую регистрацию с одобренным точным HTTPS-адресом. Другие клиенты с обнаружением OAuth и динамической регистрацией тоже могут подключиться только по URL сервера; они регистрируют и обрабатывают собственный точный HTTPS- или loopback-адрес. Для клиентов без DCR остаётся вариант с заранее настроенным публичным клиентом.

Конечные точки OAuth берутся из метаданных обнаружения. Они находятся под realm SSO, а не в /authorize или /token корня сайта. Если клиент открывает корневую точку, перезагрузите конфигурацию сервера и повторите вход, обновив кеш обнаружения.

Для облачного коннектора Claude следуйте руководству Claude Desktop. Перед подключением другой облачной интеграции передайте поддержке точный URI обратного вызова. Для reconstruct-mcp секрет клиента не вводится.

Обнаружение агентов и вход по устройству

Публичное обнаружение начинается с https://reconstruct.dev/mcp/server-card. Корневой /.well-known/api-catalog перечисляет публичную документацию API, а /.well-known/agent-skills/index.json — процессы Reconstruct и их установочные архивы. Девять процессов, чтение ресурсов MCP без отдельной установки, установка с сайта или GitHub CLI, ручные загрузки и клиентские пакеты плагинов описаны в Навыках Reconstruct. Для подключения к удалённому MCP пользователю не нужен .NET SDK.

Опубликованные страницы сайта и документация принимают Accept: text/markdown. Страницы рабочей области по-прежнему требуют доступ к учётной записи.

Клиенты с OAuth Device Authorization могут прочитать https://reconstruct.dev/auth.md и отправить POST {"type":"anonymous"} на https://reconstruct.dev/agent/register. Ответ содержит ожидающую авторизацию устройства, URL и код проверки пользователя, срок действия, интервал опроса и закрытый PKCE code_verifier. Покажите пользователю инструкции проверки. Он должен войти и разрешить доступ. Затем агент опрашивает точку токена издателя, используя device-code grant и возвращённый code_verifier. Соблюдайте интервал и ответы slow_down. Сама регистрация не выдаёт токен и не создаёт учётную запись. Существующие роли, ограничения подписки и требования согласия сохраняются.

Не раскрывайте коды устройства, верификаторы и токены. Никогда не разрешайте доступ за пользователя. Процесс доступен клиентам, которые его реализуют; он не заменяет существующий вход редактора по коду авторизации + PKCE.

Персональный токен доступа

1. Войдите в Reconstruct Platform и откройте Settings → API tokens (Настройки → Токены API).
2. Создайте токен с областью MCP (mcp) и скопируйте секрет, когда он появится.
3. Настройте отправку Authorization: Bearer <token>. Если клиент читает токен из переменной окружения, используйте CR_RECONSTRUCT_MCP_TOKEN.
4. Подключитесь и попросите клиент вызвать list_products.

Храните токен в локальном секрете или хранилище учётных данных клиента. При истечении или отзыве создайте замену в настройках платформы и обновите клиент.

Выбор захваченных данных

Начните с list_products, list_platforms и list_versions. Выберите типы платформ и окружения из list_platforms.options.platforms[], используя возвращённые ID. list_platforms.platforms[] содержит сочетания с реальными захватами. Для инструментов страницы используйте точный сохранённый ключ view из list_pages.views[]. Если версия содержит несколько окружений, явно передайте environment. Контекстные инструменты требуют доступной квоты подписки и расходуют одно чтение при принятии вызова, включая кешированные результаты. Принятый вызов учитывается и при последующей ошибке. Обнаружение, изображения и загрузки ресурсов не расходуют чтения. См. ограничения использования.

Устранение неполадок

Симптом	Проверка
401 Unauthorized	Завершите вход OAuth или проверьте персональный токен; замените истёкший или отозванный.
/authorize возвращает 404	Обновите метаданные подключения и повторите вход; точка авторизации находится под https://reconstruct.dev/sso/realms/reconstruct.
invalid_scope	Запросите openid aud-mcp; Grok Build также может запросить необязательный offline_access.
После входа требуется аутентификация	Обновите сервер и повторите вход OAuth. Удалите конфликтующие вручную заданные bearer-данные.
Несовпадение перенаправления OAuth	Используйте порт обратного вызова из документации клиента. Если ошибка сохраняется, сообщите поддержке URI, показанный клиентом.
Динамическая регистрация клиента отклонена	Выберите автоматическую регистрацию OAuth и повторите через минуту. Клиент должен передать точный HTTPS- или loopback-адрес и поддерживать PKCE S256. Если он не регистрируется сам, используйте заранее заданные параметры из его руководства.
Сервер не подключается	Убедитесь, что https://reconstruct.dev/mcp доступен с машины агента.
Инструменты возвращают отказ в доступе	Войдите в учётную запись Reconstruct и проверьте подписку. Если доступа всё ещё нет, обратитесь в поддержку.
Квота или использование недоступны	Проверьте использование в настройках и страницу состояния. Повторите, когда доступ восстановится.
Захвачено несколько окружений	Передайте environment из list_versions.
Запрошенная платформа/представление недоступны	Используйте захваченные сочетания платформ/окружений и точные ключи list_pages.views[]; поддерживаемые варианты не гарантируют сохранённых данных.
Инструменты не отображаются	Перезапустите агента или обновите его список MCP, затем проверьте состояние сервера.

После подключения попробуйте примеры запросов или изучите каталог инструментов MCP.

Запрос нового захвата или обновления

Сервер MCP включает get_request_options, create_product_request, get_product_request, list_product_requests и wait_product_request. Войдите через OAuth или используйте токен MCP. Подписка должна поддерживать заявки; просматривать можно только отправленные вашей учётной записью. Попросите агента отправить URL нового продукта или обновить известный опубликованный ключ; затем сохранить requestId и ждать изменений статуса рассмотрения. Одобрение не означает готовность захвата. Параметры см. в инструментах заявок.