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.
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:
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.
Por onde começar
- Se você usa Claude: conecte o servidor remoto com OAuth (claude.ai web) ou instale a extensão
.mcpbno Desktop — guia passo a passo — e peça: "liste minhas transações de assinatura". - Se você automatiza com n8n: instale o nó
n8n-nodes-signdocs-brasile parta de um template pronto. - 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.
- 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