> 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/dapta-mcp/key-concepts.md).

# Conceptos Clave

Las ideas que hacen que el Dapta MCP encaje: dos formas de autenticarte, cómo se elige el workspace, herramientas y guías, y el modelo de seguridad de vista previa y luego confirmación.

Unas pocas ideas explican cómo se autentica la conexión, cómo sabe Claude qué hacer y cómo se mantienen seguros tus datos.

***

## 1. Dos formas de autenticarte

* **Inicia sesión con tu cuenta de Dapta.** Recomendado para personas. Tu cliente de IA abre la página de inicio de sesión de Dapta una vez (tu correo y un código de 6 dígitos) y conserva un token. No hay ninguna clave que copiar. Claude, ChatGPT, Codex y Cursor lo soportan, y es lo que usa el directorio de conectores de Claude. Iniciar sesión llega a los workspaces donde eres propietario o admin.
* **Clave de API.** Para scripts, automatizaciones o una conexión fija a un workspace. El propietario del workspace crea las claves en el panel de administración de Dapta. Un workspace puede tener hasta 10 claves, cada una con su propio nombre, y cada clave se muestra una sola vez.

{% hint style="warning" %}
Trata una clave de API como una contraseña. Si alguna vez queda expuesta, revócala y crea una nueva. Revocar una clave no afecta a tus otras claves.
{% endhint %}

***

## 2. ¿En qué workspace estoy?

* **Con una clave de API,** el workspace queda fijado por la clave. Claude nunca pregunta.
* **Con un inicio de sesión,** puedes tener varios workspaces. Claude los lista por nombre y te pregunta cuál usar, y luego lo sigue usando durante la conversación. Di "cambia a \<workspace>" para cambiar.

Cada respuesta empieza con el workspace en el que se ejecutó, así que siempre sabes dónde estás.

***

## 3. Herramientas y guías

* Las **herramientas** son las acciones básicas: leer una llamada, actualizar un agente, modificar un flujo.
* Las **guías** son los flujos de trabajo que orquestan herramientas para tareas reales. Una guía le dice a Claude los pasos, el orden de las herramientas y los puntos en los que debe confirmar contigo.

Claude carga una guía con la herramienta `get_guidance` cuando una tarea abarca varias herramientas. Nunca tienes que pedirla, y no hay nada que instalar: las guías las sirve el servidor del Dapta MCP.

{% hint style="info" %}
El material anterior de Dapta llamaba "skills" a las guías. Son lo mismo. Ya no hay ningún paquete de skills que descargar.
{% endhint %}

***

## 4. Vista previa y luego confirmación

Esta es la idea más importante para confiarle tu workspace a Claude.

* **Las lecturas ocurren directamente.** Preguntar "¿cuántas llamadas recibí esta semana?" devuelve la respuesta. Nada cambia, así que no hay nada que confirmar.
* **Las escrituras vienen en pares `preview_*` / `commit_*`.** La vista previa muestra exactamente qué va a cambiar y devuelve un token de un solo uso. No se escribe nada hasta que dices que sí y se ejecuta el commit correspondiente.

Tres herramientas actúan sin vista previa: `create_voice_agent` crea un agente nuevo y no cambia nada de lo que ya existe (Claude confirma los detalles contigo antes), `discard_text_agent_draft` descarta un borrador sin publicar y `chat_with_text_agent` hace una conversación de prueba con un agente de texto.

### Un ejemplo

Tú dices: *"Mi agente habla muy rápido, hazlo más lento."*

1. Claude carga la guía de configuración de agentes de voz con `get_guidance`.
2. Lee el agente con `get_agent` para ver la velocidad actual.
3. Llama a `preview_update_voice_agent` con el nuevo valor. El servidor responde con una comparación de antes y después y un token de vista previa de un solo uso.
4. Claude te muestra la comparación y te pide un sí.
5. Con tu sí, llama a `commit_update_voice_agent` con el token. El servidor vuelve a leer el agente y confirma lo que se escribió.

***

## 5. Indicadores de las herramientas

Cada herramienta declara si solo lee, agrega datos, o cambia y elimina datos existentes, y si puede actuar fuera de Dapta, por ejemplo al ejecutar un flujo o poner llamadas en cola. Tu cliente de IA usa estos indicadores para decidir cuándo preguntarte antes de actuar, y claude.ai agrupa por separado las herramientas de solo lectura.

***

## Siguiente paso

{% content-ref url="/pages/aAmriQJJuxW026bjo0mX" %}
[Configuración y Conexión](/dapta-docs-es/dapta-mcp/setup.md)
{% endcontent-ref %}


---

# 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/dapta-mcp/key-concepts.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.