# Conectar con el entorno de ejecución en la nube

Devuelve los datos de conexión de un runtime en la nube que está en ejecución.
- **Requisitos previos**: el runtime debe estar exactamente en estado `RUNNING` y lo debes haber iniciado tú. Un runtime que se está deteniendo o archivando se rechaza aunque `/cloudbrowser/page` siga informando `RUNNING`.
- **Efecto**: emite un token de acceso al escritorio nuevo y te registra como el miembro conectado.
- **Llamadas repetidas**: el `cdpUrl` devuelto es estable y las sesiones CDP existentes siguen funcionando, pero cada llamada emite un token de escritorio nuevo y sobrescribe el miembro conectado registrado. **Las URL de escritorio anteriores no se revocan**, así que trata cada URL devuelta como una credencial activa: no las registres en logs ni las persistas.
- **Límite de sesión**: el runtime se detiene automáticamente al alcanzar su duración máxima, y el archivado empieza algo antes, por lo que una automatización de larga duración debe contemplar que el runtime desaparezca.
- **Uso**: conecta Puppeteer, Playwright o Selenium a `cdpUrl`.

Errores de negocio documentados: `40008`, `40009`, `40010`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para el significado de cada código. Cualquier operación puede devolver además los códigos comunes.

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