← dulyx

Dulyx para desenvolvedores

Esta página reúne, num endereço previsível, o que um desenvolvedor, ou um agente, precisa para entender como se integra à Dulyx. A plataforma está em acesso antecipado: a referência completa da API e a especificação OpenAPI são liberadas junto com a chave, e o que está aqui é o contrato público.

A chamada

A integração é uma requisição HTTP. O agente recebe a pergunta em texto e devolve a resposta pronta, já apoiada nos dados que ele tem permissão de ver:

POST /api/v3/agent/chat
Authorization: Bearer <token>
Content-Type: application/json

{ "question": "Libera o pedido do Cicrano.", "agentId": 3 }

A resposta traz o texto para o usuário, o identificador da sessão e, quando o pedido implica alteração, um bloco de confirmação com o que seria feito (método, alvo e mudanças) em vez de executar direto.

Escopo e permissão

O acesso é por token com escopo por contexto: cada token enxerga apenas os contextos liberados, e cada contexto expõe apenas o conhecimento e as Ações cadastradas nele. A regra vale nos dois sentidos: o modelo não recebe URL nem credencial, e uma Ação fora do escopo não existe para aquele agente. Escrita nunca executa de primeira: devolve uma proposta que precisa de confirmação.

Conexão MCP

Os contextos liberados podem virar ferramentas dentro do assistente que o time já usa: Claude, ChatGPT, Cursor e o resto que fala Model Context Protocol. O funil de dados roda do lado da Dulyx, o modelo externo recebe pergunta e resposta em texto, e a escrita continua parando em confirmação. O endereço é público (api.dulyx.com.br/api/v3/mcp); o que é por organização é a autorização.

Integrações prontas

Mais de vinte origens já vêm cadastradas: Trello, GitHub, Slack, Jira, Stripe, HubSpot, Zendesk, Notion, Google Workspace e outras. Conectar é preencher a credencial: a URL base, a autenticação e as Ações já estão descritas. O catálogo completo está na seção de integrações, e o que não está nele entra pela sua própria API REST.

Especificação, OAuth e MCP

  • /openapi.json: OpenAPI 3.0 da superfície pública (rotas v3 por API Token, servidor MCP, fluxo OAuth e widget), gerado do spec completo da API sem edição manual. A referência interativa fica em api.dulyx.com.br/api/docs.
  • OAuth 2.0: authorization code com PKCE (S256) e registro dinâmico de cliente (RFC 7591). O issuer é https://api.dulyx.com.br: metadata RFC 8414 em /.well-known/oauth-authorization-server e RFC 9728 em /.well-known/oauth-protected-resource, com scopes_supported: ["mcp"]. Os mesmos caminhos neste domínio redirecionam para lá.
  • Servidor MCP: POST https://api.dulyx.com.br/api/v3/mcp (Streamable HTTP, JSON-RPC). Aceita API Token ou access token OAuth com escopo mcp; sem credencial responde 401 com WWW-Authenticate apontando a metadata, que é como o Claude e outros clientes iniciam a autorização. Manifesto em /.well-known/mcp.json.

Arquivos legíveis por máquina

  • /llms.txt: o resumo da plataforma em texto, com o que ela faz, quando usar e como chamar.
  • /sitemap.xml: todos os endereços públicos.
  • /robots.txt: regras de rastreamento.
  • A home responde text/markdown para quem pedir por Accept, e endereços inexistentes devolvem 404 de verdade, com os caminhos de recuperação no corpo.

Como conseguir uma chave

A geração de chave ainda não é self-service: o acesso sai pela lista de espera, e dúvidas técnicas vão para contato@dulyx.com.br. Quando a abertura geral acontecer, esta página passa a apontar para a referência completa e para o ambiente de testes.