# Подключиться к облачной среде выполнения

Возвращает данные подключения к запущенной облачной среде выполнения.
- **Предварительные условия**: среда должна находиться строго в состоянии `RUNNING` и должна быть запущена вами. Среда, которая останавливается или архивируется, отклоняется, даже если `/cloudbrowser/page` по-прежнему сообщает `RUNNING`.
- **Эффект**: выпускает новый токен доступа к рабочему столу и записывает вас как подключённого участника.
- **Повторные вызовы**: возвращаемый `cdpUrl` стабилен, существующие CDP-сессии продолжают работать, но каждый вызов выпускает новый токен рабочего стола и перезаписывает записанного подключённого участника. **Прежние URL рабочего стола не отзываются**, поэтому считайте каждый возвращённый URL действующим секретом: не пишите его в логи и не сохраняйте.
- **Ограничение сессии**: среда автоматически останавливается по достижении максимальной длительности, а архивация начинается незадолго до этого, поэтому долгоживущая автоматизация должна корректно переживать исчезновение среды.
- **Применение**: подключите Puppeteer, Playwright или Selenium к `cdpUrl`.

Задокументированные бизнес-ошибки: `40008`, `40009`, `40010`. Значения кодов см. в [Error Codes](../Getting%20Started/error-codes.md). Любая операция может дополнительно вернуть общие коды.

Endpoint: POST /api/cloudbrowser/connect
Version: 2026-09-05

## Request fields (application/json):

  - `envId` (string, required)
    Browser profile (environment) ID. Serialized as a decimal string to avoid JavaScript
precision loss on 64-bit integers.
    Example: 1800000000000001

## Response 200:

  - `200` (unknown)
    Success

## Response 200 fields (application/json):

  - `code` (integer, required)
    Return result code. `0` means success; other codes indicate exceptions.
    Example: 0

  - `msg` (string | null, required)
    Error message. Usually `null` on success.
    Example: null

  - `requestId` (string)
    Operation request ID. This field may be present when the request passes through the API gateway.
    Example: 1d4f3ea968664593860b94b35d4ebf5e

  - `data` (object, required)

  - `data.cdpUrl` (string, required)
    Full CDP (Chrome DevTools Protocol) address including the access `token` parameter. Pass this
URL to an automation framework such as Puppeteer, Playwright, or Selenium to attach to the
remote browser.
    Example: https://runtime1.morelogin.com:16167?token=c62fedaaac524e41a0f02fc4345d41cb

  - `data.accessUrl` (string | null)
    Cloud browser page wrapper address. Open it in a browser to view and control the cloud
browser desktop. `null` when the page wrapper is not configured.
The `token` parameter is a Base64-encoded payload carrying the desktop URL, desktop token,
expiry, and team, user, member, and environment IDs. The `envName` and `lang` parameters set
the displayed environment name and interface language.
    Example: https://official-website.morelogin.com/browser-remote?token=eyJkZXNrdG9wVXJsIjoi...ZW52SWQiOiIyMDczMzk1NDg5NzM4OTE5OTM2In0%3D&envName=P-1267&lang=en-US