# Usa Dvina desde otras apps con MCP > Conecta un cliente MCP como Claude Code, ChatGPT o Cursor a Dvina, inicia sesión y permite que lea y añada contenido a tu Dvina con tu aprobación. Dvina tiene su propio servidor MCP. Conecta un cliente MCP, como Claude Code, ChatGPT o Cursor, y esa app podrá buscar en tu Dvina, leer tus documentos y tu memoria, y añadir notas, tareas y recordatorios en tu nombre. ## Antes de empezar Necesitas la dirección del servidor: ```text https://api.dvina.ai/mcp ``` Si tu empresa ejecuta Dvina en sus propios servidores, usa la dirección de la API de Dvina de tu empresa con `/mcp` al final. Pídesela a tu administrador. El servidor usa Streamable HTTP. Si el cliente te pide que elijas un transporte, selecciona HTTP. ## Conecta un cliente ::: tabs === Claude Code 1. En tu terminal, ejecuta: ```sh claude mcp add --transport http dvina https://api.dvina.ai/mcp ``` 2. Inicia Claude Code, ejecuta `/mcp`, selecciona **dvina** e inicia sesión en Dvina. === ChatGPT 1. Abre la sección de ChatGPT donde puedes añadir un servidor MCP. 2. Introduce `https://api.dvina.ai/mcp` como dirección del servidor y elige OAuth si te pregunta cómo iniciar sesión. 3. Inicia sesión en Dvina cuando ChatGPT te lo pida. === Cursor 1. Abre la sección de Cursor donde puedes añadir un servidor MCP. 2. Añade un servidor llamado `dvina` con la dirección `https://api.dvina.ai/mcp`. 3. Inicia sesión en Dvina cuando Cursor te lo pida. ::: No necesitas un ID de cliente ni un secreto. El cliente se registra automáticamente en Dvina la primera vez que se conecta. ## Inicia sesión El servidor MCP de Dvina usa OAuth para que inicies sesión en tu navegador: 1. Inicia sesión en Dvina como lo haces habitualmente. 2. Si perteneces a más de un espacio de trabajo, elige uno en **Seleccionar espacio de trabajo** y luego selecciona **Continuar**. El cliente solo funciona en ese espacio de trabajo. 3. En **Autorizar acceso**, comprueba el nombre de la app y luego selecciona **Permitir acceso**. Selecciona **Denegar** si no la reconoces. El cliente permanece conectado, así que no tienes que iniciar sesión cada vez. ## Qué puede hacer un cliente El cliente ve las herramientas de Dvina y las usa cuando tu solicitud lo requiere: | Área | Qué puede hacer el cliente | | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | **Búsqueda** | Buscar en tus chats, documentos, memoria y mundo a la vez. | | **Memoria** | Listar y leer tus archivos de memoria, añadir uno nuevo o modificar uno. | | **Mundo** | Listar tus temas, mostrar lo que Dvina sabe sobre un tema o cualquier otra cosa y listar tu Feed. | | **Documentos** | Listar, leer y buscar en tu Biblioteca, crear notas y carpetas, subir archivos y reemplazar, mover o renombrar un documento, o enviarlo a la papelera. | | **Lienzo** | Listar y leer tus lienzos, crear un lienzo o reescribir una página. | | **Tareas y objetivos** | Listar tus tareas y leer lo que hicieron, iniciar una tarea o una tarea orientada a un objetivo, enviar más trabajo a una tarea o detenerla. | | **Mensajes programados** | Listarlos, programar un mensaje o recordatorio, puntual o recurrente, o cancelarlo. | | **Agentes y habilidades** | Listar y leer tus agentes y habilidades, crear un agente, añadir una habilidad o modificar cualquiera de ellos. | | **Proyectos** | Listar tus proyectos y mostrar la carpeta y las tareas recientes de un proyecto. | | **Uso compartido** | Ver quién tiene acceso a un elemento y qué han compartido otros contigo, o conceder o retirar el acceso a alguien. | | **Ajustes** | Mostrar tus preferencias o activar o desactivar la memoria. | El cliente no puede eliminar nada de forma permanente, abrir enlaces públicos, conectar o desconectar aplicaciones ni cambiar los ajustes de administración o facturación. ## Aprobar cambios Lo que hace el cliente sigue las mismas reglas que el resto de Dvina: - Las lecturas se realizan sin pedir confirmación. - Añadir algo nuevo, como una nota, un archivo de memoria o una tarea, se realiza sin pedir confirmación. Nunca modifica lo que ya existe. - Modificar o quitar algo, como enviar un documento a la papelera, reescribir una página de un lienzo, detener una tarea o compartir un elemento, requiere tu confirmación previa. El cliente muestra el resumen del cambio que genera Dvina y tú lo apruebas o lo rechazas. Si lo rechazas, no cambia nada. > [!NOTE] > Si un cliente no puede pedirte confirmación, Dvina no realiza el cambio solicitado desde ese cliente. Haz el cambio en la aplicación de Dvina o usa un cliente que pueda pedirte confirmación. ## Tu acceso y las reglas de tu empresa El cliente actúa en tu nombre, con acceso a lo que puedes ver y hacer en Dvina: - Solo funciona mientras sigas siendo miembro del espacio de trabajo y únicamente con lo que permite tu rol. - Si tu administrador desactiva una función, como la subida de archivos, el cliente tampoco puede usarla. - Lo que el cliente añade o modifica pasa por las reglas de protección de datos de tu empresa, igual que en la aplicación. - Lo que añade o modifica queda registrado en tu [registro de auditoría](/docs/teams/audit-log) como una acción del asistente en tu nombre, junto con el cliente del que procede. - Lo que hace se contabiliza en tu uso, dentro de tus límites habituales. ## Conectar con una clave de API en lugar de OAuth En el plan Enterprise, un cliente puede conectarse con un token de acceso personal en lugar de iniciar sesión. Usa esta opción para un cliente que no pueda iniciar sesión con OAuth o para un script. 1. Abre Ajustes y selecciona **Acceso a la API**. 2. En **Tokens de acceso personal**, selecciona **Crear token**. 3. Introduce un **Nombre**, elige el **Acceso** y cuándo **Caduca**, y selecciona **Crear token**. 4. En **Copia tu token**, copia el token. Solo se muestra esta vez. Elige el acceso que necesita el cliente: - **Solo lectura:** el cliente solo ve las herramientas de lectura. Puede buscar y leer en tu Dvina, pero no puede añadir ni modificar nada. - **Lectura y escritura:** el cliente ve todas las herramientas y los cambios siguen requiriendo tu aprobación, igual que con OAuth. Envía el token en la cabecera `Authorization`, después de `Bearer`. Por ejemplo, en Claude Code: ```sh claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer " ``` En otro cliente, añade la misma cabecera donde te permita configurar las cabeceras de un servidor MCP. El token actúa en tu nombre, en el espacio de trabajo donde lo creaste y con el rol que tengas allí en ese momento. Para reemplazarlo, ábrelo en **Tokens de acceso personal** y selecciona **Rotar…**: un token nuevo lo sustituye y el anterior deja de funcionar de inmediato. Para desactivarlo, selecciona **Revocar…**: todo lo que lo use deja de funcionar de inmediato. Para obtener más información sobre los tokens, consulta [Acceso a la API](/docs/dvina-mcp/api-access). ## Contenido relacionado - [Aplicaciones personalizadas y servidores MCP](/docs/connectors/custom-apps) - [Acceso a la API](/docs/dvina-mcp/api-access) - [Usar el comando dvina](/docs/dvina-mcp/cli) - [Descripción general de los equipos](/docs/teams/overview)