Dvina MCP

Usa el comando dvina

Descubre qué hace el comando dvina cuando Dvina ejecuta código por ti, qué comandos incluye y cuáles te piden aprobación.

Ver como Markdown

Cuando Dvina ejecuta código o comandos por ti, dispone de un comando propio: dvina. Con él, un script o una secuencia de pasos puede buscar en tu Dvina, leer y añadir documentos, memoria y tareas, y comprobar quién tiene acceso a un elemento, actuando en tu nombre.

No tienes que instalar nada ni iniciar sesión. Dvina usa el comando cuando tu solicitud lo requiere, y también puedes pedírselo, por ejemplo: "Usa dvina para listar mis tareas y escribir un resumen como nota".

Cómo funciona

  • dvina actúa en tu propio Dvina, en tu nombre, con los permisos de tu rol y dentro de tus límites habituales.
  • Su acceso dura solo mientras Dvina trabaja en tu solicitud. Cuando termina la respuesta, el comando ya no puede acceder a tu Dvina.
  • Solo lee un archivo o una carpeta cuando un comando lo especifica, como un archivo que se va a subir.

Comandos

Los comandos se organizan en grupos: dvina <group> <command>, seguido de los argumentos y las opciones del comando.

Grupo Comandos
search dvina search <query>: busca en tus chats, documentos, memoria y mundo a la vez.
memory ls, show, add, edit: lista, lee, añade o modifica tus archivos de memoria.
world topics, topic, recall, feed: tus temas, lo que Dvina sabe sobre algo y tu Feed.
docs ls, show, read, search, create, upload, update, mv, mkdir, rm: los documentos y las carpetas de tu Biblioteca.
canvas ls, show, create, write-page: lista, lee, crea o reescribe páginas de canvas.
tasks ls, show, start, continue, stop: tus tareas en segundo plano.
goals show, start: tareas que trabajan para alcanzar un objetivo.
schedule ls, add, cancel: mensajes y recordatorios programados, únicos o recurrentes.
agents ls, show, create, update: tus agentes.
skills ls, show, add, edit: tus habilidades.
projects ls, show: tus proyectos.
settings get, set: tus preferencias, como activar o desactivar la memoria.
share state, with-me, add, rm: quién tiene acceso a un elemento, qué han compartido otros contigo y cómo conceder o retirar el acceso.

dvina no puede eliminar nada de forma permanente, abrir enlaces públicos, conectar o desconectar aplicaciones, ni cambiar la configuración de administración o facturación.

Ayuda y resultados

  • dvina --help muestra los grupos, dvina <group> --help muestra los comandos de un grupo y dvina <group> <command> --help muestra los argumentos y las opciones de un comando.
  • Los resultados se muestran como texto breve. Añade --json para obtener JSON, o --fields con una lista separada por comas, como --fields id,title, para conservar solo algunos campos.
  • Una lista larga termina con next: --cursor <c>. Vuelve a ejecutar el comando con ese --cursor para obtener la siguiente página.
  • Para leer un valor de un archivo, añade -file a su opción, como en --content-file notes.md. dvina docs upload <file> sube un archivo y dvina skills add <folder> añade una carpeta de habilidad con su SKILL.md.

Códigos de salida

Código Significado
0 Completado.
1 Se ha producido otro error.
2 El comando es incorrecto. Consulta su --help.
3 No se ha encontrado.
4 Denegado: tus permisos de acceso, las normas de tu empresa o la protección de datos no lo permiten.
5 Necesita tu aprobación.
6 Has alcanzado tu límite de uso.

Aprueba los cambios

  • Los comandos de lectura se ejecutan sin pedirte aprobación.
  • Los comandos que añaden algo nuevo, como docs create, memory add o tasks start, se ejecutan sin pedirte aprobación. Nunca modifican lo que ya existe.
  • Los comandos que modifican o eliminan algo te piden aprobación primero: mover, cambiar de nombre, mover a la papelera, reemplazar una nota o un archivo de memoria, reescribir una página de canvas, modificar un agente o una habilidad, detener una tarea, cancelar un mensaje programado y compartir. Dvina muestra una tarjeta de aprobación en el chat con su propio resumen del cambio y te pide aprobación cada vez. Si lo rechazas, no cambia nada.

Todo lo que dvina añade o modifica pasa por las normas de protección de datos de tu empresa y queda registrado en tu registro de auditoría, igual que las demás acciones de Dvina.