Dvina MCP

Usar el acceso a la API

Crea tokens de acceso personal para scripts y clientes MCP, y envía los eventos de tu Livespace a tus propios sistemas mediante webhooks.

Ver como Markdown

En Ajustes › Acceso a la API, puedes crear tokens de acceso personal para que un script o un cliente MCP use Dvina en tu nombre. Los administradores también pueden añadir webhooks desde ahí para enviar los eventos del Livespace a sus propios sistemas.

El acceso a la API está incluido en el plan Enterprise. Cada miembro puede crear sus propios tokens; solo los propietarios y administradores ven Webhooks.

Crear un token

  1. Abre Ajustes y elige Acceso a la API.
  2. En Tokens de acceso personal, elige Crear token.
  3. Introduce un Nombre para identificar más adelante qué lo usa.
  4. Elige el Acceso: Solo lectura o Lectura y escritura.
  5. Elige cuándo Caduca: En 30 días, En 90 días, En 365 días o Nunca caduca.
  6. Elige Crear token.
  7. En Copia tu token, copia el token y guárdalo en un lugar seguro. Solo se muestra esta vez.

Un token actúa en tu nombre, en el Livespace donde lo creaste y con el rol que tengas allí en ese momento. Un token de Solo lectura puede leer, pero no puede añadir ni cambiar nada.

Para usar un token con un cliente MCP, consulta Conectar con una clave de API en lugar de OAuth.

Consultar, rotar o revocar un token

Tus tokens aparecen en Tokens de acceso personal, junto con su nivel de acceso. Elige uno para ver por qué caracteres Empieza, su Acceso, cuándo fue su Último uso y cuándo Caduca.

  • Para sustituir un token, elige Rotar… y luego Rotar para confirmar. Un nuevo token lo sustituye y el anterior deja de funcionar de inmediato. Copia el nuevo token en Copia tu token.
  • Para desactivar un token, elige Revocar… y luego Revocar para confirmar. Todo lo que lo use deja de funcionar de inmediato.

La creación, rotación y revocación de tokens quedan registradas en el registro de auditoría.

Añadir un webhook

Un webhook envía los eventos del Livespace, los mismos registros que aparecen en el registro de auditoría, a la dirección que elijas.

  1. En Ajustes › Acceso a la API, dentro de Webhooks, elige Añadir webhook.
  2. Introduce un Nombre y la URL. Usa una URL HTTPS pública.
  3. En Eventos, deja el campo vacío para recibir todos los eventos o indica acciones y áreas, como member.added o sharing.*.
  4. Elige Añadir.
  5. En Copia el secreto de firma, copia el secreto. Solo se muestra esta vez.

Si Dvina indica No se puede acceder a esta dirección desde Dvina, usa una URL HTTPS pública.

Comprobar la firma de cada solicitud

Dvina envía los eventos por lotes, en formato JSON, y firma cada solicitud. Usa el secreto de firma para comprobar que una solicitud proviene de Dvina:

  • Cada solicitud incluye una cabecera X-Dvina-Signature con un valor como t=<timestamp>,v1=<signature>.
  • La firma es un HMAC-SHA256, en hexadecimal, de la marca de tiempo, un punto y el cuerpo de la solicitud, generado con tu secreto de firma.
  • Calcúlala y compárala con la recibida. Rechaza cualquier solicitud cuya firma no coincida o cuya marca de tiempo sea demasiado antigua.

Consulta o modifica un webhook

Tus webhooks aparecen en Webhooks con su estado: Activo, En pausa o Con errores. Selecciona uno para ver sus detalles.

  • Para modificarlo, edita su Nombre, URL o Eventos y selecciona Guardar.
  • Para pausarlo, desactiva Enviar eventos. Vuelve a activarlo para reanudar el envío.
  • Para comprobar cómo funciona, consulta su Estado y cuántos eventos se han Enviado. Si un webhook falla, muestra su Último error. Dvina sigue intentándolo y registra el fallo en el registro de auditoría.
  • Para cambiar su secreto, selecciona Nuevo secreto de firma… y confirma. Las solicitudes se firman con el nuevo secreto de inmediato, así que actualiza el receptor enseguida.
  • Para eliminarlo, selecciona Eliminar… y luego Eliminar para confirmar. No se le enviará nada más.