Agentes de IA e Assinatura Digital: O Que Já Funciona (e Onde o Humano Continua)

Agentes de IA saíram do estágio de "responder perguntas" e entraram no de executar trabalho — e poucos fluxos são um alvo tão natural quanto o ciclo de um contrato: preparar, enviar, cobrar, arquivar. Este artigo mostra o que um agente já consegue fazer hoje com a SignDocs — via MCP, n8n ou API —, os desenhos de arquitetura que funcionam, e a fronteira que não se cruza: o agente prepara e orquestra; quem assina é gente.

A distinção importa porque assinatura não é uma tarefa operacional qualquer: é manifestação de vontade, com efeito jurídico amparado na MP 2.200-2/2001 e na Lei 14.063/2020. Automatizar a logística da assinatura é ganho puro de produtividade. Automatizar o ato de assinar seria destruir justamente a evidência que dá valor ao documento. As boas arquiteturas de agente respeitam essa linha — e a plataforma foi desenhada para reforçá-la.

O que um agente de IA já faz hoje no ciclo de assinatura

Pense em tudo o que acontece ao redor do ato de assinar. É esse entorno que os agentes absorvem bem:

  • Montar o envio certo: a partir de uma instrução em linguagem natural ("envie o NDA para a Maria assinar com OTP"), o agente cria a sessão de assinatura com o documento, o signatário e o perfil de autenticação adequado — clique, OTP, biometria ou certificado ICP-Brasil.
  • Orquestrar múltiplos signatários: criar o envelope, definir a ordem (sequencial ou paralela) e adicionar uma sessão por participante, cada um com seu nível de autenticação.
  • Acompanhar e cobrar: consultar status, identificar quem está pendente e reenviar o convite — ou avisar no canal onde o time trabalha.
  • Fechar o ciclo: quando a assinatura conclui, baixar o documento assinado e o pacote de evidências (.p7m) e arquivar no repositório correto.
  • Verificar documentos de terceiros: checar se um PDF recebido possui assinatura digital e de que tipo, antes de dar andamento a um processo.

Nada disso exige que o agente "assine". Exige que ele tenha ferramentas — e é exatamente isso que o protocolo MCP padroniza.

MCP: a camada de ferramentas para qualquer agente

O MCP (Model Context Protocol) é o padrão aberto que conecta agentes de IA a sistemas externos. A SignDocs mantém um servidor MCP oficial com 24 ferramentas — criar e cancelar sessões, montar envelopes, consultar transações, baixar documentos e evidências, verificar PDFs, gerenciar webhooks — que qualquer cliente compatível consome pela mesma API REST que move o restante da plataforma.

São quatro formas de conectar, do zero-instalação ao roda-local:

Formato Como funciona Para quem
Servidor remoto + OAuth Conector em mcp.signdocs.com.br; login OAuth, nada para instalar Usuários do claude.ai (web)
Pacote npm npx -y @signdocs-brasil/mcp-server rodando localmente (stdio) Claude Code, clientes MCP locais
Extensão de um clique Arquivo .mcpb: duplo-clique e credenciais Claude Desktop
Via API da Claude Servidor MCP acoplado a agentes construídos sobre a API Produtos que embutem agentes

O guia técnico completo está em integração MCP de assinatura, e o passo a passo específico do ecossistema Claude em assinatura digital com a Claude.

Humano no circuito, por protocolo: as ferramentas com efeito jurídico ou que consomem cota — criar uma sessão de assinatura, cancelar uma transação — são marcadas como sensíveis no servidor MCP. Clientes compatíveis pedem confirmação humana antes de executá-las. O agente propõe; a pessoa aprova; só então a chamada acontece.

Sem Claude? n8n, API direta e o bot de Telegram

n8n: automação visual com o nó oficial

Para quem prefere workflows visuais a prompts, o nó comunitário n8n-nodes-signdocs-brasil — o primeiro nó de assinatura eletrônica nativo do Brasil no n8n — cria sessões e envelopes dentro de qualquer workflow: formulário preenchido → sessão criada → link enviado → webhook de conclusão → CRM atualizado. Funciona em qualquer instância self-hosted; no n8n Cloud, community nodes exigem plano Pro ou superior. Veja o guia de integração n8n e os templates prontos.

API direta: function calling em qualquer stack

Um agente construído em qualquer framework de LLM usa a API REST como conjunto de ferramentas de function calling: autenticação OAuth2 client-credentials, criação de sessões e envelopes, e os SDKs oficiais em seis linguagens para não reinventar cliente HTTP. O desenho é o mesmo do MCP — só muda quem descreve as ferramentas ao modelo.

Webhooks: os olhos do agente

Agente bom não faz polling — reage. Os webhooks da plataforma transformam o ciclo de vida da assinatura em gatilhos: SIGNING_SESSION.COMPLETED dispara o arquivamento, TRANSACTION.DEADLINE_APPROACHING dispara a cobrança educada no canal do time, ENVELOPE.ALL_SIGNED dispara a geração do documento consolidado e a notificação às partes interessadas. O par "agente cria → webhook avisa → agente reage" é o loop completo.

E o Telegram?

Para times que operam em chat, o bot oficial de Telegram (@SignDocsBrasilBot) já entrega a experiência conversacional pronta: enviar um documento e acompanhar a assinatura sem sair do mensageiro — sem montar agente nenhum.

Um exemplo concreto: do prompt ao contrato assinado

Com o servidor MCP conectado, o fluxo vira uma conversa:

Você: "Prepare o contrato de prestação de serviços para a Maria Silva (maria@empresa.com.br) assinar com verificação por OTP e me avise quando ela concluir." Agente (via MCP, com sua confirmação antes de executar): 1. create_signing_session → purpose: DOCUMENT_SIGNATURE → policy: { profile: "CLICK_PLUS_OTP" } → signer: { name, email, cpf } → document: contrato em base64 2. Devolve o link de assinatura (url + clientSecret) e envia à signatária. # Horas depois, o webhook SIGNING_SESSION.COMPLETED chega ao seu backend Agente: baixa o documento assinado + evidence pack (.p7m), arquiva na pasta do cliente e avisa no canal do time.

Repare no que não aconteceu: o agente não assinou nada. A Maria abriu o link, passou pelo OTP e assinou ela mesma — com a trilha de auditoria registrando a autenticação dela, não a do robô. É essa separação que mantém o documento defensável. Para entender os níveis de garantia de cada perfil, veja os níveis de assinatura da Lei 14.063/2020.

Governança: as quatro guardas de um agente bem desenhado

  • Escopos OAuth2: o agente recebe credenciais com os escopos mínimos necessários; tokens expiram em 15 minutos e a rotação é sua.
  • Confirmação humana nas ações sensíveis: criar, cancelar e tudo que consome cota ou gera efeito jurídico passa por aprovação explícita nos clientes MCP compatíveis.
  • Trilha de auditoria: cada transação registra o que foi criado, quando e para quem — o comportamento do agente é inspecionável depois do fato.
  • Sandbox primeiro: desenvolva o agente contra o ambiente de homologação (api-hml.signdocs.com.br), onde nada tem efeito jurídico e as entidades expiram em 7 dias. Deixe o agente errar onde errar não custa.
A fronteira, dita sem rodeios: não existe — nem deve existir — ferramenta de "assinar pelo usuário". A assinatura qualificada usa o certificado ICP-Brasil do titular; a biometria compara o rosto do titular; o OTP chega ao canal do titular. Um agente que contornasse isso não estaria automatizando a assinatura — estaria fabricando evidência falsa. A produtividade do agente vem de eliminar a logística, não a vontade.

Por onde começar

  1. Se você usa Claude: conecte o servidor remoto com OAuth (claude.ai web) ou instale a extensão .mcpb no Desktop — guia passo a passo — e peça: "liste minhas transações de assinatura".
  2. Se você automatiza com n8n: instale o nó n8n-nodes-signdocs-brasil e parta de um template pronto.
  3. Se você constrói o próprio agente: gere credenciais de homologação, dê os endpoints ao seu modelo como ferramentas e valide o loop com webhooks no sandbox.
  4. Para dimensionar produção: o acesso de produção à API é um plano sob medida — fale com o time comercial sobre volume e requisitos.

Perguntas Frequentes

Um agente de IA pode assinar um documento por mim?

Não — e isso é uma decisão de desenho, não uma limitação técnica. A assinatura é uma manifestação de vontade pessoal: quem assina é o titular, autenticado pelo método exigido no fluxo (clique, OTP, biometria com prova de vida ou certificado ICP-Brasil). O que o agente faz é todo o resto: preparar o documento, criar a sessão ou o envelope, escolher o perfil de autenticação, enviar o link, acompanhar eventos, cobrar pendências e arquivar o documento assinado com o pacote de evidências. No protocolo MCP da SignDocs, as ferramentas com efeito jurídico ou que consomem cota são marcadas como sensíveis, e clientes compatíveis pedem confirmação humana antes de executá-las.

Como conecto a Claude ou outro agente de IA à SignDocs?

Pelo protocolo MCP (Model Context Protocol), padrão aberto para dar ferramentas a agentes. A SignDocs mantém um servidor MCP oficial com 24 ferramentas, em quatro formatos: o servidor remoto em mcp.signdocs.com.br com login OAuth (funciona no claude.ai web, sem instalar nada), o pacote npm @signdocs-brasil/mcp-server rodando localmente via npx, a extensão de um clique (.mcpb) para o Claude Desktop e a integração via API da Claude. Qualquer cliente compatível com MCP consome as mesmas ferramentas — não é uma integração presa a um único app.

E se eu não uso Claude — dá para automatizar com n8n ou API direta?

Sim. Para automação visual, o nó comunitário oficial n8n-nodes-signdocs-brasil cria sessões e envelopes dentro de workflows n8n (self-hosted em qualquer plano; no n8n Cloud, community nodes exigem plano Pro ou superior). Para agentes próprios, a API REST com OAuth2 client-credentials e os SDKs oficiais (TypeScript/Node, Python, Go, Java, PHP, C#/.NET) funcionam como ferramentas de function calling em qualquer stack de LLM. E os webhooks fecham o ciclo: eventos como SIGNING_SESSION.COMPLETED e ENVELOPE.ALL_SIGNED servem de gatilho para o agente reagir ao que aconteceu.

É seguro dar acesso de assinatura a um agente de IA?

Com as guardas certas, sim. As credenciais são OAuth2 com escopos — o agente só acessa o que o escopo permite, e os tokens expiram em 15 minutos. Ações com efeito jurídico ou consumo de cota pedem confirmação humana nos clientes MCP compatíveis. Toda ação fica na trilha de auditoria da transação, com carimbo de hora — você sabe exatamente o que o agente criou, quando e para quem. E o mais importante: o agente nunca assina; ele prepara. A autenticação de quem assina (OTP, biometria, certificado) permanece com o signatário humano.

Como testo um agente sem gastar cota nem criar documentos com efeito jurídico?

Use o ambiente de homologação: o servidor MCP e a API têm modo sandbox apontando para api-hml.signdocs.com.br, onde nada é cobrado, nenhuma assinatura tem efeito jurídico de produção e as entidades expiram em 7 dias. É o lugar certo para deixar o agente errar: prompts mal interpretados, fluxos criados em duplicidade e webhooks mal configurados aparecem no sandbox, não na sua operação real. Validado o comportamento, você troca as credenciais e o host para produção.

Que tarefas valem a pena delegar a um agente hoje?

As tarefas de orquestração que hoje consomem tempo de gente: montar o envelope certo para cada tipo de contrato (quem assina, em que ordem, com qual autenticação), disparar o envio a partir de uma conversa ou de um evento do CRM, acompanhar o status e cobrar quem está pendente, baixar o documento assinado com o pacote de evidências e arquivar no lugar certo, e verificar se um PDF recebido de terceiros possui assinatura digital. O julgamento — aprovar minuta, decidir exceções, assinar — continua com as pessoas.

Dê ferramentas de assinatura ao seu agente de IA

Servidor MCP oficial com 24 ferramentas, nó n8n nativo, SDKs em seis linguagens e webhooks para fechar o loop — com sandbox gratuito para desenvolver e confirmação humana onde importa.

Fale com o time comercial Conheça a plataforma grátis