WorkOS apresenta auth.md, protocolo aberto para cadastro de agentes de IA

A maioria dos aplicativos web não tem uma forma estruturada de permitir que um agente de IA se cadastre e obtenha acesso. A WorkOS propõe uma solução: o auth.md, protocolo aberto baseado em OAuth que simplifica a integração de agentes sem preenchimento manual de formulários.

O problema que o auth.md resolve

Hoje, quando um desenvolvedor quer conectar um agente de IA a um aplicativo, precisa preencher manualmente um formulário de cadastro, indicar as permissões e obter uma chave de API. O agente não consegue fazer isso automaticamente: não existe um jeito padrão de saber quais fluxos o serviço aceita, quais permissões exige e como obter credenciais vinculadas a um usuário real.

Isso vira um gargalo na hora de escalar. Cada novo agente exige configuração manual, e os desenvolvedores precisam escrever integrações personalizadas para cada aplicativo e manter a documentação atualizada.

O auth.md muda a abordagem. É um arquivo Markdown comum que o aplicativo publica no próprio domínio (por exemplo, example.com/auth.md). O arquivo traz tudo de que o agente precisa para se cadastrar sozinho:

• Métodos aceitos (OAuth 2.0, chaves de API, mTLS e outros)
• Scopes e permissões necessários para diferentes casos de uso
• Endpoints para obter credenciais e tokens de longa duração
• Exemplos de código e recomendações para começar rápido
• Informações sobre limites de taxa (rate limits), cotas e prazo de validade dos tokens

Como funciona na prática

Quando um agente de IA precisa se integrar a um aplicativo, ele acessa o domínio, encontra o auth.md e lê as instruções. Em seguida, inicia automaticamente o processo de cadastro adequado, solicita as permissões necessárias e recebe um token ou chave de API vinculado a um usuário real. A pessoa não precisa preencher nada manualmente: todo o processo acontece de forma programática.

Por exemplo, se um agente se conecta a um serviço de e-mail, ele pode pedir exatamente as permissões de que precisa (ler mensagens, enviar respostas), sem acesso a outras funções (apagar mensagens, alterar configurações da conta). Cada permissão é indicada explicitamente no auth.md, e o usuário vê o que o agente solicita e pode aprovar ou recusar.

A WorkOS escolheu Markdown em vez de JSON ou XML porque o formato é fácil de ler e editar tanto para desenvolvedores quanto para agentes de IA. Além disso, o arquivo Markdown é simples de versionar no git, permite acompanhar mudanças, adicionar comentários e ser atualizado sem novo deploy do aplicativo.

O que isso significa para o ecossistema

O auth.md é um passo rumo à padronização da integração de agentes de IA na web. Se o protocolo ganhar apoio suficiente entre os grandes serviços, os agentes de IA poderão se cadastrar sozinhos em centenas de aplicativos, sem intervenção manual dos desenvolvedores. Isso aceleraria de forma significativa a automação de tarefas rotineiras.

Por outro lado, surgem novas questões de segurança: como impedir acesso não autorizado por meio de agentes? Como gerenciar permissões se o cadastro é totalmente automático? A WorkOS espera que a padronização aberta facilite a discussão na comunidade e ajude a definir boas práticas para o cadastro automático e seguro de agentes.