# Подключение AI-агента {/* #connect-an-ai-agent */}

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

- [Codex](/docs/ru/agents/codex)
- [Claude](/docs/ru/agents/claude)
- [Cursor](/docs/ru/agents/cursor)
- [Cline](/docs/ru/agents/cline)
- [GitHub Copilot в VS Code](/docs/ru/agents/vscode-copilot)
- [Gemini CLI](/docs/ru/agents/gemini-cli)
- [MiMo](/docs/ru/agents/mimo)
- [Muse Code](/docs/ru/agents/muse-code)
- [Grok Build](/docs/ru/agents/grok-build)
- [Hermes Agent](/docs/ru/agents/hermes)
- [OpenClaw](/docs/ru/agents/openclaw)
- [OpenMausBot](/docs/ru/agents/openmausbot)
- [Другие клиенты MCP](/docs/ru/agents/other-mcp-clients)

## Перед началом {/* #before-you-start */}

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

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

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

## Вход через браузер по OAuth {/* #oauth-browser-sign-in */}

Перед подключением по 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](/docs/ru/agents/codex#oauth-browser-sign-in), [Claude Code](/docs/ru/agents/claude-code#oauth-browser-sign-in), [Cursor](/docs/ru/agents/cursor#oauth-browser-sign-in), [Cline](/docs/ru/agents/cline#oauth-browser-sign-in), [OpenMausBot](/docs/ru/agents/openmausbot#oauth-browser-sign-in) или [другого клиента MCP](/docs/ru/agents/other-mcp-clients#oauth-browser-sign-in). Используйте адреса обратного вызова из руководства клиента. Если клиент просит войти снова, повторите его процесс входа MCP.

### Совместимость клиентов {/* #client-compatibility */}

Примеры входа в браузере охватывают 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](/docs/ru/agents/claude-desktop). Перед подключением другой облачной интеграции передайте поддержке точный URI обратного вызова. Для `reconstruct-mcp` секрет клиента не вводится.

## Обнаружение агентов и вход по устройству {/* #agent-discovery-and-device-sign-in */}

Публичное обнаружение начинается с `https://reconstruct.dev/mcp/server-card`. Корневой `/.well-known/api-catalog` перечисляет публичную документацию API, а `/.well-known/agent-skills/index.json` — процессы Reconstruct и их установочные архивы. Девять процессов, чтение ресурсов MCP без отдельной установки, установка с сайта или GitHub CLI, ручные загрузки и клиентские пакеты плагинов описаны в [Навыках Reconstruct](/docs/ru/skills). Для подключения к удалённому 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.

## Персональный токен доступа {/* #personal-access-token */}

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

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

## Выбор захваченных данных {/* #select-captured-data */}

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

## Устранение неполадок {/* #troubleshooting */}

| Симптом | Проверка |
|---|---|
| `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, затем проверьте состояние сервера. |

После подключения попробуйте [примеры запросов](/docs/ru/prompt-examples) или изучите [каталог инструментов MCP](/docs/ru/mcp-tools).

### Запрос нового захвата или обновления {/* #request-a-new-capture-or-update */}

Сервер MCP включает `get_request_options`, `create_product_request`, `get_product_request`, `list_product_requests` и `wait_product_request`. Войдите через OAuth или используйте токен MCP. Подписка должна поддерживать заявки; просматривать можно только отправленные вашей учётной записью. Попросите агента отправить URL нового продукта или обновить известный опубликованный ключ; затем сохранить `requestId` и ждать изменений статуса рассмотрения. Одобрение не означает готовность захвата. Параметры см. в [инструментах заявок](/docs/ru/mcp-tools#product-requests).