Um agente de IA pode verificar se um PDF está assinado digitalmente e dizer quem o assinou, localmente, sem que o arquivo deixe sua máquina. A resposta útil não é “verified”. É o assinante, o emissor, o período de validade e o tipo de assinatura que foi verificado. Peça isso em um único prompt:

Quem assinou contract_signed.pdf, com qual certificado, e quando? Diga qual tipo de assinatura você verificou.

A versão passo a passo com configuração e solução de problemas está na documentação: Como verificar documentos assinados com um agente de IA.

Por que uma resposta de uma palavra “verificado” é ruim?

Porque “este documento está assinado?” e “esta assinatura é válida?” são perguntas diferentes, e a segunda tem uma resposta precisa apenas para assinaturas digitais. Um modelo que lê uma página e vê um selo ou um código QR pode dizer “assinado” com total confiança, e não verificou nada criptográfico. A única maneira de evitar isso é fornecer ao agente um mecanismo que retorne dados estruturados e fazer com que o agente relate os dados em vez de um veredicto.

O servidor GroupDocs.Signature.Mcp fornece esse mecanismo. Usado com Claude Desktop, Claude Code, Cursor, GitHub Copilot ou outro cliente MCP, ele funciona como um processo local, de modo que o agente lê os dados da assinatura do arquivo em vez de adivinhar a partir dos pixels renderizados.

O caminho errado: pedir ao modelo para olhar o documento

Se você colar um PDF em um chat e perguntar se ele está assinado, o modelo vê texto e imagens. Ele pode notar um nome, uma data ou uma assinatura desenhada. Não pode ver a estrutura criptográfica do arquivo, portanto não consegue distinguir uma assinatura baseada em certificado de uma imagem dela. Um “sim, isso está assinado” confiante é uma afirmação sobre a aparência.

O que cada tipo de assinatura realmente comprova

A documentação é explícita sobre como ler um resultado, e um agente deve repeti-lo:

Resultado O que significa
Assinatura digital válida O arquivo não foi alterado desde a assinatura, e a cadeia de certificados está válida
Assinatura digital inválida O arquivo foi alterado após a assinatura, ou o certificado não é válido
Texto, QR ou código de barras “verificado” A marca esperada está presente. Não diz nada sobre adulteração
Nenhuma assinatura encontrada Não assinado, ou assinado de forma que este formato não suporta

Uma resposta que não nomeia o tipo está lhe dizendo menos do que parece. É por isso que o prompt acima termina com “diga qual tipo de assinatura você verificou”.

O caminho certo: pedir o registro, não o veredicto

A ferramenta verify aceita um type de text, qrcode, barcode, digital ou all e retorna isValid com contagens de succeeded e failed. Ela não indica quem assinou ou com qual certificado, portanto não substitui o registro abaixo. Quando verify e search_digital_signatures discordam, relate ambos e baseie‑se no registro detalhado.

A resposta que se sustenta vem de search_digital_signatures. Para cada assinatura digital, ela retorna o nome do assinante, o emissor, o número de série do certificado, o período de validade, o carimbo de data/hora da assinatura, o status de validade e quaisquer comentários anexados à assinatura. Esse é o registro que uma auditoria solicita. Mantenha esses dados, em vez do parágrafo do agente sobre eles, quando a resposta alimenta uma decisão.

Sessão de exemplo (abreviada)

You:    Who signed contract_signed.pdf, with which certificate, and when?
        Say which type of signature you checked.

Agent:  [search_digital_signatures] file=contract_signed.pdf
        Type checked: digital (certificate-backed).
        Signatures found: 1
        - Signer: Dana Whitfield, issued by Example Corporate CA, serial 4F2A91C7
        - Signed 2026-09-14 10:32; certificate valid 2025-11-01 to 2027-10-31
        - Status: isValid = true; signing time falls inside the certificate validity period
        I checked digital signatures only. I did not evaluate any text stamps or QR codes.

Saída ilustrativa: nomes de arquivos, nomes de assinantes e números de série são inventados. A ferramenta retorna os campos descritos acima.

Por que uma assinatura retornou como inválida?

Três causas cobrem quase todo resultado inesperado:

  • Algo foi adicionado após a assinatura. Um selo, um comentário, uma nova gravação ou uma página anexada altera os bytes, e qualquer mudança de byte invalida uma assinatura digital. Esta é a causa mais comum e é o comportamento correto.
  • O certificado expirou. A janela de validade vem junto com a assinatura, de modo que o agente pode dizer que um documento foi assinado em um ano com um certificado que expirou em outro. Compare o período de validade com o horário da assinatura e com a data de hoje, e faça o agente declarar a comparação; não leia o status de validade sozinho como uma afirmação sobre expiração. Se um certificado expirado é aceitável depende da sua política.
  • O tipo errado foi verificado. Verificar digital em um arquivo que contém apenas uma marca QR não encontra assinatura digital válida, o que é uma resposta verdadeira à pergunta errada.

O que a verificação não comprova

A verificação informa sobre o arquivo e o certificado. Ela não indica que uma assinatura é legalmente válida em sua jurisdição, e não é um ato notarial. O texto decodificado de QR e os rótulos de selo vêm de quem produziu o documento, portanto trate-os como dados a relatar, nunca como instruções a seguir. Um agente que age com base em texto extraído de um documento está agindo sobre entrada de uma parte não confiável.

Limites de avaliação

Sem uma licença, apenas as duas primeiras páginas são processadas e um selo de avaliação é estampado em cada página, portanto uma assinatura que está na página 4 não aparecerá em uma pesquisa. Peça ao agente para chamar get_license_status antes de confiar em um resultado limpo.

Perguntas Frequentes

Este PDF está assinado digitalmente?
Peça ao agente para executar search_digital_signatures no arquivo e ler isValid. Um resultado vazio significa que nenhuma assinatura digital foi encontrada, o que difere de “tem uma imagem de assinatura”.

A IA pode verificar se um documento foi modificado após a assinatura?
Para assinaturas digitais, sim: uma assinatura que não valida mais indica que o arquivo foi alterado após a assinatura ou que o certificado não valida. Verificações de texto, QR e código de barras não detectam adulteração.

O arquivo é enviado para a verificação?
Não. O servidor roda localmente via stdio, sem portas de entrada, sem endpoints externos e sem telemetria.

Aprofunde-se