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.

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.

---

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.

El material anterior de Dapta llamaba "skills" a las guías. Son lo mismo. Ya no hay ningún paquete de skills que descargar.

---

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

Configuración y Conexión