Pré-requisitos

Passo a passo

Gere seu token da API ZapSign

Acesse app.zapsign.com.br → Configurações → Integrações → API e copie o api_token. Ele autentica todas as chamadas que o Claude fará em seu nome.

Trate o token como senha. Não compartilhe em chats, repositórios ou prompts públicos. Você pode revogá-lo e gerar outro a qualquer momento no painel.

Adicione o servidor MCP ao Claude Desktop

Abra o arquivo de configuração do Claude Desktop:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

E adicione o bloco abaixo (ou apenas a chave zapsign, se já houver outros servidores):

claude_desktop_config.jsonJSON
{
  "mcpServers": {
    "zapsign": {
      "command": "npx",
      "args": ["-y", "mcp-server-zapsign"],
      "env": {
        "ZAPSIGN_API_KEY": "seu_api_token",
        "ZAPSIGN_BASE_URL": "https://api.zapsign.com.br"
      }
    }
  }
}

Ou adicione ao Claude Code (terminal)

Se você prefere o Claude no terminal, um único comando resolve:

terminalbash
claude mcp add zapsign \
  --env ZAPSIGN_API_KEY=seu_api_token \
  -- npx -y mcp-server-zapsign

Verifique com claude mcp list — o servidor zapsign deve aparecer como conectado.

Reinicie e confira as ferramentas

Reinicie o Claude Desktop. No campo de mensagem, clique no ícone de ferramentas (🔌): as ferramentas da ZapSign — como create_document_from_upload, list_templates e add_signer — devem estar listadas.

Teste com um documento real

Envie um prompt de teste usando seu próprio e-mail como signatário:

prompt no Claudechat
Crie um documento na ZapSign chamado "Teste MCP" a partir
deste PDF: https://zapsign.s3.amazonaws.com/exemplo.pdf
Adicione como signatário: Seu Nome <voce@empresa.com>
e me devolva o link de assinatura.

O Claude vai chamar a ferramenta, criar o documento na sua conta e devolver o sign_url. Abra o link, assine — pronto: seu primeiro documento assinado via agente de IA. ✅

O que pedir ao Claude depois

  • "Liste meus documentos pendentes de assinatura e me diga quem falta assinar."
  • "Crie um contrato a partir do modelo 'Prestação de Serviços' preenchendo nome e CNPJ do cliente X."
  • "Adicione a Maria (maria@empresa.com) como segunda signatária do documento Y."
  • "Configure um webhook para me avisar em https://minha-api.com/webhook quando documentos forem assinados."

Problemas comuns

SintomaCausa provável e correção
Servidor não aparece no ClaudeJSON inválido no config (vírgula sobrando?) ou Claude não foi reiniciado por completo. Valide o JSON e reinicie.
401 UnauthorizedToken errado ou revogado. Gere um novo em Configurações → Integrações → API e atualize ZAPSIGN_API_KEY.
npx: command not foundNode.js não instalado ou fora do PATH da aplicação. Instale o Node 18+ e reinicie a máquina.
Ferramenta falha ao criar documentoConfira se a URL do PDF é pública e acessível. Para arquivos locais, peça ao Claude para usar base64.

Próximos passos