> 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/connect-with-sign-in.md).

# Conecta Claude o ChatGPT con tu cuenta

Conecta Claude, ChatGPT, Claude Code, Codex, Cursor, OpenClaw, Hermes u otra app que admita inicio de sesión MCP a dCal iniciando sesión con tu cuenta de Dapta, sin pegar ninguna clave de API. Quién p

Claude, ChatGPT, Claude Code, Codex, Cursor, OpenClaw, Hermes y otras apps que admiten inicio de sesión MCP se conectan al servidor MCP de dCal, en `https://mcp.dcal.ai/mcp`, iniciando sesión con tu cuenta de Dapta: la misma que usas en dCal. No hay ninguna clave que crear, copiar ni pegar. Esta página te muestra quién puede conectarse, los pasos en cada app y cómo desconectar.

> **💡 Tip:** ¿Es tu primera vez con MCP? [Conecta un asistente de IA (MCP)](https://docs.dapta.ai/dapta-docs-es/dcal/developers/mcp-server.md) explica qué es, y la otra forma de conectarte, con una clave de API.

***

## Iniciar sesión o usar una clave de API

|                 | 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                  |
| Qué pegas       | Nada: inicias sesión con tu cuenta de Dapta                                                                        | Una clave, guardada en una variable de entorno                                                                       |
| 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, con fecha de vencimiento si la pones |
| Cómo termina    | Eliminas el conector en la app, o un propietario te quita el rol de administrador                                  | Un propietario o administrador revoca la clave, o la clave vence                                                     |

Iniciar sesión es lo más rápido. Usa una [clave de API](https://docs.dapta.ai/dapta-docs-es/dcal/developers/api-keys.md) cuando el asistente deba tener un acceso más acotado.

***

## Antes de empezar

* Eres **propietario** o **administrador** del workspace de dCal. Los miembros no pueden conectar una app iniciando sesión.
* Abriste dCal en la web, en [app.dcal.ai](https://app.dcal.ai), en ese workspace durante los últimos 30 días.
* Inicias sesión con la misma cuenta de Dapta que usas en dCal.

***

## Encuentra los pasos en dCal

**Paso 1:** En el menú de la izquierda, haz clic en **Conecta tu agente**, o ve directo a [app.dcal.ai/admin/developers/connect](https://app.dcal.ai/admin/developers/connect). El banner y la tarjeta **Conecta tu agente** de **Inicio** también la abren, y lo mismo 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).

La página abre con **Conecta Claude, ChatGPT, Codex o Cursor con dCal** y una tarjeta, **Conecta con tu cuenta**, marcada como **Recomendado**. Sus tres puntos resumen cómo funciona el inicio de sesión: **Sin clave API.**, **Un conector, todos tus espacios.** y **Tu acceso, nada más.** Un botón **Herramientas**, arriba a la derecha, muestra lo que puede hacer un agente conectado.

<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, los tres puntos Sin clave API., Un conector, todos tus espacios. y Tu acceso, nada más., la línea Elige tu app y sigue los pasos. y las pestañas Claude, ChatGPT, Claude Code, Codex, Cursor, OpenClaw y Hermes"><figcaption><p>Una página, una pestaña por app. Ninguna pestaña pide una clave.</p></figcaption></figure>

***

**Paso 2:** Debajo de **Elige tu app y sigue los pasos.**, elige la pestaña de tu app: **Claude**, **ChatGPT**, **Claude Code**, **Codex**, **Cursor**, **OpenClaw** o **Hermes**. Cada pestaña abre con una animación corta de esa app conectándose y agendando una reunión, y luego trae pasos numerados con lo que debes pegar: la dirección MCP en **URL del MCP** (**Copiar URL**), o el comando o la configuración que necesita tu app, cada uno con su botón para copiar.

El último paso de cada pestaña, **Pregunta**, trae **Pruébalo**: una primera pregunta para pegar en tu app, con **Copiar prompt**. Debajo de las pestañas, **Un conector para todos tus espacios.** te recuerda que una sola conexión sirve en cada workspace donde eres propietario o administrador. Al final de la página, **Qué puedes hacer con el MCP** resume las herramientas, con un enlace, **Ver todas las herramientas**, a la página **Herramientas**.

En un teléfono, la página te pide abrirla en tu computadora para los pasos que la necesitan, como copiar un comando.

***

## Claude (claude.ai y Claude Desktop)

La pestaña **Claude** trae botones que abren Claude en la web (**Abrir Claude**) o en Claude Desktop (**Abrir Claude Desktop**). Los nombres de los botones y menús de Claude están en inglés.

**Paso 3:** En claude.ai, Claude Desktop o Cowork, haz clic en **+** en la caja del chat y luego en **Connectors**, **Add connector** y **Add custom connector**.

**Paso 4:** Usa `dCal` como nombre y pega la dirección MCP, `https://mcp.dcal.ai/mcp`. Deja vacía la configuración avanzada y haz clic en **Add**.

**Paso 5:** Tu navegador abre la página de inicio de sesión. Inicia sesión con tu cuenta de Dapta. De vuelta en Claude, dCal aparece como **Connected**. Abre un chat nuevo y pregunta, por ejemplo, qué reuniones tienes esta semana en dCal.

***

## ChatGPT

La pestaña **ChatGPT** trae un botón **Abrir ChatGPT**. Los nombres de los botones y menús de ChatGPT están en inglés.

**Paso 3:** En la app de escritorio de ChatGPT, cambia a modo **Work**. Abre **Plugins**, haz clic en **Add** y elige **Create MCP App**.

**Paso 4:** Llena el formulario. Name: `dCal`. Server URL: `https://mcp.dcal.ai/mcp`. Deja Authentication en **OAuth**, marca **I understand and want to continue** y créala.

**Paso 5:** Haz clic en **Continue**. Se abre tu navegador: inicia sesión si te lo pide y luego haz clic en **Open ChatGPT** para volver.

**Paso 6:** En **Plugins**, abre la pestaña **Personal**, elige **dCal** y haz clic en **Install plugin**. El navegador se abre una vez más para vincular tu cuenta: haz clic otra vez en **Open ChatGPT**. Ese segundo inicio de sesión es normal.

**Paso 7:** Haz clic en **Try now**, escribe `@dCal` y pregunta.

***

## Claude Code

Es el flujo de inicio de sesión propio de Claude Code: la [documentación de MCP de Claude Code](https://docs.claude.com/en/docs/claude-code/mcp) (en inglés) tiene los detalles.

**Paso 3:** Ejecuta esto una vez en una terminal:

```bash
claude mcp add --transport http --scope user dcal https://mcp.dcal.ai/mcp
```

`--scope user` agrega dCal para todos tus proyectos, y `dcal` es el nombre que Claude Code le da al servidor. Si antes agregaste dCal con otro nombre, como `dapta-calendars`, ese sigue funcionando. Si ya agregaste dCal con una clave bajo el nombre `dcal`, ponle otro nombre a uno de los dos.

**Paso 4:** Abre Claude Code, ejecuta `/mcp`, elige **dcal** y luego **Authenticate**. Inicia sesión en el navegador con tu cuenta de Dapta y vuelve a la terminal.

¿Ya conectaste dCal en Claude? Claude Code con la misma cuenta de Claude también usa ese conector: ejecuta `/mcp` para revisarlo.

***

## Codex

**Paso 3:** En una terminal, ejecuta:

```bash
codex mcp add dcal --url https://mcp.dcal.ai/mcp
```

**Paso 4:** Ejecuta este comando. Se abre tu navegador: inicia sesión y vuelve a la terminal.

```bash
codex mcp login dcal
```

**Paso 5:** Abre Codex y pregunta.

¿Usas la app de escritorio de Codex o ChatGPT? Sigue los pasos de [ChatGPT](#chatgpt).

***

## Cursor

**Paso 3:** Si tienes Cursor instalado, haz clic en **Add to Cursor** en la pestaña. Cursor se abre y te pide confirmar; el enlace lleva solo el nombre del servidor y la dirección MCP. O, en Cursor, abre **Customize**, **MCPs**, **New MCP Server**, elige **User** y pega esto en `mcp.json`:

```json
{
  "mcpServers": {
    "dcal": {
      "url": "https://mcp.dcal.ai/mcp"
    }
  }
}
```

**Paso 4:** **dcal** aparece con **Needs authentication**. Haz clic en **Authenticate**, inicia sesión en el navegador, haz clic en **Allow access** y luego en **Open Cursor**.

**Paso 5:** Abre un **New Chat** y pregunta. Cursor te pregunta antes de usar una herramienta: haz clic en **Run**.

***

## OpenClaw

**Paso 3:** En una terminal, guarda dCal como servidor MCP remoto que inicia sesión con tu cuenta:

```bash
openclaw mcp set dcal '{"url":"https://mcp.dcal.ai/mcp","transport":"streamable-http","auth":"oauth"}'
```

**Paso 4:** Ejecuta este comando. Se abre tu navegador: inicia sesión y vuelve a la terminal. Después, `openclaw mcp status --verbose` muestra dcal como autorizado.

```bash
openclaw mcp login dcal
```

**Paso 5:** Pregúntale a tu agente de OpenClaw.

***

## Hermes

**Paso 3:** Abre `~/.hermes/config.yaml` (o ejecuta `hermes config edit`) y agrega dCal dentro de `mcp_servers`:

```yaml
mcp_servers:
  dcal:
    url: "https://mcp.dcal.ai/mcp"
    auth: oauth
```

**Paso 4:** Ejecuta este comando. Se abre tu navegador: inicia sesión y vuelve a la terminal. Después abre una sesión nueva, o ejecuta `/reload-mcp` en la que tengas abierta.

```bash
hermes mcp login dcal
```

**Paso 5:** Pregúntale a tu agente de Hermes.

***

## Otras apps que admiten inicio de sesión MCP

Cualquier otra app que pueda iniciar sesión en un servidor MCP solo necesita la dirección. Agrega `https://mcp.dcal.ai/mcp` como conector o servidor MCP sin clave, elige el inicio de sesión (a menudo llamado OAuth) si la app pregunta cómo autenticarse, e inicia sesión con tu cuenta de Dapta cuando la app te lo pida. Sigue las instrucciones de la propia app para saber dónde agregarlo.

***

## Comprueba la conexión

En **Conecta tu agente**, debajo de **Pruébalo**, haz clic en **Copiar prompt** y pega el prompt en tu app:

> ¿Qué reuniones tengo esta semana en dCal?

El prompt solo lee, así que nunca agenda nada. Para ver en qué workspace y con qué acceso está la conexión, pregúntale al asistente a qué workspace está conectado: llama a la herramienta `whoami` y te dice el workspace, su propietario y lo que puede hacer. Un inicio de sesión aparece ahí con un nombre que empieza con `login:` en lugar del prefijo de una clave, y con los cinco tipos de acceso.

***

## Si perteneces a varios workspaces

Un inicio de sesión llega a cada workspace de dCal donde eres propietario o administrador y abriste dCal en la web en los últimos 30 días. Si es solo uno, el asistente lo usa sin preguntar. Si son varios, tu app te pregunta en cuál trabajar, y para cambiar solo dices "cambia a" y el nombre del workspace. Por dentro, cada llamada tiene que decir en qué workspace actúa:

* El asistente llama a `list_my_accounts` para obtener el nombre y el ID de cada workspace, y después envía el ID elegido como `account_id` en sus llamadas.
* Si una llamada no lo dice, dCal responde `ACCOUNT_REQUIRED` con la lista de tus workspaces, para que el asistente te pregunte y lo intente de nuevo.
* Lo más fácil es decirle al asistente desde el principio qué workspace usar, por su nombre.

Las herramientas que funcionan en una página de reservas pública toman el workspace del enlace y nunca necesitan `account_id`. La [Referencia de herramientas MCP](https://docs.dapta.ai/dapta-docs-es/dcal/developers/mcp-tools.md) tiene los detalles.

***

## Qué puede hacer la conexión

Un inicio de sesión actúa con tu acceso de propietario o administrador, así que puede usar todas las herramientas en todos los tipos de evento del workspace: buscar horarios libres, apartar un horario, reservar, mover una reserva, confirmar o rechazar solicitudes, cancelar y leer reservas, incluido lo que escribieron tus invitados. No puede editar tipos de evento, horarios ni ajustes, ni gestionar webhooks, claves, miembros o equipos. La página **Herramientas** del menú de la izquierda muestra todo lo que puede hacer, en palabras sencillas.

* **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. Cancelar y rechazar no se pueden deshacer.
* **Algunas acciones están marcadas como destructivas.** dCal marca como destructivas mover, rechazar y cancelar una reserva. Las apps que respetan esa marca te preguntan antes de usarlas.
* **Para un acceso más acotado, usa una clave.** Para un asistente que solo deba leer, o trabajar solo con algunos tipos de evento, crea una [clave de API](https://docs.dapta.ai/dapta-docs-es/dcal/developers/api-keys.md).
* **Sigue funcionando mientras sigas siendo propietario o administrador.** Si pasas 30 días sin abrir dCal en la web en un workspace, la conexión deja de llegar a ese workspace hasta que vuelvas a abrir dCal ahí. Cuando no llega a ningún workspace, las llamadas del asistente responden `NOT_LINKED`. No necesitas reconectar.

***

## Desconectar

* **Tu propia conexión:** elimina el conector de dCal en la app. dCal no lista las apps conectadas con inicio de sesión, así que siempre desconectas desde la app.
* **La conexión de otra persona:** un propietario puede cortarla al instante quitándole a esa persona el rol de administrador, o sacándola del workspace, en **Ajustes** > **Miembros**. La siguiente llamada del asistente se rechaza. Mira [Miembros y roles](https://docs.dapta.ai/dapta-docs-es/dcal/account/members-and-roles.md).

***

## Solución de problemas

Estos mensajes de dCal están en inglés.

| Qué ves                                                                                                        | Qué hacer                                                                                                                                                                                                                                                                                                                                                                                                                             |
| -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| El asistente muestra `NOT_LINKED` y `This sign-in is not an owner or admin of any account on this server yet.` | Abre dCal en la web, en [app.dcal.ai](https://app.dcal.ai), con la misma cuenta de Dapta (vuelve a iniciar sesión si ya está abierta) y pregunta otra vez. No necesitas reconectar: la siguiente llamada funciona. Si sigue fallando, pídele a un propietario que revise en **Ajustes** > **Miembros** que seas administrador o propietario. Mientras tanto, las herramientas de las páginas de reservas públicas siguen funcionando. |
| La app te pide iniciar sesión otra vez, o muestra `Invalid or expired access token.`                           | Reconecta el conector e inicia sesión de nuevo.                                                                                                                                                                                                                                                                                                                                                                                       |
| El asistente muestra `ACCOUNT_REQUIRED`                                                                        | Perteneces a varios workspaces. Dile al asistente cuál usar.                                                                                                                                                                                                                                                                                                                                                                          |
| El asistente trabaja en el workspace equivocado                                                                | Dile el workspace por su nombre, o pídele que llame primero a `list_my_accounts`.                                                                                                                                                                                                                                                                                                                                                     |
| Iniciaste sesión con otra cuenta de Dapta                                                                      | Elimina el conector, agrégalo de nuevo e inicia sesión con la cuenta que usas en dCal.                                                                                                                                                                                                                                                                                                                                                |

## Relacionado

* [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, la conexión con una clave de API y el skill para agentes.
* [Referencia de herramientas MCP](https://docs.dapta.ai/dapta-docs-es/dcal/developers/mcp-tools.md): cada herramienta, sus entradas y sus errores.
* [Claves de API](https://docs.dapta.ai/dapta-docs-es/dcal/developers/api-keys.md): un acceso más acotado para un asistente o para tus propios sistemas.
* [Miembros y roles](https://docs.dapta.ai/dapta-docs-es/dcal/account/members-and-roles.md): quién es propietario o administrador.
* [Seguridad y privacidad](https://docs.dapta.ai/dapta-docs-es/dcal/security-and-privacy.md): cómo se protegen los datos de tus invitados.


---

# 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/connect-with-sign-in.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.
