DocsIntegraciones

Servidor MCP

Configurar la conexión

El servidor MCP permite usar clientes externos; es distinto de añadir herramientas al chat de Veta.

  1. Crea acceso desde Compartir, limitado al proyecto o taller.
  2. En tu cliente MCP, añade un servidor remoto Streamable HTTP con URL https://veta.ruso.dev/api/mcp.
  3. Configura Authorization: Bearer <código de acceso> mediante el almacén de secretos de tu cliente. No publiques el código.
  4. Conecta y consulta capacidades y proyectos.

Permisos de la invitación que delimitan el acceso del agente

El ID del proyecto no sustituye al código de acceso.

Herramientas disponibles

HerramientaFunción
veta_read_stateLeer revisiones, borradores disponibles, entidades y trabajos.
veta_inspect_sceneConsultar caras, mecanizados y orientación en coordenadas globales, locales o de un plano.
veta_calculateCalcular aritmética, unidades, vectores y ángulos de forma determinista.
veta_measureMedir sólidos colocados, límites y ángulos sobre una instantánea.
veta_check_requirementsComprobar dimensiones, holguras y colocación con tolerancias explícitas.
veta_preview_changeValidar cambios atómicos y revisar sus efectos sin guardar.
veta_apply_changeGuardar la propuesta exacta con revisión, fingerprint e identificador de operación.
veta_exportExportar archivos vinculados a una revisión o plano.

MCP consulta geometría guardada sin navegador. source:editor inspecciona borradores en cualquier sección. Descúbrelos con collection:editors; selecciona editorId si hay varios. Conserva editorId y sceneRef: cambios o desconexiones invalidan referencias, sin sustituir borradores. Cámara y visibilidad requieren visor. Contacto no acredita unión resistente; resultados parciales no acreditan cumplimiento.

Ante un conflicto, lee la revisión actual y prepara otra propuesta.

Diagnosticar acceso

Inicializa MCP y lista herramientas; un GET no basta. Un 401 indica acceso rechazado; 403, permisos insuficientes. Las invitaciones revocadas o caducadas no permiten acceso.

Un cliente con solo transporte de terminal necesita un adaptador; esta URL no es un comando stdio ni un flujo OAuth.