> 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.md).

# Desarrolladores

dCal es de código abierto bajo licencia MIT. Conecta tus propios sistemas con claves de API, la API REST, la API compatible con Cal.com y webhooks, o ejecuta tu propia copia de dCal en tus servidores.

Todo el resto de esta documentación describe [app.dcal.ai](https://app.dcal.ai), el dCal alojado: gratis, sin nada que instalar, con tu cuenta de Dapta. Esta sección es para otros dos caminos: conectar tus propios sistemas a dCal y ejecutar tu propia copia.

dCal es **de código abierto bajo licencia MIT**. El código completo está en [github.com/Dapta-Tech/dapta-calendars-slate](https://github.com/Dapta-Tech/dapta-calendars-slate), y eres libre de leerlo, bifurcarlo, cambiarlo y ejecutarlo.

***

## Qué puedes construir

| Objetivo                                                                                                                                                                       | Qué usar                                                                                         | Dónde leer                                                                                                                                                                                                                                                                                                                       |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Que otro sistema consulte tus horarios libres y reserve, liste, reprograme o cancele reuniones                                                                                 | Una clave de API y la API REST                                                                   | [Claves de API](https://docs.dapta.ai/dapta-docs-es/dcal/developers/api-keys.md), [API REST](https://docs.dapta.ai/dapta-docs-es/dcal/developers/rest-api.md)                                                                                                                                                                    |
| Apuntar a dCal una herramienta que ya habla la API v2 de Cal.com                                                                                                               | Una clave de API y los endpoints `/v2`                                                           | [API compatible con Cal.com](https://docs.dapta.ai/dapta-docs-es/dcal/developers/cal-com-compatible-api.md)                                                                                                                                                                                                                      |
| Que un asistente de IA como Claude, ChatGPT, Cursor, Claude Code o Codex busque y aparte horarios, agende, mueva o cancele reuniones, y responda solicitudes de reserva por ti | El servidor MCP de dCal en `https://mcp.dcal.ai/mcp`, con un inicio de sesión o una clave de API | [Conecta un asistente de IA (MCP)](https://docs.dapta.ai/dapta-docs-es/dcal/developers/mcp-server.md), [Conecta Claude o ChatGPT con tu cuenta](https://docs.dapta.ai/dapta-docs-es/dcal/developers/connect-with-sign-in.md), [Referencia de herramientas MCP](https://docs.dapta.ai/dapta-docs-es/dcal/developers/mcp-tools.md) |
| Enterarte en el momento en que se crea, reprograma o cancela una reserva                                                                                                       | Un webhook                                                                                       | [Webhooks](https://docs.dapta.ai/dapta-docs-es/dcal/integrations/webhooks.md)                                                                                                                                                                                                                                                    |
| Enviar cada reserva aceptada a tu CRM                                                                                                                                          | La integración con HubSpot, sin código                                                           | [HubSpot](https://docs.dapta.ai/dapta-docs-es/dcal/integrations/hubspot.md)                                                                                                                                                                                                                                                      |
| Que un Agente de Texto o un Agente de Voz agende reuniones por ti                                                                                                              | La acción de agendamiento en la app de Dapta, sin código                                         | [Deja que tu agente de Dapta agende](https://docs.dapta.ai/dapta-docs-es/dcal/dapta-agents.md)                                                                                                                                                                                                                                   |
| Ejecutar dCal en tus propios servidores                                                                                                                                        | El repositorio                                                                                   | [Alojarlo tú mismo](https://docs.dapta.ai/dapta-docs-es/dcal/developers/self-hosting.md), [Variables de entorno](https://docs.dapta.ai/dapta-docs-es/dcal/developers/environment-variables.md)                                                                                                                                   |

Las páginas para agentes de IA, claves de API y webhooks están en el menú de la izquierda, y solo las ven los propietarios y administradores del workspace:

| En el menú de la izquierda              | Qué tiene                                                                                                                                   |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Conecta tu agente**                   | Los pasos para conectar Claude, ChatGPT, Claude Code, Codex, Cursor, OpenClaw o Hermes iniciando sesión con tu cuenta, una pestaña por app. |
| **Herramientas**                        | Las 19 cosas que puede hacer un agente conectado, en palabras sencillas, con un ejemplo de lo que puedes pedir en cada una.                 |
| **API y webhooks** > **Claves API**     | Tus claves de API, y el skill para agentes que no tienen MCP.                                                                               |
| **API y webhooks** > **Webhooks**       | Los mensajes que dCal envía a tus sistemas cuando cambia una reserva.                                                                       |
| **API y webhooks** > **Docs de la API** | Abre la referencia de la API en una pestaña nueva, con una consola de prueba y un enlace al documento OpenAPI.                              |

En **Inicio**, el banner y la tarjeta **Conecta tu agente** te llevan a la página para conectar.

***

## Qué hay en el repositorio

dCal son dos aplicaciones más una base de datos:

* **La app web**: las páginas públicas de reservas, la página donde tus invitados gestionan su reserva y todo el panel.
* **La API**: la disponibilidad, las reservas, la API REST y todo lo que guarda el panel.

La app web nunca lee la base de datos directamente: llama a la API por HTTP, así que las dos se despliegan y escalan por separado. Las dos se distribuyen como imágenes de Docker y corren en cualquier servidor con Node.

El repositorio también trae las guías que necesitas, al día con el código (en inglés):

| Archivo                                                                                            | Qué cubre                                                                                                                                                                                   |
| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`README.md`](https://github.com/Dapta-Tech/dapta-calendars-slate/blob/main/README.md)             | El inicio rápido local: clonar, instalar y ejecutar, sin base de datos ni cuentas que configurar.                                                                                           |
| [`SELF-HOSTING.md`](https://github.com/Dapta-Tech/dapta-calendars-slate/blob/main/SELF-HOSTING.md) | La guía de producción: imágenes, base de datos, la referencia completa de entorno, proxy inverso, inicio de sesión, correo, backend de calendario, actualizaciones y solución de problemas. |
| [`ARCHITECTURE.md`](https://github.com/Dapta-Tech/dapta-calendars-slate/blob/main/ARCHITECTURE.md) | Cómo encajan las piezas y cómo fluyen las peticiones.                                                                                                                                       |
| [`.env.example`](https://github.com/Dapta-Tech/dapta-calendars-slate/blob/main/.env.example)       | Cada ajuste con notas en línea.                                                                                                                                                             |
| [`CONTRIBUTING.md`](https://github.com/Dapta-Tech/dapta-calendars-slate/blob/main/CONTRIBUTING.md) | Cómo proponer un cambio.                                                                                                                                                                    |
| [`SECURITY.md`](https://github.com/Dapta-Tech/dapta-calendars-slate/blob/main/SECURITY.md)         | Cómo reportar una vulnerabilidad en privado.                                                                                                                                                |

> **💡 Tip:** Las contribuciones son bienvenidas. Abre los pull requests contra la rama `develop`, con un título en formato Conventional Commits y la firma DCO en cada commit (`git commit -s`). La CI revisa cada pull request.

***

## En esta sección

* [Claves de API](https://docs.dapta.ai/dapta-docs-es/dcal/developers/api-keys.md): crea una clave, elige sus permisos, guárdala de forma segura y revócala.
* [API REST](https://docs.dapta.ai/dapta-docs-es/dcal/developers/rest-api.md): los endpoints, las cabeceras, la idempotencia, los errores, los límites de uso y el documento OpenAPI.
* [Alojarlo tú mismo](https://docs.dapta.ai/dapta-docs-es/dcal/developers/self-hosting.md): requisitos, base de datos, inicio rápido, opciones de inicio de sesión, correo y calendario, y qué cambia cuando dejas app.dcal.ai.
* [Variables de entorno](https://docs.dapta.ai/dapta-docs-es/dcal/developers/environment-variables.md): cada ajuste que lee una instalación propia, con su valor por defecto.
* [API compatible con Cal.com](https://docs.dapta.ai/dapta-docs-es/dcal/developers/cal-com-compatible-api.md): los endpoints `/v2` para herramientas que ya hablan la API de Cal.com.
* [Conecta Claude o ChatGPT con tu cuenta](https://docs.dapta.ai/dapta-docs-es/dcal/developers/connect-with-sign-in.md): conecta Claude, ChatGPT, Claude Code, Codex, Cursor, OpenClaw, Hermes u otra app con tu cuenta de Dapta, sin clave.
* [Conecta un asistente de IA (MCP)](https://docs.dapta.ai/dapta-docs-es/dcal/developers/mcp-server.md): las páginas para agentes en dCal, las dos formas de conectarte, cómo conectar Cursor, Claude Code, Codex u otro agente con una clave, y el skill para agentes. El servidor MCP está disponible en `https://mcp.dcal.ai/mcp`.
* [Referencia de herramientas MCP](https://docs.dapta.ai/dapta-docs-es/dcal/developers/mcp-tools.md): las 33 herramientas que ofrece el servidor MCP, con sus entradas, respuestas, flujos comunes, errores y límites.

## Relacionado

* [Webhooks](https://docs.dapta.ai/dapta-docs-es/dcal/integrations/webhooks.md): recibe en tu endpoint cada cambio de una reserva.
* [Deja que tu agente de Dapta agende](https://docs.dapta.ai/dapta-docs-es/dcal/dapta-agents.md): la forma sin código de que un agente de IA agende en dCal.
* [Seguridad y privacidad](https://docs.dapta.ai/dapta-docs-es/dcal/security-and-privacy.md): qué guarda dCal, cómo se protegen las claves y los enlaces, y cómo reportar una vulnerabilidad.


---

# 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.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.
