Saltar al contenido

01IA e integraciones · módulo

MCP para agentes de IA externos

Conecte Claude Code, Codex y otros agentes a su ERP bajo los permisos de un usuario específico

  • Clave de API
  • Token de acceso personal
  • Token de MCP
  • Conversación de IA
13
capacidades
4
tipos de registro
3
automatizaciones
12
integraciones y herramientas de IA

02Qué hace el módulo

Menos rutina. Más valor.

MCP (Model Context Protocol) permite que agentes de IA externos como Claude Code o Codex trabajen con los datos de Draivix. El agente recibe el mismo catálogo de herramientas que el asistente integrado, y cada llamada se ejecuta bajo los permisos y la clave de API de un usuario concreto. Su empresa puede conectar sus propios agentes sin eludir los controles de acceso ni los registros de auditoría.

  • El agente sabe qué puede invocarUn agente de IA externo descarga un catálogo de herramientas completo con descripciones de entradas y salidas. Sus agentes trabajan con los datos sobre una interfaz documentada en lugar de hacerlo a ciegas.
  • 85 herramientas en un único punto de conexiónA través de un solo punto de conexión, un agente puede acceder a las 85 herramientas habilitadas del asistente integrado, lo que simplifica enormemente las integraciones de agentes personalizados.
  • Salvaguarda integrada para propuestas de cambioLas escrituras a través de la pasarela de capacidades devuelven una propuesta por defecto. El agente o un usuario pueden confirmarla con mutation_confirm o cancelarla con mutation_cancel.
  • Claves limitadas a herramientas seleccionadasLa clave de API que utiliza un agente para autenticarse puede restringirse a una lista específica de herramientas. El agente obtiene únicamente lo que su empresa autoriza y nada más.
  • Clave fijada permanentemente al modo de sala limpiaUna clave de API puede fijarse de forma permanente al modo de sala limpia para trabajar con datos confidenciales. Dicha clave solo verá en el catálogo las herramientas aptas para sala limpia.
  • Los agentes nunca superan los permisos del usuarioEl acceso efectivo de un agente es la intersección entre los permisos del usuario y el límite máximo de la clave de API. El agente solo puede hacer lo que ambos permitan, y la clave nunca desbloquea ningún registro por sí sola.
  • Servidor dedicado para sus agentesEl servidor MCP (Model Context Protocol) independiente newerp-agents-mcp ofrece 53 herramientas construidas sobre la REST API. Sus escrituras se ejecutan de inmediato dentro de los permisos del usuario, sin propuestas de aprobación previa.
  • Autenticación adaptada al agenteUn agente inicia sesión con un token transferido, un token de acceso personal o firmando un desafío con una clave SSH, siendo esta última opción ideal para agentes de línea de comandos.
  • Trabajo del agente trazable en la propia tarea12 herramientas vinculan el trabajo del agente con tareas y commits de código en GitLab, para que pueda ver exactamente qué hizo el agente directamente en la ficha de la tarea.
  • Herramientas de chat y documentos bajo demandaEl servidor puede ampliarse con herramientas opcionales para Mattermost y análisis de documentos impulsado por Gemini (que requiere una clave de API de Gemini). Active únicamente lo que realmente utilice.
  • Cada llamada queda registrada en la auditoríaTodas las llamadas de los agentes se anotan en el registro de auditoría con el origen mcp, de modo que siempre podrá distinguir qué hizo un agente externo frente a lo que hizo una persona en la aplicación.
  • Limitado a 600 llamadas por minutoLa pasarela de capacidades —la interfaz para agentes integrada directamente en Draivix— está limitada a 600 llamadas por minuto, manteniendo la carga generada por los agentes dentro de unos límites claros.
  • Transferencia de conversaciones a HermesUna conversación del asistente puede transferirse al servicio de agentes Hermes mediante una credencial temporal de 300 segundos. Se ejecuta bajo los permisos del usuario que inició la conversación y queda registrada en la pista de auditoría.

03Cómo funciona

Cómo funciona paso a paso.

  1. Dos vías de conexión para los agentes

    La primera vía es la pasarela de capacidades (capability bridge) integrada directamente en Draivix. El agente descarga el catálogo de herramientas y las invoca a través de un único punto de conexión. El catálogo incluye las herramientas permitidas del asistente integrado (85 de las aproximadamente 100 herramientas registradas) más nueve acciones adicionales: confirmar o cancelar una propuesta de cambio, editar elementos dentro de una propuesta masiva, enviar un correo electrónico y cerrar un lienzo visualizado. El catálogo está versionado; si nada ha cambiado, el servidor responde que está actualizado para que el agente no tenga que volver a descargarlo.

    Leer en detalle

    La segunda vía es el servidor MCP independiente newerp-agents-mcp, que encapsula la REST API general para agentes de programación y operaciones. Proporciona 53 herramientas: gestión de registros y metadatos, relaciones, archivos adjuntos, correo electrónico, tareas, actividades e informes, búsqueda global, calendario, 12 herramientas para vincular el trabajo del agente con tareas y commits en GitLab y, opcionalmente, 7 herramientas para Mattermost. La herramienta de análisis de documentos requiere una clave de API de Gemini. El servidor funciona mediante stdio o HTTP y recorta las respuestas para que quepan en la ventana de contexto del modelo.

  2. Permisos y claves de API

    Un agente actúa siempre en nombre de un usuario específico. El permiso de la pasarela de capacidades únicamente permite que la clave acceda a la interfaz; por sí solo, no concede acceso a ningún registro. El acceso efectivo es la intersección entre los permisos del usuario y el límite máximo de la clave de API. Una clave puede restringirse a una lista concreta de herramientas y fijarse de forma permanente al modo de sala limpia; dicha clave solo verá en el catálogo las herramientas autorizadas para sala limpia.

    Leer en detalle

    El servidor newerp-agents-mcp no tiene permisos propios: cada llamada incluye un token de usuario y pasa por la REST API estándar. Los agentes pueden autenticarse mediante un token portador (bearer token), un token de acceso personal o firmando un desafío con una clave SSH, lo que resulta ideal para agentes de línea de comandos.

    La pasarela de capacidades tiene un límite de velocidad de 600 llamadas por minuto. Cada llamada se ejecuta dentro de un contexto de auditoría etiquetado con el origen mcp y un identificador de traza. Además, se indica al agente si una herramienta modifica datos mediante una pista estándar de MCP (solo lectura o modificación).

  3. Control de cambios

    La pasarela de capacidades sigue la misma regla que el asistente integrado: las herramientas de creación, actualización y eliminación devuelven por defecto una propuesta. Tanto el agente como una persona pueden confirmarla mediante mutation_confirm o cancelarla mediante mutation_cancel. Al confirmar, la operación real se vuelve a ejecutar bajo los permisos del usuario.

    Leer en detalle

    El servidor newerp-agents-mcp no utiliza propuestas ni modo de sala limpia. Sus escrituras se ejecutan de inmediato, siempre dentro de los permisos del usuario cuyo token está utilizando el agente. Para aquellos agentes en los que desee aprobar cada cambio, utilice en su lugar la pasarela de capacidades.

  4. Delegación al servicio de agentes Hermes

    Una conversación iniciada en el asistente integrado puede transferirse al servicio de agentes Hermes. Hermes recibe una credencial temporal válida durante 300 segundos, vinculada a la empresa, y realiza las llamadas de vuelta a través de la pasarela de capacidades. Las llamadas se ejecutan con los permisos del usuario que inició la conversación, sin posibilidad de ampliar las restricciones del modo de sala limpia. Cada llamada delegada se registra en el historial de auditoría como relevante para la seguridad.

04Qué se ejecuta automáticamente

Automatizaciones que ahorran tiempo.

  1. Sin descargas redundantes del catálogo

    El catálogo de herramientas se almacena en caché durante 15 minutos por empresa y versión. Cuando un agente se conecta y el catálogo no ha cambiado, el servidor no lo reenvía y el agente no tiene que descargarlo de nuevo.

  2. Una pista de auditoría para cada llamada

    Cada llamada de un agente crea automáticamente una entrada en el registro de auditoría etiquetada con el origen mcp y un identificador de traza, lo que facilita consultar cualquier acción específica más adelante.

  3. Las credenciales caducan automáticamente

    Cuando se transfiere una conversación, el servicio Hermes recibe una credencial vinculada a la empresa que caduca a los 300 segundos, garantizando un acceso estrictamente temporal.

Integraciones externas

  • Claude Code como agenteConecte Claude Code a Draivix mediante MCP (Model Context Protocol). Trabaja con los datos bajo los permisos y la clave de API de un usuario específico, sin eludir los permisos ni el registro de auditoría.
  • Codex bajo las mismas reglasCodex se conecta a Draivix mediante MCP y recibe el mismo catálogo de herramientas que el asistente integrado. Cada llamada se ejecuta bajo los permisos de un usuario concreto.
  • Hermes toma el relevo de la conversaciónEl servicio de agentes Hermes recibe una conversación transferida desde el asistente y responde a través de la pasarela de capacidades. El modo de sala limpia no se puede relajar y cada llamada queda anotada en el registro de auditoría.
  • Análisis de documentos mediante GeminiEl servidor newerp-agents-mcp incluye una herramienta de análisis de documentos impulsada por Gemini (requiere una clave de API de Gemini), lo que permite al agente trabajar también con el contenido de los documentos.
  • El trabajo del agente junto a los commitsLas herramientas de newerp-agents-mcp vinculan el trabajo del agente con las tareas y los commits en GitLab, para que pueda rastrear lo que hizo el agente directamente en la tarea correspondiente.
  • Mattermost cuando lo necesiteEl servidor newerp-agents-mcp puede ampliarse con 7 herramientas opcionales de Mattermost, permitiendo que el agente interactúe con el chat del equipo siempre que su empresa lo requiera.

Lo que gestiona el agente de IA

  • Acceso a datos para sus agentes

    Un agente externo puede leer, buscar y contar registros de cualquier entidad (tipo de registro), viendo únicamente aquello a lo que el usuario y su clave de API tienen acceso permitido.

  • Los cambios comienzan como propuestas

    A través de la pasarela de capacidades, un agente solo propone por defecto la modificación de un registro. Una vez que el agente o una persona la confirma, la operación se vuelve a ejecutar bajo los permisos del usuario.

  • Ajuste las propuestas masivas antes de confirmar

    Los elementos individuales de una propuesta masiva pueden editarse antes de su confirmación, para que no tenga que rechazar todo el lote por culpa de un único elemento incorrecto.

  • Los agentes también pueden enviar correos electrónicos

    Un agente puede enviar un correo electrónico como una de las acciones del catálogo de herramientas. La acción se ejecuta en nombre de un usuario específico y se anota en el registro de auditoría, por lo que siempre sabrá quién está detrás.

  • Archivos adjuntos y correo electrónico a través del servidor

    Mediante el servidor newerp-agents-mcp, un agente puede trabajar con archivos adjuntos y correo electrónico. Las escrituras se ejecutan de inmediato dentro de los permisos del usuario; utilice la pasarela de capacidades si prefiere aprobar cada cambio.

  • Trabajo del agente vinculado a la tarea correcta

    El agente vincula su trabajo con las tareas y los commits de código en GitLab, de modo que durante la revisión pueda ver a qué tarea pertenecen sus cambios.

Una persona aprueba siempre que haya dinero, un cliente o una excepción de por medio.

05Preguntas frecuentes

¿Puedo conectar Claude Code u otro agente de IA a Draivix?

Sí. El agente se conecta mediante MCP —ya sea a través de la pasarela de capacidades en Draivix o del servidor independiente newerp-agents-mcp— y opera con los permisos del usuario cuya clave o token utiliza.

¿Puede un agente eludir los permisos a través de MCP?

No. Cada llamada se ejecuta en nombre de un usuario específico, y el acceso efectivo es la intersección entre los permisos de ese usuario y el límite máximo de la clave de API. Además, la clave puede restringirse a un conjunto seleccionado de herramientas.

¿El agente guarda los cambios de forma inmediata?

A través de la pasarela de capacidades, las operaciones de creación, actualización y eliminación devuelven por defecto una propuesta que debe confirmarse por separado. El servidor newerp-agents-mcp escribe los cambios de inmediato dentro de los permisos del usuario.

¿Puedo rastrear qué ha hecho un agente en el sistema?

Sí. Cada llamada realizada a través de la pasarela de capacidades queda registrada en la pista de auditoría con el origen mcp y un identificador de traza, y las llamadas delegadas desde el servicio Hermes se marcan como relevantes para la seguridad.

Empecemos juntos

Cuéntenos cómo funciona su empresa.

Le mostraremos cómo podría ser un sistema que asuma parte de ese trabajo.

Reservar una consulta