> 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/mcp-server.md).

# Conecta un asistente de IA (MCP)

Deja que un asistente de IA como Claude, ChatGPT, Cursor, Claude Code o Codex busque tus horarios libres y aparte, agende, mueva, confirme, rechace o cancele reuniones de dCal por ti. Conéctalo al ser

dCal tiene su propio servidor MCP, en `https://mcp.dcal.ai/mcp`, para que un asistente de IA que ya usas pueda trabajar con tu calendario con tus propias palabras: buscar un horario libre, apartarlo, agendar una reunión, moverla, responder una solicitud de reserva o cancelarla. Esta página te muestra dónde está la configuración en dCal, las dos formas de conectarte y cómo mantenerlo seguro.

***

## Qué es MCP

MCP, el Model Context Protocol, es un estándar abierto que permite que un asistente de IA use las herramientas de otras apps. La dirección del servidor MCP de dCal es `https://mcp.dcal.ai/mcp`. Cuando conectas tu asistente, puedes pedirle algo como "busca un espacio libre de 30 minutos el próximo martes para John Doe y agéndalo". El asistente le pide a dCal tus horarios libres, agenda la reunión y te cuenta qué hizo. Tu invitado recibe los mismos correos que cuando reserva en tu página.

> **💡 Tip:** Esta página trata del servidor MCP propio de dCal. Para manejar tus agentes, flujos y analítica de Dapta desde un asistente de IA, mira [Dapta MCP](https://docs.dapta.ai/dapta-docs-es/dapta-mcp/mcp.md). Para que un Agente de Texto o un Agente de Voz agende en dCal sin código, mira [Deja que tu agente de Dapta agende](https://docs.dapta.ai/dapta-docs-es/dcal/dapta-agents.md).

***

## Dos formas de conectarte

|                 | Iniciar sesión                                                                                                        | Clave de API                                                                                        |
| --------------- | --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| Pensado para    | Claude, ChatGPT, Claude Code, Codex, Cursor, OpenClaw, Hermes y otras apps que admiten inicio de sesión MCP           | Agentes y scripts que corren sin nadie que inicie sesión, y cualquier agente que envíe una cabecera |
| Cómo            | Agrega la dirección MCP en la app e inicia sesión con tu cuenta de Dapta. Sin clave.                                  | Crea una clave, ponla en una variable de entorno y agrega el servidor a tu agente.                  |
| Qué puede hacer | Todo lo que permite tu acceso de propietario o administrador: todas las herramientas, en todos los tipos de evento    | Solo el acceso que marques, por ejemplo solo lectura o un único tipo de evento                      |
| En dCal         | **Conecta tu agente**, una pestaña por app                                                                            | **API y webhooks** > **Claves API**                                                                 |
| Pasos           | [Conecta Claude o ChatGPT con tu cuenta](https://docs.dapta.ai/dapta-docs-es/dcal/developers/connect-with-sign-in.md) | Esta página, desde [Crea una clave para tu asistente](#crea-una-clave-para-tu-asistente)            |

Iniciar sesión es lo más fácil. Usa una clave cuando el asistente deba tener un acceso más acotado, o cuando tu agente no pueda iniciar sesión.

***

## Antes de empezar

* Eres **propietario** o **administrador** de tu workspace de dCal. Solo ellos ven **Conecta tu agente**, **Herramientas** y **API y webhooks** en el menú de la izquierda, y pueden conectar un asistente o crear claves. Un miembro que abre una de esas páginas ve **No tienes acceso**: pídele ayuda a un propietario o a un administrador.
* Tu asistente puede conectarse a un servidor MCP por HTTP. Si no puede pero ejecuta comandos en una terminal, mira [¿Tu agente no tiene MCP? Usa el skill](#tu-agente-no-tiene-mcp-usa-el-skill).

***

## Las páginas para agentes en dCal

Todo lo de los agentes de IA está en el menú de la izquierda:

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-bbcfc27a8d3b0a2a15801f14a466f7bbdff408ab%2Fdcal-dashboard-tour-07-api-and-webhooks.png?alt=media" alt="El menú de la izquierda con Conecta tu agente, Herramientas y el grupo API y webhooks abierto, marcados, y dentro del grupo Claves API (seleccionada), Webhooks y Docs de la API con su flecha de enlace externo"><figcaption><p>Solo los propietarios y administradores ven estas opciones.</p></figcaption></figure>

| Página                                  | Qué contiene                                                                                                                                                                                                                                                                                                                              |
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Conecta tu agente**                   | Los pasos para conectar Claude, ChatGPT, Claude Code, Codex, Cursor, OpenClaw o Hermes iniciando sesión, una pestaña por app, con la dirección MCP y una primera pregunta para probar. Sin ninguna clave. [app.dcal.ai/admin/developers/connect](https://app.dcal.ai/admin/developers/connect)                                            |
| **Herramientas**                        | Las 33 herramientas en seis grupos, **Horarios libres**, **Reservas nuevas**, **Horarios apartados**, **Tus reservas**, **Solicitudes de reserva** y **Cuenta y tipos de evento**, cada una en palabras sencillas con un ejemplo de lo que puedes pedir. [app.dcal.ai/admin/developers/tools](https://app.dcal.ai/admin/developers/tools) |
| **API y webhooks** > **Claves API**     | Tus **Claves API** y **¿Tu agente no tiene MCP?**, el skill para descargar. [app.dcal.ai/admin/developers/keys](https://app.dcal.ai/admin/developers/keys)                                                                                                                                                                                |
| **API y webhooks** > **Webhooks**       | Los mensajes que dCal envía a tus sistemas cuando cambia una reserva. Mira [Webhooks](https://docs.dapta.ai/dapta-docs-es/dcal/integrations/webhooks.md). [app.dcal.ai/admin/developers/webhooks](https://app.dcal.ai/admin/developers/webhooks)                                                                                          |
| **API y webhooks** > **Docs de la API** | Abre la referencia de la API para tu propio código, en una pestaña nueva. [api.dcal.ai/docs](https://api.dcal.ai/docs)                                                                                                                                                                                                                    |

El banner y la tarjeta **Conecta tu agente** de **Inicio** abren la página para conectar, igual que los enlaces anteriores a [app.dcal.ai/admin/developers](https://app.dcal.ai/admin/developers) y [app.dcal.ai/admin/settings/developer](https://app.dcal.ai/admin/settings/developer).

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-81f962ca6cd07a90ab17b3697a57fa323b8ebd9e%2Fdcal-mcp-server-01-connect-your-agent.png?alt=media" alt="La parte de arriba de la página Conecta tu agente: el antetítulo MCP, el título Conecta Claude, ChatGPT, Codex o Cursor con dCal, su introducción y un botón Herramientas arriba a la derecha, luego la tarjeta Conecta con tu cuenta con su etiqueta Recomendado y tres puntos, y las pestañas Claude, ChatGPT, Claude Code, Codex, Cursor, OpenClaw y Hermes"><figcaption><p><strong>Conecta tu agente</strong> empieza por el inicio de sesión: no hay clave que crear.</p></figcaption></figure>

> **💡 Tip:** **Docs de la API**, dentro de **API y webhooks**, abre la referencia de la API en una pestaña nueva. **Documentación**, más abajo en el menú de la izquierda, abre estas páginas de ayuda, también en una pestaña nueva.

Todas las configuraciones de **Conecta tu agente** inician sesión: la página no trae pasos para una clave. Para conectarte con una clave, sigue los pasos de abajo. En una copia que alojas tú mismo y que tiene apagado el inicio de sesión para apps de IA, la página dice **El conector no está disponible en esta instalación** (mira [Alojarlo tú mismo](https://docs.dapta.ai/dapta-docs-es/dcal/developers/self-hosting.md#asistentes-de-ia-analitica-y-buscadores)).

***

## Crea una clave para tu asistente

Con una clave, tu asistente demuestra quién es sin iniciar sesión. Una clave pertenece a todo tu workspace y solo puede hacer lo que tú permitas.

**Paso 1:** En el menú de la izquierda, abre **API y webhooks** > **Claves API**, o ve directo a [app.dcal.ai/admin/developers/keys](https://app.dcal.ai/admin/developers/keys).

**Paso 2:** Haz clic en **Crear clave**, en el encabezado de **Claves API**. Escribe un **Nombre** que diga qué asistente la usa, por ejemplo `Cursor en la laptop de Jane`.

**Paso 3:** En **Acceso que da esta clave**, marca solo lo que el asistente necesita. **Consultar horarios libres** viene marcado. Una etiqueta en cada línea te dice si el acceso solo mira (**Lectura**), cambia tu agenda (**Escritura**) o no se puede deshacer (**Destructiva**).

| Acceso                                                       | Etiqueta    | Qué puede hacer el asistente con él                                                                                                                                          |
| ------------------------------------------------------------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ver tipos de evento**                                      | Lectura     | Listar tus tipos de evento y obtener sus enlaces públicos.                                                                                                                   |
| **Consultar horarios libres**                                | Lectura     | Buscar los horarios libres de cualquiera de tus tipos de evento, personales o de equipo.                                                                                     |
| **Leer reservas**                                            | Lectura     | Listar reservas y las solicitudes que esperan tu respuesta, y leer una reserva completa, incluido lo que escribió el invitado.                                               |
| **Crear, apartar, reagendar, confirmar y rechazar reservas** | Escritura   | Apartar un horario, agendar reuniones en cualquier tipo de evento de tu workspace, moverlas, y confirmar o rechazar solicitudes de reserva. Tus invitados reciben un correo. |
| **Cancelar reservas**                                        | Destructiva | Cancelar reuniones y avisar a tus invitados por correo. Una cancelación no se puede deshacer.                                                                                |
| **Ver calendarios conectados**                               | Lectura     | Nada por MCP. Lo usa la [API compatible con Cal.com](https://docs.dapta.ai/dapta-docs-es/dcal/developers/cal-com-compatible-api.md).                                         |

Combinaciones comunes:

* Un asistente que responde preguntas sobre tu agenda: **Ver tipos de evento**, **Consultar horarios libres** y **Leer reservas**.
* Un asistente que además agenda y responde solicitudes por ti: agrega **Crear, apartar, reagendar, confirmar y rechazar reservas**.
* Agrega **Cancelar reservas** solo si quieres que el asistente cancele reuniones.

**Paso 4:** En **Tipos de evento**, deja **Todos los tipos de evento**, o elige **Solo estos tipos de evento** y marca los que el asistente puede usar. La lista muestra tus propios tipos de evento y los de cada equipo, con el nombre del equipo entre paréntesis. Con una clave limitada, las herramientas que necesitan clave no pueden ver ni agendar ningún otro tipo de evento, ni leer las reservas hechas en ellos. Las herramientas para páginas de reservas públicas siguen funcionando en cualquier página pública, como para cualquier persona.

**Paso 5:** En **Vence**, elige **Nunca**, **En 30 días**, **En 90 días** o **En 365 días**. Una clave vencida deja de funcionar, igual que una revocada.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-3a8a60f4decde76d90a8e5339db0d40448dc6d9a%2Fdcal-mcp-server-02-create-key-dialog.png?alt=media" alt="El diálogo Crear clave con el nombre Cursor en la laptop de Jane y tres secciones en recuadros: Acceso que da esta clave con cuatro líneas marcadas (tres de Lectura y una de Escritura), Tipos de evento con Solo estos tipos de evento y Llamada inicial marcados, y Vence con la opción En 90 días"><figcaption><p>Una clave para un asistente que agenda: cuatro accesos, un tipo de evento y una fecha de vencimiento.</p></figcaption></figure>

***

**Paso 6:** Haz clic en **Crear clave**. El botón sigue desactivado hasta que la clave tenga un nombre, al menos un acceso y, con **Solo estos tipos de evento**, al menos un tipo de evento. La clave aparece una sola vez, encima de la lista, bajo la línea *Cópiala ahora*. Selecciónala y cópiala: no hay botón para copiar, y en cuanto recargues o salgas de la página dCal no puede volver a mostrarla.

> **⚠️ Nota:** Trata la clave como una contraseña: quien la tenga puede actuar sobre tu workspace dentro de su acceso. Guárdala en tu propia computadora o servidor. Nunca la pegues en un chat, en un documento compartido, en un archivo de configuración que subas a un repositorio ni en una URL.

La fila de la clave en la lista muestra entonces lo que puede hacer: sus accesos, **Todos los tipos de evento** o a cuántos está limitada, cuándo vence y **Último uso** con una fecha, o **Sin usar**. Las fechas están en UTC y se escriben como año, mes y día, por ejemplo `2026-11-03`.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-028bf30663e5ed669ecbab067a3ad4c66c23ea0b%2Fdcal-mcp-server-03-key-row.png?alt=media" alt="El encabezado Claves API con su botón Crear clave, encima de una fila de clave con el nombre Cursor en la laptop de Jane, el inicio y el final de la clave, etiquetas para los cuatro accesos que da, la línea Solo 1 tipo(s) de evento, Vence el 2027-01-18, Sin usar y el botón Revocar"><figcaption><p>Cada clave muestra sus accesos, sus tipos de evento, su vencimiento y cuándo se usó por última vez.</p></figcaption></figure>

***

## Conecta tu asistente con una clave

**Paso 7:** Pon la clave en tu entorno:

```bash
export DAPTA_CALENDARS_API_KEY="dcl_your_key_here"
```

Cambia `dcl_your_key_here` por tu clave y ejecuta la línea en la terminal desde la que abres tu asistente. Todas las configuraciones de abajo leen la clave de la variable `DAPTA_CALENDARS_API_KEY`, la misma que usa el skill para agentes, así que la clave nunca queda pegada en un archivo de configuración ni en un enlace.

**Paso 8:** Agrega el servidor a tu asistente con la configuración que le corresponde, abajo. Todas registran el servidor como `dcal`, el nombre que usa la página para conectar; una configuración hecha antes con el nombre `dapta-calendars` sigue funcionando.

### Cursor

Pega esto en `.cursor/mcp.json` (un proyecto) o en `~/.cursor/mcp.json` (todos los proyectos):

```json
{
  "mcpServers": {
    "dcal": {
      "url": "https://mcp.dcal.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DAPTA_CALENDARS_API_KEY}"
      }
    }
  }
}
```

Cursor lee la clave de tu entorno al iniciar. Para conectar Cursor iniciando sesión, usa la pestaña **Cursor** de **Conecta tu agente**: mira [Conecta Claude o ChatGPT con tu cuenta](https://docs.dapta.ai/dapta-docs-es/dcal/developers/connect-with-sign-in.md#cursor).

### Claude Code

Ejecuta esto una vez en tu terminal:

```bash
claude mcp add --transport http dcal https://mcp.dcal.ai/mcp \
  --header 'Authorization: Bearer ${DAPTA_CALENDARS_API_KEY}'
```

Deja las comillas simples alrededor de la cabecera. Evitan que tu terminal reemplace la variable: así Claude Code guarda el nombre `${DAPTA_CALENDARS_API_KEY}` y lee tu clave cada vez que inicia, en lugar de guardar la clave misma. Para conectar Claude Code iniciando sesión, usa la pestaña **Claude Code** de **Conecta tu agente**: mira [Conecta Claude o ChatGPT con tu cuenta](https://docs.dapta.ai/dapta-docs-es/dcal/developers/connect-with-sign-in.md#claude-code). Las dos no pueden compartir el nombre `dcal`: ponle otro nombre a una de ellas.

### Codex

Agrega esto a `~/.codex/config.toml`, o a `.codex/config.toml` en un proyecto de confianza:

```toml
[mcp_servers.dcal]
url = "https://mcp.dcal.ai/mcp"
bearer_token_env_var = "DAPTA_CALENDARS_API_KEY"
```

### Otros agentes

Cualquier agente o SDK que hable MCP por HTTP necesita dos cosas:

|                                  |                                                        |
| -------------------------------- | ------------------------------------------------------ |
| **Dirección del servidor**       | `https://mcp.dcal.ai/mcp`                              |
| **Encabezado en cada solicitud** | `Authorization: Bearer <your DAPTA_CALENDARS_API_KEY>` |

El servidor recibe peticiones `POST` con un cuerpo JSON (`Content-Type: application/json`) por Streamable HTTP, sin sesión que abrir ni cerrar. Envía la clave solo en la cabecera `Authorization`: una petición que pone una clave en la dirección se rechaza. Llama al servidor desde tu propio servidor o desde una app local, no desde una página web: una petición que lleva la cabecera `Origin` de un navegador se rechaza.

### Claude, ChatGPT, OpenClaw y Hermes

Estas apps se conectan iniciando sesión, sin clave, desde sus pestañas en **Conecta tu agente**. Sus pasos están en [Conecta Claude o ChatGPT con tu cuenta](https://docs.dapta.ai/dapta-docs-es/dcal/developers/connect-with-sign-in.md).

***

## Comprueba la conexión

**Paso 9:** Pregúntale a tu asistente algo que solo lea, por ejemplo:

> ¿A qué workspace de dCal estás conectado y qué puedes hacer ahí?

El asistente llama a la herramienta `whoami` y responde con el nombre del workspace, el nombre y la zona horaria de su propietario, y lo que puede hacer. Con una clave, la fila de la clave en **Claves API** muestra después **Último uso** con una fecha.

Si el asistente dice que no puede conectarse, o dCal responde `Invalid, expired or revoked API key.`, revisa que la variable tenga la clave completa, que hayas abierto el asistente desde la terminal donde la definiste y que la clave no esté revocada ni vencida.

***

## ¿Tu agente no tiene MCP? Usa el skill

Algunos agentes ejecutan comandos en una terminal pero no pueden conectarse a un servidor MCP. Para ellos, **API y webhooks** > **Claves API** termina con **¿Tu agente no tiene MCP?** y el botón **Descargar el skill**: un zip que le enseña a cualquier agente con terminal a usar la API de dCal con una clave de API. Solo los propietarios y administradores pueden descargarlo.

**Paso 1:** Crea una clave con el acceso que necesita el agente y defínela en tu terminal como `DAPTA_CALENDARS_API_KEY`, como en [Conecta tu asistente con una clave](#conecta-tu-asistente-con-una-clave). El skill nunca contiene una clave: el agente la lee de esa variable.

**Paso 2:** Haz clic en **Descargar el skill**. El botón dice **Preparando el skill…** mientras dCal arma el zip, y después tu navegador guarda `dapta-calendars-skill.zip`.

**Paso 3:** Descomprímelo donde tu agente lo lea. El `INSTALL.md` que trae dentro tiene los comandos exactos para Claude Code, Codex y Cursor, y una petición que comprueba tu clave. Para Claude Code, en todos tus proyectos:

```bash
unzip -o dapta-calendars-skill.zip -d ~/.claude/skills/
```

Para Codex, la carpeta va dentro de tu proyecto, con una sección en `AGENTS.md` que apunta a ella. Para Cursor, va dentro de tu proyecto, con una regla en `.cursor/rules/`. Ejecutar los mismos comandos otra vez actualiza el skill.

El zip se descomprime en una carpeta `dapta-calendars`:

| Archivo                  | Qué contiene                                                                                        |
| ------------------------ | --------------------------------------------------------------------------------------------------- |
| `SKILL.md`               | Las instrucciones que sigue el agente, con el título "dCal API".                                    |
| `INSTALL.md`             | Cómo definir la clave e instalar el skill en Claude Code, Codex y Cursor.                           |
| `reference/endpoints.md` | Las rutas de la API que puede llamar el agente.                                                     |
| `reference/mcp-tools.md` | Las herramientas MCP, si cada una lee, escribe o es destructiva, y el acceso que necesita cada una. |
| `reference/openapi.json` | La descripción de la API legible por máquinas, con la dirección de la API de dCal ya puesta.        |

El skill está escrito en inglés. Si la descarga falla, la línea debajo del botón dice por qué: vuelve a iniciar sesión si tu sesión terminó, o inténtalo de nuevo en un momento.

***

## Qué puede hacer un asistente y qué no

**Herramientas**, en el menú de la izquierda, lista las 33 herramientas en seis grupos, cada una en palabras sencillas con un ejemplo de lo que puedes pedir, como "¿Cuándo estoy libre para una llamada de 30 minutos esta semana?". Nunca llamas una herramienta tú: pides con tus palabras y el asistente elige la correcta. La página no muestra nombres de herramientas ni etiquetas de acceso; la tabla de abajo trae las dos cosas.

| El asistente puede                                                                                                                    | Herramienta                                                                                                    | Qué necesita una clave                                                                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Buscar los horarios libres de un evento en una página de reservas pública                                                             | `find_available_slots`                                                                                         | Nada en una página pública                                                                                                                            |
| Buscar los horarios libres de un evento de equipo en una página de equipo pública                                                     | `find_team_slots`                                                                                              | Nada en una página pública                                                                                                                            |
| Apartar un horario en una página de reservas pública unos 10 minutos mientras el invitado decide                                      | `hold_slot`                                                                                                    | Nada en una página pública                                                                                                                            |
| Reservar un horario en una página de reservas pública, como lo haría un invitado                                                      | `book_meeting`                                                                                                 | Nada                                                                                                                                                  |
| Reservar con un equipo en una página de equipo pública; se asigna un anfitrión libre dentro de su horario de trabajo                  | `book_team_meeting`                                                                                            | Nada en una página pública                                                                                                                            |
| Decir a qué workspace y con qué acceso está conectado                                                                                 | `whoami`                                                                                                       | Cualquier clave, o un inicio de sesión                                                                                                                |
| Listar los workspaces en los que puede actuar                                                                                         | `list_my_accounts`                                                                                             | Cualquier clave, o un inicio de sesión                                                                                                                |
| Listar tus tipos de evento y obtener el enlace público de un evento                                                                   | `list_event_types`, `get_booking_page_link`                                                                    | **Ver tipos de evento**                                                                                                                               |
| Buscar los horarios libres de uno de tus tipos de evento por su ID                                                                    | `find_available_slots`, `find_team_slots`                                                                      | **Consultar horarios libres**                                                                                                                         |
| Listar reservas y solicitudes pendientes, y leer una reserva completa                                                                 | `list_bookings`, `list_pending_bookings`, `get_booking`                                                        | **Leer reservas**                                                                                                                                     |
| Apartar, agendar, mover, confirmar o rechazar en cualquiera de tus tipos de evento                                                    | `hold_slot`, `create_booking`, `book_team_meeting`, `reschedule_booking`, `confirm_booking`, `decline_booking` | **Crear, apartar, reagendar, confirmar y rechazar reservas**                                                                                          |
| Cancelar una reserva                                                                                                                  | `cancel_booking`                                                                                               | **Cancelar reservas**                                                                                                                                 |
| Poner un evento propio en tu calendario, solo o con hasta 10 personas, a cualquier hora, una vez o que se repita, con enlace de video | `create_event`                                                                                                 | **Crear, apartar, reagendar, confirmar y rechazar reservas**, sin límite de tipos de evento                                                           |
| Ver cuándo están libres tú y otras personas antes de poner una reunión en tu calendario                                               | `check_attendee_availability`                                                                                  | **Consultar horarios libres** (una clave necesita además **Crear, apartar, reagendar, confirmar y rechazar reservas**), sin límite de tipos de evento |

Un inicio de sesión puede usar todas las herramientas. Las entradas y respuestas de cada herramienta, y los flujos comunes, están en la [Referencia de herramientas MCP](https://docs.dapta.ai/dapta-docs-es/dcal/developers/mcp-tools.md).

Lo que un asistente no puede hacer: editar tus tipos de evento, horarios o ajustes, ni gestionar webhooks, claves de API, miembros o equipos. Una clave solo llega a su propio workspace. Un inicio de sesión llega a los workspaces donde eres propietario o administrador: mira [Si perteneces a varios workspaces](https://docs.dapta.ai/dapta-docs-es/dcal/developers/connect-with-sign-in.md#si-perteneces-a-varios-workspaces).

Para tu propio código, **API y webhooks** > **Docs de la API** abre la referencia de la API, [api.dcal.ai/docs](https://api.dcal.ai/docs), en una pestaña nueva. Su introducción enlaza al documento OpenAPI, [api.dcal.ai/openapi.json](https://api.dcal.ai/openapi.json), la descripción legible por máquinas de todas las rutas que una clave puede llamar. Mira [API REST](https://docs.dapta.ai/dapta-docs-es/dcal/developers/rest-api.md#documento-openapi).

Cómo se comportan las reservas que hace un asistente:

* **Solo horarios ofrecidos.** El asistente solo puede reservar una hora de inicio que dCal ofrece, los mismos horarios que muestra tu página de reservas. Un horario que se acaba de ocupar se rechaza, y el asistente busca otro. Un horario más allá de la antelación máxima del evento recibe la misma respuesta que cualquier horario que el evento no ofrece.
* **Un horario se puede apartar antes.** En un evento con un solo anfitrión, `hold_slot` guarda un horario unos 10 minutos mientras el asistente confirma los detalles con tu invitado: ninguna lista de horarios lo ofrece, y las herramientas de reserva MCP no lo reservan para nadie más. Después el asistente lo reserva con el ID de la reserva temporal. Una reserva temporal que no se usa simplemente vence.
* **Las solicitudes esperan una respuesta.** En un evento con **Requiere confirmación**, el asistente puede listar las solicitudes que esperan tu respuesta y confirmar o rechazar cada una. Al confirmar, dCal revisa primero tu calendario y rechaza un horario que se ocupó mientras tanto.
* **Sin reservas dobles al reintentar.** Cada reserva, reserva temporal, cambio de horario, confirmación o rechazo lleva una clave que el asistente inventa para esa sola acción. Si envía la misma acción dos veces, dCal responde con el primer resultado y no reserva nada nuevo. Cancelar una reserva que ya está cancelada simplemente vuelve a responder con éxito.
* **Tus invitados reciben correos.** Una reserva, un cambio de horario, una confirmación, un rechazo o una cancelación le envía a tu invitado el correo de siempre, así que un buen asistente te pregunta antes de actuar.
* **Un cambio de horario le da a la reserva un ID nuevo.** El ID anterior queda enlazado al nuevo, y tus webhooks reciben `booking.rescheduled` con los dos.
* **Mover, rechazar y cancelar están marcados como destructivos.** Reemplazan, rechazan o anulan una reserva y le envían un correo a tu invitado. Las apps que respetan esa marca te preguntan antes de usarlos.
* **Los enlaces de reserva apuntan a tus páginas de reservas.** Los enlaces que recibe el asistente para tus eventos empiezan con `https://book.dcal.ai`, seguido de tu enlace personalizado si tienes uno. Un enlace a una de tus páginas que empieza con `app.dcal.ai` también funciona como entrada.

***

## Mantenlo seguro

* **Dale a cada asistente su propia clave, con solo el acceso que necesita.** Limítala a los tipos de evento con los que trabaja y ponle vencimiento cuando el trabajo tenga fecha de fin.
* **Un inicio de sesión tiene todo tu acceso de propietario o administrador.** Conecta iniciando sesión solo las apps a las que les confías eso. Para menos, usa una clave.
* **Las claves nunca viajan en configuraciones ni enlaces.** Todas las configuraciones leen la clave de una variable de entorno, y un inicio de sesión no necesita ninguna clave.
* **Lo que escribieron tus invitados se trata como datos, no como instrucciones.** Nombres, correos, teléfonos, notas, respuestas y motivos, además de títulos de eventos, nombres de anfitriones y lugares, le llegan al asistente limpios: se quitan los caracteres ocultos, el HTML y las imágenes en markdown, los enlaces conservan solo su texto visible y cada valor se recorta a una longitud máxima. `get_booking` pone todo lo que escribió un invitado bajo `invitee_supplied` y le indica al asistente que nunca siga instrucciones que encuentre ahí. `list_bookings` y `list_pending_bookings` no devuelven nombres, notas ni respuestas, solo el dominio del correo de cada invitado.
* **Cada conexión se limita a sus workspaces.** Todo lo que está fuera de ellos, o fuera de los tipos de evento de una clave, responde como si no existiera.
* **Las llamadas tienen un límite de uso.** Cada clave, y cada persona que inició sesión, puede hacer ráfagas de hasta 30 llamadas de lectura, que se recargan a 1 por segundo, y de hasta 10 llamadas que reservan, apartan, mueven, confirman, rechazan o cancelan, que se recargan a 1 cada 5 segundos. Las llamadas sin clave, y las de un inicio de sesión que todavía no llega a ningún workspace, se cuentan por dirección. dCal cuenta en cada uno de sus servidores por separado, así que toma estas cifras como aproximadas.
* **Cada llamada queda registrada sin tus datos.** dCal guarda una línea por llamada con quién llamó (el prefijo de una clave, o el inicio de sesión), la herramienta, el resultado y cuánto tardó, nunca la clave, los datos de un invitado ni lo que escribió.

***

## Revoca una clave

**Paso 1:** En **API y webhooks** > **Claves API**, haz clic en **Revocar** en la fila de la clave.

**Paso 2:** Confirma en el diálogo **¿Revocar esta clave?**. dCal muestra **Clave revocada.** y marca la fila como **revocada**. No se puede deshacer.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-d0f57aceeae39f9149770148f5734b2420306537%2Fdcal-mcp-server-06-revoke-dialog.png?alt=media" alt="El diálogo ¿Revocar esta clave? con el nombre de la clave Cursor en la laptop de Jane y los botones Cancelar y Revocar"><figcaption><p>Una clave revocada deja de funcionar en la siguiente llamada del asistente.</p></figcaption></figure>

Desde su siguiente llamada, el asistente recibe `Invalid, expired or revoked API key.` Para reemplazar una clave, crea primero la nueva, actualiza la variable, reinicia el asistente y después revoca la clave anterior.

Para terminar una conexión con inicio de sesión, elimina el conector en la app. Un propietario también puede cortarla al instante quitándole a esa persona el rol de administrador. Mira [Desconectar](https://docs.dapta.ai/dapta-docs-es/dcal/developers/connect-with-sign-in.md#desconectar).

## Relacionado

* [Conecta Claude o ChatGPT con tu cuenta](https://docs.dapta.ai/dapta-docs-es/dcal/developers/connect-with-sign-in.md): conéctate con tu cuenta de Dapta, sin clave.
* [Referencia de herramientas MCP](https://docs.dapta.ai/dapta-docs-es/dcal/developers/mcp-tools.md): las entradas, respuestas y errores de cada herramienta.
* [Claves de API](https://docs.dapta.ai/dapta-docs-es/dcal/developers/api-keys.md): claves para tus propios sistemas y la API REST.
* [Seguridad y privacidad](https://docs.dapta.ai/dapta-docs-es/dcal/security-and-privacy.md): cómo se protegen las claves y los datos de los invitados.
* [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 Dapta agende en dCal.


---

# 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/mcp-server.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.
