Como Conectar a Claude à Sua Conta SignDocs e Assinar Documentos por Chat (Passo a Passo)

Você já usa o SignDocs Brasil pelo aplicativo ou pelo site. Agora dá para fazer a mesma coisa conversando com a Claude: "envia este contrato para a Ana assinar", "quem ainda não assinou?", "me manda o PDF assinado e as evidências". Não precisa de credencial de API, não precisa instalar nada e a cota é a mesma da sua conta. Este guia mostra o caminho completo, do primeiro clique até o documento assinado, nos três lugares em que a Claude aparece: claude.ai, Claude Desktop e Claude Code.

Vale dizer logo o que este guia não é: não é uma integração para empresas com sistema próprio. Quem é pessoa jurídica ou integrador entra por credencial de API, com ambiente de homologação e o catálogo completo de ferramentas; esse caminho está em Claude com credenciais de API. Aqui o foco é a pessoa física ou o profissional que quer assinar e cobrar assinaturas sem sair do chat.

Resumo em três linhas: adicione https://mcp.signdocs.com.br/mcp como conector personalizado na Claude, entre com a sua conta SignDocs na tela que abre, e peça em português. Cada documento enviado consome um documento do seu plano (5 por mês no plano Grátis), e a Claude sempre pede confirmação antes de enviar.

O que você precisa antes de começar

  • Uma conta SignDocs de pessoa física, criada pelo aplicativo (Android ou iOS) ou pelo site. Se você ainda não tem, crie primeiro: a conexão com a Claude usa exatamente esse login. Contas de pessoa jurídica não entram por este caminho — para elas, o acesso é por credencial de API.
  • Uma conta na Claude — claude.ai, o aplicativo Claude Desktop ou o Claude Code no terminal. Qualquer um dos três serve; o resultado é o mesmo.
  • O documento em PDF que você quer enviar. Ele não passa pelo chat: a Claude te dá um link de upload, e o arquivo vai direto para o SignDocs.
  • Nome, e-mail e CPF (ou CNPJ) de quem vai assinar. O CPF ou CNPJ é obrigatório para todo signatário; sem ele o envio é recusado, e nesse caso nada é descontado da cota.

Quem assina não precisa de conta no SignDocs nem na Claude. Recebe um link, abre no celular, autentica-se do jeito que você escolheu e assina.

Caminho 1: claude.ai (web) — o mais simples

  1. No claude.ai, abra Configurações → Conectores.
  2. Clique em Adicionar conector personalizado. Não procure "SignDocs" na lista pronta: a inclusão no diretório depende de uma revisão da Anthropic, que ainda está em andamento. Adicionar à mão dá exatamente o mesmo resultado.
  3. Cole a URL https://mcp.signdocs.com.br/mcp no campo de endereço.
  4. Deixe os campos Client ID e Client Secret vazios e confirme. Isso é proposital: a Claude se registra sozinha junto ao SignDocs, e a sua senha só é digitada no site do SignDocs, nunca na Claude.
  5. A Claude abre a tela de autorização do SignDocs. Clique em Entrar ou criar conta SignDocs e entre normalmente, com o mesmo e-mail e senha do aplicativo.

Pronto. Volte à conversa e faça o primeiro teste, que não consome nada: "Quanta cota de documentos eu ainda tenho no SignDocs?". Se a Claude responder com o seu plano e o saldo do mês, a conexão está funcionando.

Caminho 2: Claude Desktop

No aplicativo de desktop, o caminho mais direto para uma conta pessoal é o mesmo conector remoto: adicione https://mcp.signdocs.com.br/mcp em Conectores e entre com a conta SignDocs quando a tela abrir. Existe também uma extensão de um clique (.mcpb), publicada nas Releases do plugin no GitHub, que roda o servidor localmente na sua máquina; ela pede Client ID e Client Secret, então é o caminho de quem tem credencial de API, não da conta pessoal. Se você é pessoa física, fique com o conector remoto.

Caminho 3: Claude Code (terminal)

Um comando registra o servidor, e o login abre no navegador:

# registra o conector hospedado claude mcp add --transport http signdocs https://mcp.signdocs.com.br/mcp # dentro do Claude Code, autentica com a sua conta SignDocs /mcp

Ao rodar /mcp, escolha o servidor signdocs e siga o login no navegador. Não há credencial para copiar. Quem prefere o plugin oficial com credencial de API (/plugin marketplace add signdocsbrasil/signdocs-mcp-plugin) está no cenário de pessoa jurídica, descrito no guia de credenciais.

O primeiro envio, de ponta a ponta

Vamos enviar um contrato de prestação de serviços para uma pessoa assinar com clique e código por e-mail. A conversa abaixo é o fluxo real; os dados são fictícios.

1. Peça o link de upload

Você: Quero enviar um PDF para assinatura pelo SignDocs. Me dá o link para eu subir o arquivo.

Claude: chama request_document_upload e devolve um link. Você abre o link, arrasta o PDF e volta ao chat. O arquivo vai direto para o SignDocs; a Claude nunca vê o conteúdo.

Arquivos anexados na própria conversa não chegam às ferramentas do SignDocs. Por isso o link existe. Se o PDF já estiver em um endereço público (um bucket, uma pasta compartilhada com link direto), você também pode simplesmente colar o endereço.

2. Crie a assinatura com todos os dados de uma vez

Você: Já subi o arquivo. Cria a assinatura para: Ana Souza, ana@exemplo.com, CPF 000.000.000-00. Tipo: clique + código por e-mail.

Claude: mostra o resumo (documento, signatária, tipo de autenticação) e pede a sua confirmação. Só depois chama create_signing_session. A resposta vem com o status ACTIVE e o link de assinatura.

Mandar nome, e-mail, CPF e tipo de assinatura na mesma mensagem evita que a Claude pergunte item por item. Os tipos disponíveis nesse caminho são clique, clique + código de uso único por e-mail e certificado digital ICP-Brasil (A1 diretamente; A3 assina pelo assinador SignDocs). Se você não disser o tipo, a Claude pergunta.

3. O que a signatária recebe

A Ana recebe o link de assinatura por e-mail. Abre no celular, confere o documento, recebe o código de uso único no e-mail dela, digita e assina. Ela não cria conta em lugar nenhum. Se o prazo estiver acabando e ela ainda não tiver assinado, a plataforma envia um lembrete automático 24 horas antes de o prazo expirar.

4. Acompanhe

Você: Como está a assinatura que eu criei? Quem já assinou e quem ainda falta?

Claude: chama get_signing_session_status (ou get_envelope, se for um envelope) e resume: pendente, concluída, cancelada ou expirada, com data e hora.

5. Baixe o documento assinado e as evidências

Você: Me manda o link do documento assinado e também as evidências dessa assinatura.

Claude: chama download_document e get_evidence e devolve links temporários para o PDF assinado e para o pacote de evidências (.p7m), que registra quem assinou, quando, de onde e com qual método de autenticação. Guarde os dois arquivos no seu lugar de sempre.

Várias pessoas no mesmo documento

Para um contrato com duas ou três partes, peça um envelope. Um envelope consome um documento da cota, independentemente de quantas pessoas assinem, e pode ser paralelo (qualquer ordem) ou sequencial (um depois do outro):

Você: Já subi o arquivo. Cria um envelope com estes signatários, todos por clique simples, podendo assinar em qualquer ordem: 1) Ana Souza, ana@exemplo.com, CPF 000.000.000-00; 2) Bruno Lima, bruno@exemplo.com, CPF 111.111.111-11.

Claude: confirma com você e chama create_envelope com os dois signatários. Cada um recebe o próprio link.

Um envelope carrega um único documento. Se você tem três PDFs para as mesmas pessoas, são três envelopes (e três documentos da cota) — ou junte os arquivos em um PDF só antes de subir. A lógica de ordem e de múltiplos signatários está explicada em múltiplos signatários e ordem de assinatura.

Quanto custa

Item Custo
Conector e servidor MCP Gratuitos. O servidor é open source (MIT).
Enviar um documento (sessão ou envelope) 1 documento do seu plano, por documento — não por signatário.
Plano Grátis 5 documentos por mês.
Cancelar um envio Não devolve o documento à cota — igual ao aplicativo.
Consultar status, baixar assinado, verificar evidências Não consomem cota.

Os planos pagos do aplicativo, com mais documentos por mês, estão em Planos e Preços. Pela Claude você gasta exatamente a cota que gastaria no app; muda só o canal.

As 13 ferramentas, em português claro

Entrando com a sua conta, a Claude recebe treze ferramentas. Você nunca precisa digitar o nome delas — a Claude escolhe pelo que você pede — mas ajuda saber o que existe:

Ferramenta O que faz Consome cota?
get_my_accountMostra seu plano e o saldo de documentos do mês.Não
request_document_uploadGera o link para você subir o PDF.Não
create_signing_sessionEnvia um documento para uma pessoa assinar.Sim
create_envelopeEnvia um documento para várias pessoas assinarem.Sim
get_signing_session_statusDiz em que pé está uma assinatura.Não
get_envelopeDiz quem já assinou e quem falta num envelope.Não
download_documentLink temporário para o PDF assinado.Não
get_evidenceLink temporário para o pacote de evidências (.p7m).Não
verify_evidenceConfere um pacote de evidências no verificador público.Não
verify_envelopeConfere um envelope no verificador público.Não
verify_documentDetecta assinaturas em um PDF que você recebeu.Consome cota
cancel_signing_sessionCancela um envio que ninguém assinou ainda.Não devolve
cancel_envelopeCancela um envelope pendente.Não devolve

As ferramentas de criar e cancelar são marcadas como sensíveis no protocolo: a Claude descreve o que vai fazer e espera o seu "pode". Nada com efeito jurídico sai sem você dizer que sim.

Limites que você deve conhecer

  • Não há "listar tudo". Entrando com a conta, a Claude não lista todas as suas sessões ou transações — ela consulta uma por vez, pelo identificador que ela mesma criou na conversa. Para ver o histórico completo, use o aplicativo. Isso é uma escolha de privacidade do modo de conta pessoal.
  • Você já está em produção. Com a conta do aplicativo não existe ambiente de teste: cada envio vale juridicamente e consome cota. O ambiente de homologação existe apenas para quem acessa por credencial de API.
  • Pessoa jurídica usa credencial. Contas PJ e subusuários não entram pelo conector pessoal. O caminho está em Claude com credenciais de API.
  • A conversa não é prova. O que confirma que uma assinatura aconteceu é a lista de documentos no aplicativo e o e-mail de conclusão — não o que a Claude escreveu. Na dúvida, peça o status ou abra o app.
  • Anexos do chat não viajam. Sempre pelo link de upload ou por um endereço público do PDF.
  • Só a Claude é testada. Outros clientes falam o padrão MCP e podem conectar ao mesmo endereço, mas o caminho com guia, suporte e testes é o da Claude. Detalhes em Servidor MCP.

Erros comuns e o que fazer

Sintoma Causa provável Correção
A tela de login pede para "concluir o cadastro" A conta foi criada agora e ainda não passou pelo primeiro acesso no aplicativo. Abra o app, complete o cadastro (nome e CPF) e tente conectar de novo.
"Conta não elegível" ao autorizar Conta de pessoa jurídica ou subusuário. Use o caminho por credencial de API.
O envio foi recusado Faltou CPF/CNPJ do signatário, ou o documento ainda não subiu. Informe o CPF e confirme que abriu o link de upload. Recusa não consome cota.
"Cota esgotada" Os 5 documentos do mês (ou os do seu plano) acabaram. Aguarde a virada do mês ou mude de plano no aplicativo.
A Claude "acha" que enviou, mas não há nada no app Você não confirmou, ou a chamada não chegou. Peça o status; se não existir, repita o envio. O app é a fonte de verdade.

Para ir além dos exemplos deste guia, há uma lista de 20 prompts prontos cobrindo cobrança de pendentes, cancelamentos, verificação de PDFs recebidos e conferência de evidências.

Perguntas Frequentes

Preciso de credencial de API para usar a Claude com o SignDocs?

Não, se você é pessoa física. Basta adicionar o conector https://mcp.signdocs.com.br/mcp na Claude, deixar os campos de Client ID e Client Secret vazios e entrar com a mesma conta que você usa no aplicativo SignDocs. A senha é digitada só no site do SignDocs. Credencial de API é o caminho de pessoas jurídicas e integradores, que também ganham o ambiente de homologação e o catálogo completo de ferramentas.

Quanto custa assinar pela Claude?

O conector e o servidor MCP são gratuitos e de código aberto. O que consome é o envio: cada documento enviado para assinatura (sessão ou envelope) desconta um documento do seu plano, por documento e não por signatário. No plano Grátis são 5 documentos por mês. Consultar status, baixar o assinado e verificar evidências não consomem nada. Cancelar um envio não devolve o documento à cota.

Como envio o PDF se anexos do chat não chegam ao SignDocs?

Peça à Claude o link de upload. Ela chama a ferramenta request_document_upload e devolve um endereço onde você arrasta o PDF; o arquivo vai direto para o SignDocs, sem passar pela conversa. Se o PDF já estiver em um endereço público com link direto, você pode colar o endereço. Depois disso, envie nome, e-mail, CPF e o tipo de assinatura numa única mensagem e confirme quando a Claude perguntar.

A Claude pode enviar ou cancelar algo sem eu saber?

As ferramentas de criar e cancelar são marcadas como sensíveis no protocolo MCP, então a Claude descreve o que vai fazer e espera a sua confirmação antes de executar. Ainda assim, trate a conversa como um assistente, não como registro: a prova de que uma assinatura aconteceu é a lista de documentos no aplicativo e o e-mail de conclusão. Na dúvida, peça o status.

Quais tipos de assinatura posso pedir entrando com a minha conta?

Clique simples, clique com código de uso único por e-mail e certificado digital ICP-Brasil. O certificado A1 assina diretamente; o A3, em token ou cartão, assina pelo assinador SignDocs. O CPF ou CNPJ do signatário é obrigatório em qualquer um dos tipos; sem ele o envio é recusado e nada é descontado da cota.

Por que a Claude não lista todas as minhas assinaturas?

Entrando com a conta pessoal, as ferramentas de listagem ficam de fora por uma decisão de privacidade: a Claude consulta uma sessão ou um envelope por vez, pelo identificador criado na própria conversa. O histórico completo continua no aplicativo. Quem acessa por credencial de API tem as ferramentas de listagem de sessões e transações, além dos webhooks.

Conecte a Claude à sua conta e faça o primeiro envio hoje

Sem credencial, sem instalação: adicione o conector, entre com a conta do aplicativo e peça a primeira assinatura em português. A cota é a mesma de sempre — 5 documentos por mês no plano Grátis.

Conectar a Claude à sua conta Conheça a plataforma grátis