Duvo

Servidor MCP alojado para Duvo: inicia ejecuciones, inspecciona aprobaciones y expone herramientas de ejecución para tiendas de comestibles/retail a agentes compatibles.

Ver en duvo.aiPrueba este MCPPatrocinado

Documentación

Conéctate al servidor MCP de Duvo

Conecta Claude Desktop, Cursor o ChatGPT al servidor MCP de Duvo. Cada endpoint de la API pública se convierte en una herramienta invocable por LLM.

Conectar un host MCP al servidor MCP de Duvo es la forma principal en que los equipos usan MCP con Duvo: es la contraparte conversacional de la CLI de Duvo.

Duvo expone un servidor MCP alojado en https://api.duvo.ai/v2/mcp. Conéctate desde cualquier host compatible con MCP (Claude Desktop, Cursor, conectores de ChatGPT, tu propio cliente) y cada endpoint de la API pública de Duvo se convierte en una herramienta que el host puede invocar.

Úsalo para:

  • Controlar Agentes de Duvo desde el chat de un asistente de IA ("Inicia el procesador de facturas con el lote de ayer y avísame cuando termine").
  • Inspeccionar Ejecuciones, Casos y Archivos de forma conversacional
  • Crear flujos de trabajo híbridos donde un asistente orquesta Agentes de Duvo junto con otras herramientas

Lo que puedes hacer

Cada endpoint registrado en la API pública se expone automáticamente como una herramienta MCP. Esto incluye:

  • Agentes — listar, obtener, crear, actualizar
  • Ejecuciones — iniciar, obtener estado, enviar mensajes, responder a solicitudes human-in-the-loop, detener
  • Conexiones — listar e inspeccionar tus cuentas autorizadas
  • Archivos — listar, leer, escribir, renombrar, eliminar
  • Casos y Colas — inspeccionar, delegar, etiquetar
  • Habilidades, Plugins, Sandboxes — listar y referenciar

Consulta la lista completa de herramientas disponibles en la página Herramientas MCP Disponibles.

Cuando Duvo publica un nuevo endpoint de la API pública, automáticamente se convierte en una herramienta MCP en el siguiente despliegue. No hay ningún paso de mantenimiento adicional.

URL del servidor

https://api.duvo.ai/v2/mcp

El servidor utiliza el transporte Streamable HTTP de MCP (POST /v2/mcp). La mayoría de los hosts MCP modernos admiten este transporte de forma nativa.

Nota

El endpoint anterior https://api.duvo.ai/v1/mcp sigue funcionando y ofrece las mismas herramientas que /v2/mcp, por lo que las configuraciones existentes siguen funcionando sin cambios, incluso después de la retirada de la API /v1. Las nuevas conexiones deben usar /v2/mcp.

Autenticación

El servidor MCP de Duvo acepta dos tipos de credenciales:

Opción 1 — OAuth (recomendado para uso personal)

Recomendado para hosts que te piden iniciar sesión (Claude Desktop, Cursor, conectores de ChatGPT). El host ejecuta un inicio de sesión único basado en navegador en Duvo y luego gestiona la renovación y revocación de tokens por ti. No hay clave API que copiar o rotar.

Los pasos exactos dependen del host. En general:

Añade `https://api.duvo.ai/v2/mcp` como URL del servidor MCP en la configuración de tu host. El host detecta el desafío OAuth y abre una pestaña del navegador en la página de inicio de sesión de Duvo. Inicia sesión y aprueba la conexión. El host almacena los tokens OAuth y los usa automáticamente en cada llamada de herramienta.

El servidor MCP de Duvo publica sus metadatos OAuth en https://api.duvo.ai/.well-known/oauth-protected-resource/v2/mcp (RFC 9728). Los hosts MCP compatibles usan esto para descubrir el servidor de autorización y registrarse automáticamente mediante Registro Dinámico de Clientes.

Opción 2 — Clave API (recomendado para scripts y cuentas de servicio)

Usa claves API cuando el host no admita OAuth, o para uso no interactivo (CI, cuentas de servicio).

Genera una clave en el panel de Duvo en [Tu Perfil → Claves API](https://app.duvo.ai/settings/profile#api-keys), con alcance a un solo equipo o a todos los equipos a los que tengas acceso. Los usuarios con rol de Gerente o superior también pueden crear claves de un equipo en [Configuración del Equipo → Claves API](https://app.duvo.ai/settings/api-keys). Configura el host MCP para enviar la clave como token de portador en el encabezado `Authorization`: 
```
Authorization: Bearer <your-api-key>
```
El host puede entonces invocar las herramientas MCP de Duvo sin necesidad de iniciar sesión nuevamente.

Las claves API tienen alcance a un solo equipo o a todos los equipos a los que el propietario tenga acceso, y heredan los permisos del usuario que las generó.

Configuración por host

El estándar MCP significa que la misma URL de Duvo funciona en cualquier host compatible. La sintaxis de configuración varía ligeramente entre productos, así que consulta la guía de configuración MCP de tu host para conocer los nombres exactos de los campos. Patrones comunes:

Edita tu configuración de Claude Desktop (`claude_desktop_config.json`): 
```json theme={"dark"}
{
  "mcpServers": {
    "duvo": {
      "url": "https://api.duvo.ai/v2/mcp"
    }
  }
}
```

Reinicia Claude Desktop. Cuando menciones Duvo o uses una herramienta del conector, Claude Desktop abre una pestaña del navegador para el inicio de sesión OAuth.
Añade el servidor de Duvo desde tu terminal con el comando `claude mcp add`: 
```bash theme={"dark"}
claude mcp add --transport http duvo https://api.duvo.ai/v2/mcp
```

La primera vez que invoques una herramienta de Duvo, Claude Code ejecuta el inicio de sesión OAuth basado en navegador. Para usar una clave API en su lugar (para CI o cuentas de servicio), pásala como encabezado de portador:

```bash theme={"dark"}
claude mcp add --transport http duvo https://api.duvo.ai/v2/mcp \
  --header "Authorization: Bearer <your-api-key>"
```
En la configuración de Cursor, abre la sección de servidores MCP, añade un nuevo servidor con la URL `https://api.duvo.ai/v2/mcp` y deja que Cursor ejecute el flujo OAuth. Añade un Conector Personalizado que apunte a `https://api.duvo.ai/v2/mcp`. ChatGPT gestiona el Registro Dinámico de Clientes y el flujo OAuth automáticamente. Cualquier biblioteca de cliente compatible con MCP (TypeScript, Python, etc.) puede conectarse: apúntala a `https://api.duvo.ai/v2/mcp`, proporciona un token OAuth o una clave API, e invoca `tools/list` para descubrir lo que está disponible.

Ergonomía de las herramientas

Las herramientas siguen la API pública subyacente:

  • Los nombres de las herramientas se asignan a los operationId de OpenAPI (por ejemplo, listAgents, startRun, getConnection).
  • Las descripciones de las herramientas provienen de la descripción OpenAPI de cada endpoint.
  • Los esquemas de entrada son planos: los parámetros de ruta, los parámetros de consulta y el cuerpo de la solicitud se fusionan en un solo objeto para que las llamadas se lean de forma natural (startRun({ agent_id: "...", input: "..." }) en lugar de envolver cada sección).
  • Las respuestas coinciden con la respuesta API correspondiente. Usa la Referencia de la API Pública para conocer las formas exactas.
  • Cada herramienta lleva anotaciones MCP (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), para que los hosts puedan distinguir una lectura de una escritura y saber qué herramientas alcanzan fuera de Duvo — por ejemplo startRun, probeMcpServer o las herramientas de inicio OAuth.
  • Los errores de no encontrado nombran el parámetro de id que falló y repiten el valor que enviaste (por ejemplo case_queue_id), para que una llamada que toma varios ids te indique cuál debes revisar.

Habilidades integradas

El servidor también incluye las Habilidades de Agente de Duvo como recursos MCP, para que tu host tenga la misma guía sin instalar nada. Cada habilidad es un archivo markdown en duvo://skills/:

RecursoÚsalo para
duvo://skills/aop-writer/SKILL.mdRedactar, reescribir o criticar el AOP de un Agente
duvo://skills/run-debugger/SKILL.mdDescubrir por qué una Ejecución falló o produjo un resultado incorrecto
duvo://skills/workflow-debugger/SKILL.mdAuditar un Agente o un flujo de trabajo conectado a una Cola en muchas Ejecuciones
duvo://skills/improve-agent/SKILL.mdLlevar un Agente desde donde está hasta una mejora aplicada
duvo://skills/improve-queue/SKILL.mdHacer lo mismo para una Cola y el flujo de trabajo productor/consumidor que la rodea
duvo://skills/connection-doctor/SKILL.mdDiagnosticar las Conexiones e Inicios de Sesión de los que depende un Agente

Las instrucciones del servidor le indican al host cuándo leer cada habilidad, y los archivos de referencia se encuentran junto a cada SKILL.md en references/. Los hosts que muestran recursos MCP (Claude Desktop, Claude Code, Cursor) los listan automáticamente.

Nota

Las habilidades son el mismo contenido que el repositorio público duvoai/skills, que aún puedes instalar localmente para usar con la CLI de Duvo.

Límites y comportamiento

  • Todos los límites de velocidad de la API pública se aplican a las llamadas de herramientas MCP.
  • Cada llamada de herramienta respeta los permisos del usuario autenticado, igual que una llamada API directa.
  • Las Ejecuciones de larga duración no se transmiten por MCP actualmente: inicia la Ejecución mediante la herramienta y luego consulta getRun o listRunMessages para monitorear el progreso.

Solución de problemas

Advertencia

401 No autorizado — Tu token falta, está vencido o es para una audiencia diferente. Vuelve a ejecutar OAuth o regenera la clave API en el panel.

Advertencia

403 Prohibido — Tu cuenta no tiene permiso para invocar este endpoint. Verifica tu rol en el equipo y los permisos de Conexión.

Advertencia

OAuth no abre un navegador — Es posible que el host no admita el Registro Dinámico de Clientes. Usa la autenticación con clave API como alternativa, o consulta la documentación del host para conocer los pasos de configuración de OAuth.

Privacidad y términos

Para detalles a nivel de plataforma (certificación SOC 2, cifrado, Retención Cero de Datos de Anthropic, subprocesadores), consulta Seguridad y Privacidad.

Relacionado

El catálogo completo de herramientas que expone este servidor. La otra dirección: trae tu propio servidor MCP a Duvo. La API que envuelve el servidor MCP de Duvo. Wrapper de terminal sobre la misma API.