> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-docs-es/dcal/developers/environment-variables.md).

# Variables de entorno

Cada variable de entorno que lee una instalación propia de dCal, agrupada por área, con su valor por defecto y qué hace: base de datos, páginas de reservas en un host propio, etiquetas de seguimiento,

Una instalación propia de dCal se configura por completo con variables de entorno. Todas tienen un valor por defecto seguro, así que un clon recién descargado y sin nada definido arranca por el camino sin configuración: SQLite, correos escritos en el registro y el inicio de sesión abierto de desarrollo. Nada de esto se aplica a app.dcal.ai, donde estas decisiones ya están tomadas por ti.

La API comprueba sus ajustes al arrancar. Un valor incorrecto la detiene con un mensaje que nombra la variable, en lugar de dejarla funcionando a medias. La fuente de verdad es `packages/config/src/env.ts` en el repositorio, con notas en [`.env.example`](https://github.com/Dapta-Tech/dapta-calendars-slate/blob/main/.env.example) y [`SELF-HOSTING.md`](https://github.com/Dapta-Tech/dapta-calendars-slate/blob/main/SELF-HOSTING.md).

> **⚠️ Nota:** Todo lo que empieza por `NEXT_PUBLIC_` queda fijado en la imagen web al construirla. Cambiar una de esas variables obliga a reconstruir la imagen web, no basta con reiniciar un contenedor. No pongas ningún secreto en una variable `NEXT_PUBLIC_`, porque esas llegan al navegador.

Salvo que una fila diga **web**, la variable la lee la API. Las filas marcadas como **secreto** tienen que venir de tu gestor de secretos, nunca de un archivo guardado en el repositorio.

***

## Básicas

| Nombre                | Por defecto                       | Para qué sirve                                                                                                                                                                                                              |
| --------------------- | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `NODE_ENV`            | `development`                     | Pon `production` en cualquier instalación real. En producción se rechaza el inicio de sesión de desarrollo.                                                                                                                 |
| `DATABASE_URL`        | `file:./.data/dev.db`             | Una dirección `postgres://` elige PostgreSQL; una dirección `file:` elige SQLite, solo para desarrollo. **Secreto**: contiene la contraseña de la base de datos.                                                            |
| `API_PORT`            | `4000`                            | El puerto en el que escucha la API.                                                                                                                                                                                         |
| `PUBLIC_APP_URL`      | `http://localhost:3000`           | Tu dirección web pública. dCal construye con ella los enlaces de gestión, los enlaces al panel de los correos y el origen permitido por defecto en el navegador. También la lee la app **web**.                             |
| `NEXT_PUBLIC_API_URL` | `http://localhost:4000`           | **Web**, al construir. Dónde encuentra el navegador la API.                                                                                                                                                                 |
| `API_URL`             | el valor de `NEXT_PUBLIC_API_URL` | **Web**. La dirección de la API que usa el servidor web. Ponle una dirección privada o interna del clúster. `INTERNAL_API_SECRET` solo tiene efecto si la defines: la app web envía el secreto únicamente a esta dirección. |

***

## Páginas de reservas y etiquetas de seguimiento

| Nombre                    | Por defecto                                                                | Para qué sirve                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PUBLIC_BOOKING_URL`      | sin definir, así que las páginas de reservas se quedan en `PUBLIC_APP_URL` | API y **web**, con el mismo valor en las dos. Un origen propio para las páginas de reservas, personales, de equipo, enlaces de un solo uso y la página donde el invitado gestiona su reserva, como `https://book.tu-dominio.example`. Ese host envía las páginas del panel a `PUBLIC_APP_URL`, y todos los enlaces que escribe dCal lo usan. También abre Google Tag Manager, Google Analytics 4 y HubSpot a todos los workspaces, solo en ese host. Defínela primero en la app web y luego en la API; para revertir, quítala primero de la API. Un valor vacío cuenta como sin definir. Mira [Alojarlo tú mismo](https://docs.dapta.ai/dapta-docs-es/dcal/developers/self-hosting.md#paginas-de-reservas-en-un-host-propio). |
| `BOOKING_HOST_REDIRECTS`  | `off`                                                                      | **Web**. `off`, `temporary` o `permanent`. Con `PUBLIC_BOOKING_URL` definida, `temporary` (307) o `permanent` (308) hace que cualquier otro host responda al `GET` de una página de reservas con una redirección a la misma ruta y los mismos parámetros en el host de reservas. Empieza con `temporary`.                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `EVENT_TRACKING_ACCOUNTS` | sin definir, que significa nadie                                           | Los workspaces cuyas páginas de reservas pueden cargar Google Tag Manager, Google Analytics 4 y HubSpot mientras las páginas de reservas comparten la dirección del panel: códigos cortos de cuenta o enlaces personalizados, separados por comas, o `*` para todos los workspaces. No hace falta cuando `PUBLIC_BOOKING_URL` está definida. El píxel de Meta y PostHog no necesitan nada aquí.                                                                                                                                                                                                                                                                                                                               |

***

## Inicio de sesión

| Nombre                  | Por defecto | Para qué sirve                                                                                                                                                                                                                                                                                                                                                                                                 |
| ----------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AUTH_PROVIDER`         | `local`     | `local` es el inicio de sesión abierto de desarrollo; `workos` verifica tokens HS256 de tu servicio de identidad. Pon el mismo valor en la API y en la app **web**.                                                                                                                                                                                                                                            |
| `JWT_SECRET`            | sin definir | **Secreto**. El secreto compartido con el que tu servicio de identidad firma los tokens. Obligatorio con `AUTH_PROVIDER=workos`.                                                                                                                                                                                                                                                                               |
| `JWT_ISSUER`            | sin definir | Opcional. Si lo defines, los tokens tienen que traer este emisor.                                                                                                                                                                                                                                                                                                                                              |
| `JWT_AUDIENCE`          | sin definir | Opcional. Si lo defines, los tokens tienen que traer esta audiencia.                                                                                                                                                                                                                                                                                                                                           |
| `WEB_SESSION_SECRET`    | sin definir | **Web**, **secreto**. Firma la cookie de sesión. Obligatorio con cualquier proveedor distinto de `local`.                                                                                                                                                                                                                                                                                                      |
| `IAM_BASE_URL`          | sin definir | **Web**. El servicio de identidad por el que pasa el inicio de sesión de la app web con `AUTH_PROVIDER=workos`.                                                                                                                                                                                                                                                                                                |
| `OPERATOR_EMAIL_DOMAIN` | sin definir | API y **web**. El dominio de correo de tu propio equipo, como `@tu-empresa.example`, si operas dCal para los workspaces de otras personas. Quien venga de ese dominio entra a un workspace de un cliente como administrador y ve un selector de cuentas arriba del menú de la izquierda, debajo del selector de workspaces cuando también pertenece a varios workspaces. Si no es tu caso, déjalo sin definir. |
| `DEV_LOGIN_EMAIL`       | sin definir | Solo desarrollo. La persona con la que entra el inicio de sesión `local`.                                                                                                                                                                                                                                                                                                                                      |
| `AUTH_LOCAL_STRICT`     | `false`     | Solo desarrollo. Da al inicio de sesión `local` un estado real de sesión cerrada.                                                                                                                                                                                                                                                                                                                              |

***

## Calendario

| Nombre                              | Por defecto | Para qué sirve                                                                                                                                                                                                                                                                                                                                                                                           |
| ----------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `CALENDAR_PROVIDER`                 | `disabled`  | `disabled`: sin sincronización de calendarios, los horarios libres solo descuentan las reservas de dCal. `external`: habla con un backend de calendario.                                                                                                                                                                                                                                                 |
| `CALENDAR_API_BASE_URL`             | sin definir | La dirección de tu backend de calendario, para el contrato REST incluido.                                                                                                                                                                                                                                                                                                                                |
| `CALENDAR_API_TOKEN`                | sin definir | **Secreto**. El token Bearer de ese backend.                                                                                                                                                                                                                                                                                                                                                             |
| `CALENDAR_BACKEND_FEATURES`         | Sin definir | Capacidades del backend genérico de calendario, separadas por comas: `recurrence` y `attendee-free-busy`. Declara solo lo que soporte tu adaptador. Sin ellas se rechazan series y los calendarios de asistentes quedan desconocidos. Mira [Eventos repetidos y consulta de asistentes](https://docs.dapta.ai/dapta-docs-es/dcal/developers/self-hosting.md#eventos-repetidos-y-consulta-de-asistentes). |
| `CALENDAR_BACKEND_MODULE`           | sin definir | La ruta absoluta a tu propio módulo de backend, en lugar de las dos anteriores.                                                                                                                                                                                                                                                                                                                          |
| `CALENDAR_HTTP_TIMEOUT_MS`          | `30000`     | Cuánto puede tardar una petición al calendario.                                                                                                                                                                                                                                                                                                                                                          |
| `CALENDAR_BUSY_REQUESTS_PER_SECOND` | `4`         | Cuántas peticiones de horas ocupadas puede iniciar un proceso de la API por segundo para un anfitrión. Con varias copias de la API, reparte este valor entre ellas.                                                                                                                                                                                                                                      |
| `CALENDAR_BUSY_WINDOW_DAYS`         | `14`        | El tramo más largo de una petición de horas ocupadas, de 1 a 90 días. Súbelo solo si tu backend responde con una consulta de disponibilidad (free/busy), que está completa para cualquier tramo.                                                                                                                                                                                                         |
| `CALENDAR_CONFERENCING_LABEL`       | sin definir | El nombre de la plataforma de reuniones para la que tu backend crea enlaces, hasta 60 caracteres. Los anfitriones lo ven en lugar de "Reunión en línea".                                                                                                                                                                                                                                                 |
| `CALENDAR_BUSY_CACHE_TTL_MS`        | `30000`     | Cuánto tiempo comparten todos los visitantes de las páginas que muestran horarios una misma lectura de las horas ocupadas de un calendario, de 0 a 600000 ms. `0` apaga ese uso compartido. Apartar, reservar, mover y confirmar siempre leen en el momento.                                                                                                                                             |
| `CALENDAR_BUSY_CACHE_MAX_STALE_MS`  | `300000`    | Qué antigüedad puede tener la última lectura buena para usarse cuando falla una lectura nueva, de 0 a 3600000 ms. Si es más vieja, no se ofrecen horarios.                                                                                                                                                                                                                                               |
| `CALENDAR_BUSY_CACHE_MAX_ENTRIES`   | `1000`      | Cuántas lecturas guarda un proceso de la API, de 1 a 100000. Las menos usadas salen primero.                                                                                                                                                                                                                                                                                                             |
| `CALENDAR_BUSY_READ_TIMEOUT_MS`     | `10000`     | Cuánto espera una página a un calendario lento antes de usar la última lectura buena o decir que no se puede leer el calendario, de 1000 a 120000 ms.                                                                                                                                                                                                                                                    |

***

## Correo

| Nombre                      | Por defecto            | Para qué sirve                                                                                                                                                                                                                                                      |
| --------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `EMAIL_PROVIDER`            | `log-only`             | `log-only` imprime los correos en el registro, `noop` los descarta, `smtp` y `http` los envían.                                                                                                                                                                     |
| `MAIL_FROM_EMAIL`           | `bookings@example.com` | La dirección del remitente. Cámbiala antes de enviar nada real.                                                                                                                                                                                                     |
| `MAIL_FROM_NAME`            | `Calendars`            | El nombre del remitente que se ve en la bandeja de entrada.                                                                                                                                                                                                         |
| `MAIL_SUPPORT_EMAIL`        | sin definir            | Una dirección de soporte que se muestra en el pie de los correos. Sin definir, no hay línea de soporte. Con el perfil `transactional-v1`, el servicio de correo añade su propio pie de soporte en el idioma de cada destinatario, así que dCal deja fuera su línea. |
| `SMTP_HOST`                 | sin definir            | Tu servidor SMTP, para `EMAIL_PROVIDER=smtp`.                                                                                                                                                                                                                       |
| `SMTP_PORT`                 | `587`                  | El puerto SMTP.                                                                                                                                                                                                                                                     |
| `SMTP_SECURE`               | `false`                | Si la conexión usa TLS desde el inicio.                                                                                                                                                                                                                             |
| `SMTP_USER`                 | sin definir            | El usuario SMTP, si tu servidor lo pide.                                                                                                                                                                                                                            |
| `SMTP_PASS`                 | sin definir            | **Secreto**. La contraseña SMTP.                                                                                                                                                                                                                                    |
| `EMAIL_HTTP_ENDPOINT`       | sin definir            | La dirección de envío de tu servicio de correo HTTP, para `EMAIL_PROVIDER=http`.                                                                                                                                                                                    |
| `EMAIL_HTTP_PROFILE`        | `generic`              | `generic`: un cuerpo JSON que sirve con cualquier proveedor. `transactional-v1`: un contrato gestionado con peticiones firmadas.                                                                                                                                    |
| `EMAIL_HTTP_TOKEN`          | sin definir            | **Secreto**. El token Bearer del perfil `generic`.                                                                                                                                                                                                                  |
| `EMAIL_HTTP_CLIENT_ID`      | sin definir            | El ID de cliente del perfil `transactional-v1`.                                                                                                                                                                                                                     |
| `EMAIL_HTTP_SIGNING_SECRET` | sin definir            | **Secreto**, de al menos 32 caracteres. Firma las peticiones `transactional-v1`; nunca se envía.                                                                                                                                                                    |
| `EMAIL_HTTP_CATEGORY`       | `lifecycle`            | La categoría de los mensajes en `transactional-v1`.                                                                                                                                                                                                                 |
| `EMAIL_HTTP_API_KEY`        | sin definir            | **Secreto**. Respaldo antiguo para `transactional-v1`; usa en su lugar el ID de cliente y el secreto de firma.                                                                                                                                                      |

***

## HubSpot y webhooks

| Nombre                       | Por defecto                               | Para qué sirve                                                                                                                                                                                                                                                                                                           |
| ---------------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `CRM_PROVIDER`               | `disabled`                                | Pon `hubspot` para ofrecer la integración con HubSpot en **Ajustes** > **Integraciones**.                                                                                                                                                                                                                                |
| `INTEGRATION_ENCRYPTION_KEY` | sin definir                               | **Secreto**. 32 bytes aleatorios en base64 (`openssl rand -base64 32`). Cifra los tokens de HubSpot guardados y los secretos de firma de los webhooks. Sin ella, conectar HubSpot y crear un webhook se rechazan. Respáldala: perderla obliga a usar tokens nuevos y secretos de webhook nuevos en todos los workspaces. |
| `HUBSPOT_PRIVATE_APP_TOKEN`  | sin definir                               | **Secreto**. Un token de HubSpot para toda la instalación, que solo usan los workspaces que no conectaron el suyo.                                                                                                                                                                                                       |
| `CRM_HTTP_TIMEOUT_MS`        | `10000`                                   | Cuánto puede tardar una petición a HubSpot.                                                                                                                                                                                                                                                                              |
| `CRM_API_BASE_URL`           | la dirección pública de la API de HubSpot | Adónde van las peticiones a HubSpot. Cámbiala solo para pasarlas por un proxy o un servicio de prueba.                                                                                                                                                                                                                   |

***

## Entregas en segundo plano

Los webhooks, la escritura en calendarios, la escritura en HubSpot y los correos pasan por una cola duradera que vacía un proceso en segundo plano, así que ninguno puede frenar ni hacer fallar una reserva. Cada tipo se vacía por su cuenta, las entregas de una misma reserva salen en orden, y varias copias de la API pueden compartir una cola sin entregar nada dos veces.

| Nombre                    | Por defecto           | Para qué sirve                                                                                                                                                                                                                                                                       |
| ------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `OUTBOX_WORKER_ENABLED`   | `true`                | Ponlo en `false` solo si otro proceso vacía la cola. También apaga la ampliación del horizonte de eventos repetidos; déjalo activo en un proceso que mantenga las series.                                                                                                            |
| `OUTBOX_POLL_MS`          | `5000`                | Cada cuánto revisa la cola el proceso, en milisegundos.                                                                                                                                                                                                                              |
| `OUTBOX_MAX_ATTEMPTS`     | `5`                   | La menor cantidad de intentos que recibe una entrega fallida antes de que se pueda abandonar.                                                                                                                                                                                        |
| `OUTBOX_RETRY_HORIZON_MS` | `86400000` (24 horas) | Cuánto tiempo se sigue reintentando una entrega fallida, contado desde su primer fallo, hasta 30 días. Solo se abandona después de cumplir esto y `OUTBOX_MAX_ATTEMPTS`. `0` la abandona en cuanto se agotan los intentos. Los eventos de analítica del producto nunca esperan esto. |
| `OUTBOX_CONCURRENCY`      | `4`                   | Entregas en curso a la vez por tipo de trabajo, por proceso de la API, de 1 a 64. Un endpoint de webhook lento ocupa como máximo una.                                                                                                                                                |
| `OUTBOX_LEASE_MS`         | `300000`              | Cuánto tiempo pertenece una entrega tomada al proceso de la API que la tomó, de 10000 a 3600000 ms. Si ese proceso se detiene, otro toma la entrega después de este tiempo. Ponlo por encima de lo que tarda tu entrega más lenta.                                                   |

***

## Tráfico, proxies y navegadores

| Nombre                          | Por defecto                                       | Para qué sirve                                                                                                                                                                                                    |
| ------------------------------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `CORS_ORIGINS`                  | sin definir, lo que permite solo `PUBLIC_APP_URL` | Una lista separada por comas de los sitios web que pueden llamar a la API desde un navegador. Si la defines, reemplaza el valor por defecto, así que incluye tu propia dirección web en la lista.                 |
| `RATE_LIMIT_ENABLED`            | `true`                                            | Limita por visitante las peticiones a los endpoints públicos de reserva.                                                                                                                                          |
| `RATE_LIMIT_CAPACITY`           | `60`                                              | La ráfaga permitida por visitante.                                                                                                                                                                                |
| `RATE_LIMIT_REFILL_PER_SEC`     | `1`                                               | A qué velocidad se recarga esa ráfaga, por segundo.                                                                                                                                                               |
| `RATE_LIMIT_TRUSTED_PROXY_HOPS` | `1`                                               | Cuántos proxies hay delante de la API, de 0 a 10: `1` para un balanceador de carga, `2` para una CDN delante de él, `0` sin proxy. Ponlo también en la app **web** si usas `INTERNAL_API_SECRET`.                 |
| `INTERNAL_API_SECRET`           | sin definir                                       | API y **web**, **secreto**, el mismo valor en las dos, de al menos 32 caracteres. Permite que las páginas de reservas le pasen a la API la dirección de cada visitante, para que cada uno tenga su propio límite. |
| `REQUEST_LOG_ENABLED`           | `true`                                            | Una línea de registro por petición: método, ruta, estado, duración, ID de la petición, código de error y workspace. Nunca parámetros de la URL, cuerpos, cabeceras ni direcciones de los clientes.                |

***

## Servidor MCP

El servidor MCP permite que los asistentes de IA agenden en tu copia. En app.dcal.ai, el servidor MCP de dCal está en `https://mcp.dcal.ai/mcp`, y te conectas iniciando sesión o con una clave de API. Mira [Conecta un asistente de IA (MCP)](https://docs.dapta.ai/dapta-docs-es/dcal/developers/mcp-server.md).

| Nombre                                | Por defecto                                                  | Para qué sirve                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MCP_ENABLED`                         | `true`                                                       | `false` hace que `/mcp` responda `404`. Si está encendido, las herramientas de las páginas de reservas públicas responden a cualquiera; las demás responden a claves de API y, cuando el inicio de sesión para apps de IA está encendido, también a inicios de sesión.                                                                                                                                                                                                                                                                                                                                    |
| `MCP_PUBLIC_URL`                      | sin definir                                                  | API y **web**. La dirección completa que la gente pega en un asistente, con la ruta incluida, por ejemplo `https://api.tu-dominio.example/mcp`. **Conecta tu agente** la muestra, y solo muestra sus pasos cuando está definida. Con el inicio de sesión para apps de IA encendido, también es la dirección para la que se emite cada token de acceso.                                                                                                                                                                                                                                                    |
| `API_PUBLIC_URL`                      | sin definir, y entonces `MCP_PUBLIC_URL` sin su `/mcp` final | API y **web**. La dirección pública de la API. El elemento **Docs de la API** del menú de la izquierda abre su `/docs`, y el skill para agentes de **Claves API** se arma con ella. En producción, sin ninguna de las dos, el menú no tiene **Docs de la API** y **Claves API** dice que el skill no está disponible. En la API, `/openapi.json` y la introducción de la referencia de la API en `/docs` la nombran como URL base, y la introducción enlaza con ella al documento OpenAPI. Sin definir en la API, las dos quedan relativas a donde se sirva la API: la API no recurre a `MCP_PUBLIC_URL`. |
| `MCP_ALLOWED_ORIGINS`                 | sin definir, lo que no permite ningún origen de navegador    | Orígenes de navegador, separados por comas, que pueden llamar a `/mcp`. Una petición con cualquier otra cabecera `Origin` se rechaza con `403`; los clientes que no envían `Origin` no se ven afectados.                                                                                                                                                                                                                                                                                                                                                                                                  |
| `MCP_ALLOWED_HOSTS`                   | sin definir, sin revisión                                    | Nombres de host, separados por comas, a los que responde `/mcp`. Defínelo cuando la API sea accesible con nombres que no controlas.                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `MCP_RATE_LIMIT_CAPACITY`             | `30`                                                         | Ráfaga de llamadas a herramientas de lectura por clave, por inicio de sesión, o por dirección sin ninguno de los dos. Un inicio de sesión que todavía no llega a ningún workspace se cuenta por dirección.                                                                                                                                                                                                                                                                                                                                                                                                |
| `MCP_RATE_LIMIT_REFILL_PER_SEC`       | `1`                                                          | A qué velocidad se recarga esa ráfaga, por segundo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `MCP_WRITE_RATE_LIMIT_CAPACITY`       | `10`                                                         | Ráfaga de llamadas a las herramientas que escriben (reservar, apartar, mover, confirmar, rechazar, cancelar) por clave, por inicio de sesión, o por dirección.                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `MCP_WRITE_RATE_LIMIT_REFILL_PER_SEC` | `0.2`                                                        | A qué velocidad se recarga esa ráfaga, por segundo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `MCP_TOOL_TIMEOUT_MS`                 | `20000`                                                      | Cuánto puede durar una llamada a una herramienta antes de abandonarse, de 1000 a 120000 ms.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |

***

## Inicio de sesión para apps de IA (OAuth)

Permite que la gente conecte apps como Claude o ChatGPT al servidor MCP iniciando sesión, en lugar de pegar una clave. Viene apagado y funciona de una de dos formas:

* **Con un servidor de autorización que ya tienes**, como funciona app.dcal.ai: define `OAUTH_ENABLED=true`, `MCP_PUBLIC_URL` y `OAUTH_AUTHORIZATION_SERVER`. Ese servidor se encarga del inicio de sesión y del consentimiento; dCal solo revisa sus tokens. Mira [Alojarlo tú mismo](https://docs.dapta.ai/dapta-docs-es/dcal/developers/self-hosting.md#asistentes-de-ia-analitica-y-buscadores) para saber qué debe admitir ese servidor.
* **Con el servidor de autorización incluido**: define `OAUTH_ENABLED=true`, `MCP_PUBLIC_URL`, `OAUTH_ISSUER` y `OAUTH_SIGNING_JWK`. dCal hace el inicio de sesión, la gente aprueba cada app en una página de consentimiento, y **Claves API** lista las apps conectadas.

En los dos casos, `MCP_ENABLED` debe seguir en `true`. La API se niega a arrancar cuando falta o está mal escrito un valor que necesita la forma elegida, y dice cuál.

| Nombre                              | Por defecto                                                                              | Para qué sirve                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------------------- | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `OAUTH_ENABLED`                     | `false`                                                                                  | Enciende el inicio de sesión para apps de IA.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `OAUTH_AUTHORIZATION_SERVER`        | sin definir                                                                              | Solo con tu propio servidor de autorización. Su emisor, como un origen simple: `https://`, sin ruta y sin barra final, escrito exactamente como lo escriben sus tokens (`http://` solo en localhost fuera de producción). Si está definido, dCal no ejecuta un servidor de autorización propio, y no hacen falta `OAUTH_ISSUER` ni `OAUTH_SIGNING_JWK`.                                                                                                                                                                                               |
| `OAUTH_JWKS_URL`                    | el `jwks_uri` de los metadatos `/.well-known/oauth-authorization-server` de ese servidor | Solo con tu propio servidor de autorización. Dónde publica sus claves de firma.                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `OAUTH_LINK_MAX_AGE_DAYS`           | `30`                                                                                     | Solo con tu propio servidor de autorización, de 1 a 365 días. Cuánto tiempo después del último inicio de sesión de una persona en la app web, en un workspace, puede seguir actuando ahí un inicio de sesión desde una app de IA. Pasado ese plazo, el inicio de sesión deja de llegar a ese workspace hasta que la persona vuelva a abrir dCal en la web ahí, y un inicio de sesión que no llega a ningún workspace recibe `NOT_LINKED` de las herramientas; no hace falta reconectar. Iguálalo a la duración de sesión de tu servicio de identidad. |
| `OAUTH_ISSUER`                      | sin definir                                                                              | Solo con el servidor incluido. Tu origen público que sirve `/oauth/...` y `/.well-known/oauth-authorization-server`, solo esquema y host, con `https://`. No lo cambies nunca una vez que haya apps conectadas.                                                                                                                                                                                                                                                                                                                                       |
| `OAUTH_SIGNING_JWK`                 | sin definir                                                                              | Solo con el servidor incluido. **Secreto**. La clave privada que firma los tokens de acceso: una clave EC P-256 en formato JSON Web Key, con su parte privada. Todas las copias de la API usan la misma.                                                                                                                                                                                                                                                                                                                                              |
| `OAUTH_ACCESS_TOKEN_TTL_SECONDS`    | `3600`                                                                                   | Solo con el servidor incluido. Cuánto dura un token de acceso, de 60 a 86400 segundos. Una app desconectada sigue funcionando hasta que vence su último token.                                                                                                                                                                                                                                                                                                                                                                                        |
| `OAUTH_GRANT_TTL_DAYS`              | `90`                                                                                     | Solo con el servidor incluido. Cuánto dura una conexión antes de que la persona deba conectarse de nuevo, de 1 a 365 días. Renovar nunca la alarga.                                                                                                                                                                                                                                                                                                                                                                                                   |
| `OAUTH_REFRESH_REUSE_GRACE_SECONDS` | `10`                                                                                     | Solo con el servidor incluido. Un token de renovación ya usado que vuelve a llegar dentro de estos segundos cuenta como un reintento; después, termina toda la conexión. De 0 a 60, `0` es estricto.                                                                                                                                                                                                                                                                                                                                                  |
| `OAUTH_CIMD_ENABLED`                | `true`                                                                                   | Solo con el servidor incluido. Permite que las apps se identifiquen con una dirección `https` que dCal lee (un documento de metadatos del cliente).                                                                                                                                                                                                                                                                                                                                                                                                   |
| `OAUTH_DCR_ENABLED`                 | `true`                                                                                   | Solo con el servidor incluido. Permite que las apps se registren solas en `/oauth/register`, limitado a una lista fija de direcciones de retorno.                                                                                                                                                                                                                                                                                                                                                                                                     |
| `OAUTH_DCR_EXTRA_REDIRECT_URIS`     | sin definir                                                                              | Solo con el servidor incluido. Direcciones de retorno exactas, separadas por comas, que se suman a esa lista, para una app de confianza que no está en ella.                                                                                                                                                                                                                                                                                                                                                                                          |

***

## Analítica del producto

Apagada salvo que definas un proveedor y su clave. La API y la app **web** leen los mismos nombres al ejecutarse, así que no hace falta reconstruir. Mira [Seguridad y privacidad](https://docs.dapta.ai/dapta-docs-es/dcal/security-and-privacy.md) para saber qué se registra.

| Nombre                              | Por defecto                | Para qué sirve                                                                                                                     |
| ----------------------------------- | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `PRODUCT_ANALYTICS_PROVIDER`        | sin definir                | `posthog` es el único proveedor incluido. Cualquier otro valor deja la analítica apagada.                                          |
| `PRODUCT_ANALYTICS_KEY`             | sin definir                | La clave de solo escritura del proyecto. Una clave personal de lectura (`phx_...`) se rechaza.                                     |
| `PRODUCT_ANALYTICS_HOST`            | `https://us.i.posthog.com` | Adónde se envían los eventos, por ejemplo tu propio proxy.                                                                         |
| `PRODUCT_ANALYTICS_INTERNAL_EMAILS` | sin definir                | Partes de direcciones de correo, separadas por comas, que marcan a tu propio equipo, para dejar sus eventos fuera de los reportes. |

***

## Buscadores

| Nombre    | Por defecto | Para qué sirve                                                                                                                                                                                                                                                                                                                                      |
| --------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `NOINDEX` | sin definir | **Web**, se lee al ejecutarse. Pon `1`, `true` o `yes` en una copia de pruebas o de vista previa: cada respuesta dice entonces `noindex, nofollow` y `robots.txt` cierra todo el sitio. Sin definir, `robots.txt` deja que los buscadores lean tus páginas de reservas y los mantiene fuera de `/admin`, `/login`, `/onboarding`, `/api` y `/auth`. |

***

## Extras premium

dCal es gratis. El interruptor de premium existe para que una instalación pueda poner sus propios derechos de uso delante de los dos extras: ocultar la marca de Dapta y el enlace personalizado.

| Nombre                 | Por defecto | Para qué sirve                                                                                                                                               |
| ---------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `PREMIUM_FEATURES`     | `open`      | `open` desbloquea los dos extras para todos, que es lo que quiere una copia propia. `locked` comprueba cada workspace contra un servicio de derechos de uso. |
| `ENTITLEMENTS_API_URL` | sin definir | El servicio de derechos de uso. Solo con `PREMIUM_FEATURES=locked`.                                                                                          |
| `ENTITLEMENTS_API_KEY` | sin definir | **Secreto**. Su credencial. Solo con `PREMIUM_FEATURES=locked`.                                                                                              |

***

## Nombre del producto y marca

| Nombre                     | Por defecto                              | Para qué sirve                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| -------------------------- | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `NEXT_PUBLIC_PRODUCT_NAME` | `Calendars`                              | **Web**, al construir. El nombre del producto que se ve en el panel y en las pestañas del navegador. Una copia con su propio nombre muestra una letra neutra junto a ese nombre en lugar del logo de Dapta.                                                                                                                                                                                                                                                                                                                                                                      |
| `PRODUCT_NAME`             | sin definir, y entonces `MAIL_FROM_NAME` | El nombre del producto en la línea "Hecho con" de los correos a tus invitados y en el título de la referencia de la API en `/docs` y de `openapi.json`, que dicen `<nombre> API`.                                                                                                                                                                                                                                                                                                                                                                                                |
| `NEXT_PUBLIC_PLATFORM_URL` | sin definir                              | **Web**, al construir. Añade un elemento **Dapta Agents** al final del menú de la izquierda y el selector de productos, los dos con un enlace a esta dirección en una pestaña nueva.                                                                                                                                                                                                                                                                                                                                                                                             |
| `NEXT_PUBLIC_FORMS_URL`    | sin definir                              | **Web**, al construir. También muestra el selector de productos, y convierte su fila de Forms en un enlace a esta dirección. Sin definir, la fila dice **Próximamente**.                                                                                                                                                                                                                                                                                                                                                                                                         |
| `NEXT_PUBLIC_SIGNUP_URL`   | sin definir                              | **Web**, al construir. Si está definida, las páginas públicas muestran la insignia "Hecho con" y una invitación a registrarse que enlaza aquí: tu página de registro, o el sitio de tu producto cuando su propio llamado a la acción lleva al registro. Sin definir, no aparece ninguna de las dos.                                                                                                                                                                                                                                                                              |
| `SIGNUP_URL`               | el valor de `NEXT_PUBLIC_SIGNUP_URL`     | El mismo enlace para el pie de los correos a tus invitados, si la API necesita otro valor.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `NEXT_PUBLIC_HIDE_BADGE`   | sin definir                              | **Web**, al construir. Pon `1`, `true` o `yes` para ocultar la insignia y la invitación aunque haya un enlace de registro.                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `HIDE_BADGE`               | el valor de `NEXT_PUBLIC_HIDE_BADGE`     | El mismo interruptor para los correos a tus invitados.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `DOCS_URL`                 | sin definir                              | **Web**, se lee en cada petición, así que no hace falta volver a construir. Añade al menú de la izquierda un elemento **Documentación** que abre esta dirección en una pestaña nueva. Cualquier valor que no sea una dirección `http` o `https` cuenta como sin definir, y sin definir no aparece el elemento.                                                                                                                                                                                                                                                                   |
| `DOCS_URL_ES`              | el valor de `DOCS_URL`                   | **Web**, se lee en cada petición. El enlace de **Documentación** para quienes usan el panel en español.                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `DEVELOPER_DOCS_URL`       | sin definir                              | Dónde están tus guías para desarrolladores, por ejemplo `https://docs.tu-dominio.example/developers`. La introducción de la referencia de la API en `/docs`, que también va en `openapi.json`, termina con un enlace "developer docs" a esta dirección. Solo cuenta una dirección `http` o `https` sin credenciales, consulta ni fragmento; cualquier otro valor cuenta como sin definir, y sin definir no hay enlace a las guías. En app.dcal.ai apunta a la versión en inglés de [estas páginas para desarrolladores](https://docs.dapta.ai/dapta-docs-es/dcal/developers.md). |

***

## Integraciones del operador

Estas variables conectan una instalación con el embudo de registro de quien la opera. **Déjalas todas sin definir en una copia propia**: sin nada definido, no se pregunta nada y no se envía nada a ningún lugar.

| Nombre                        | Por defecto | Para qué sirve                                                                                                             |
| ----------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------- |
| `ONBOARDING_IAM_BASE_URL`     | sin definir | Activa preguntas adicionales para los nuevos registros, contrastadas con un servicio de identidad. Sin definir, se omiten. |
| `ONBOARDING_IAM_TOKEN`        | sin definir | **Secreto**. Token Bearer de ese servicio.                                                                                 |
| `ONBOARDING_PROBE_TIMEOUT_MS` | `1500`      | Cuánto esperar a ese servicio.                                                                                             |
| `DAPTA_SYNC_URL`              | sin definir | Adónde se envían los nuevos registros como contactos, para el CRM propio del operador. Sin definir, no se envía nada.      |
| `DAPTA_SYNC_TOKEN`            | sin definir | **Secreto**. Token Bearer de esa dirección.                                                                                |
| `DAPTA_SYNC_TIMEOUT_MS`       | `5000`      | Cuánto esperar a esa dirección.                                                                                            |

## Relacionado

* [Alojarlo tú mismo](https://docs.dapta.ai/dapta-docs-es/dcal/developers/self-hosting.md): requisitos, base de datos, inicio rápido y las opciones detrás de estos ajustes.
* [Conecta un asistente de IA (MCP)](https://docs.dapta.ai/dapta-docs-es/dcal/developers/mcp-server.md): lo que encienden los ajustes de MCP de arriba.
* [API REST](https://docs.dapta.ai/dapta-docs-es/dcal/developers/rest-api.md): lo que protegen los ajustes de límite de uso.
* [HubSpot](https://docs.dapta.ai/dapta-docs-es/dcal/integrations/hubspot.md) y [Webhooks](https://docs.dapta.ai/dapta-docs-es/dcal/integrations/webhooks.md): lo que activan `CRM_PROVIDER` e `INTEGRATION_ENCRYPTION_KEY`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dapta.ai/dapta-docs-es/dcal/developers/environment-variables.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
