Duvo
Servidor MCP hospedado para Duvo — inicie execuções, inspecione aprovações e exponha ferramentas de execução de supermercado/varejo a agentes compatíveis.
Documentação
Conecte-se ao servidor MCP do Duvo
Conecte o Claude Desktop, o Cursor ou o ChatGPT ao servidor MCP do Duvo. Cada endpoint da Public API se torna uma ferramenta chamável por LLM.
Conectar um host MCP ao servidor MCP do Duvo é a principal forma de as equipes usarem MCP com o Duvo — é a contraparte conversacional da CLI do Duvo.
O Duvo expõe um servidor MCP hospedado em https://api.duvo.ai/v2/mcp. Conecte-se a ele a partir de qualquer host compatível com MCP — Claude Desktop, Cursor, conectores do ChatGPT, seu próprio cliente — e cada endpoint da Public API do Duvo se torna uma ferramenta que o host pode chamar.
Use isto para:
- Acionar Agentes do Duvo a partir de um chat de assistente de IA ("Inicie o processador de faturas no lote de ontem e me avise quando terminar.")
- Inspecionar Runs, Cases e Files de forma conversacional
- Criar fluxos de trabalho híbridos em que um assistente orquestra Agentes do Duvo junto com outras ferramentas
O que você pode fazer
Cada endpoint registrado na Public API é exposto automaticamente como uma ferramenta MCP. Isso inclui:
- Agents — listar, obter, criar, atualizar
- Runs — iniciar, obter status, enviar mensagens, responder a solicitações human-in-the-loop, parar
- Connections — listar e inspecionar suas contas autorizadas
- Files — listar, ler, escrever, renomear, excluir
- Cases e Queues — inspecionar, delegar, rotular
- Skills, Plugins, Sandboxes — listar e referenciar
Veja a lista completa de ferramentas disponíveis na página Available MCP Tools.
Quando o Duvo lança um novo endpoint da Public API, ele se torna automaticamente uma ferramenta MCP no próximo deploy. Não há etapa de manutenção separada.
URL do servidor
https://api.duvo.ai/v2/mcp
O servidor usa o transporte Streamable HTTP do MCP (POST /v2/mcp). A maioria dos hosts MCP modernos oferece suporte a esse transporte nativamente.
Autenticação
O servidor MCP do Duvo aceita dois tipos de credenciais:
Opção 1 — OAuth (recomendado para uso pessoal)
Recomendado para hosts que solicitam que você faça login (Claude Desktop, Cursor, conectores do ChatGPT). O host executa um login único baseado em navegador no Duvo e depois gerencia a renovação e a revogação de tokens para você. Não é necessário copiar ou rotacionar chave de API.
As etapas exatas dependem do host. Em geral:
Adicione `https://api.duvo.ai/v2/mcp` como a URL do servidor MCP nas configurações do seu host. O host detecta o desafio OAuth e abre uma aba do navegador para a página de login do Duvo. Faça login e aprove a conexão. O host armazena os tokens OAuth e os usa automaticamente em cada chamada de ferramenta.O servidor MCP do Duvo publica seus metadados OAuth em https://api.duvo.ai/.well-known/oauth-protected-resource/v2/mcp (RFC 9728). Hosts MCP compatíveis usam isso para descobrir o servidor de autorização e se registrar automaticamente via Dynamic Client Registration.
Opção 2 — Chave de API (recomendada para scripts e contas de serviço)
Use chaves de API quando o host não suportar OAuth ou para uso não interativo (CI, contas de serviço).
Gere uma chave no painel do Duvo em [Seu perfil → Chaves de API](https://app.duvo.ai/settings/profile#api-keys), com escopo para uma única equipe ou para todas as equipes às quais você tem acesso. Usuários com o papel de Manager ou superior também podem criar chaves de uma equipe em [Configurações da equipe → Chaves de API](https://app.duvo.ai/settings/api-keys). Configure o host MCP para enviar a chave como bearer token no cabeçalho `Authorization`:```
Authorization: Bearer <your-api-key>
```
As chaves de API têm escopo para uma única equipe ou para todas as equipes às quais o proprietário tem acesso e herdam as permissões do usuário que as gerou.
Configuração por host
O padrão MCP significa que a mesma URL do Duvo funciona em qualquer host compatível. A sintaxe de configuração varia um pouco entre os produtos, então consulte o guia de configuração MCP do seu host para obter os nomes exatos dos campos. Padrões comuns:
Edite a configuração do Claude Desktop (`claude_desktop_config.json`):```json theme={"dark"}
{
"mcpServers": {
"duvo": {
"url": "https://api.duvo.ai/v2/mcp"
}
}
}
```
Reinicie o Claude Desktop. Quando você mencionar o Duvo ou usar uma ferramenta do conector, o Claude Desktop abrirá uma aba do navegador para o login OAuth.
```bash theme={"dark"}
claude mcp add --transport http duvo https://api.duvo.ai/v2/mcp
```
Na primeira vez que você chamar uma ferramenta do Duvo, o Claude Code executa o login OAuth baseado em navegador. Para usar uma chave de API em vez disso (para CI ou contas de serviço), passe-a como bearer header:
```bash theme={"dark"}
claude mcp add --transport http duvo https://api.duvo.ai/v2/mcp \
--header "Authorization: Bearer <your-api-key>"
```
Ergonomia das ferramentas
As ferramentas seguem a Public API subjacente:
- Os nomes das ferramentas mapeiam para
operationIds do OpenAPI (por exemplo,listAgents,startRun,getConnection). - As descrições das ferramentas vêm da descrição OpenAPI de cada endpoint.
- Os schemas de entrada são planos — path parameters, query parameters e request body são mesclados em um único objeto para que as chamadas sejam lidas naturalmente (
startRun({ agent_id: "...", input: "..." })em vez de envolver cada seção). - As respostas correspondem à resposta da API correspondente. Use a Public API Reference para ver as formas exatas.
Limites e comportamento
- Todos os limites de taxa da Public API se aplicam às chamadas de ferramentas MCP.
- Cada chamada de ferramenta respeita as permissões do usuário autenticado, assim como uma chamada direta à API.
- Runs de longa duração não são transmitidos via MCP atualmente — inicie o Run pela ferramenta e depois faça polling em
getRunoulistRunMessagespara monitorar o progresso.
Solução de problemas
**401 Unauthorized** — Seu token está ausente, expirado ou é para um público diferente. Execute o OAuth novamente ou regenere a chave de API no painel. **403 Forbidden** — Sua conta não tem permissão para chamar este endpoint. Verifique seu papel na equipe e as permissões de Connection. **O OAuth não abre um navegador** — O host pode não suportar Dynamic Client Registration. Use a autenticação por chave de API como alternativa ou consulte a documentação do host para ver as etapas de configuração do OAuth.Privacidade e termos
- Privacy Policy — como o Duvo trata os dados acessados pelo servidor MCP.
- Terms of Use — os termos que se aplicam ao uso da API e do MCP do Duvo.
Para detalhes abrangentes da plataforma (certificação SOC 2, criptografia, Anthropic Zero Data Retention, subprocessadores), consulte Security & Privacy.