Teste ao vivo

Execute este fluxo no ZapSign Builders — playground interativo da API REST. Abrir no Builders →

Pré-requisitos

Por que URL? Diferente do Claude Desktop e do Cursor, o ChatGPT não executa servidores MCP locais via stdio — ele consome conectores por URL. O servidor MCP da ZapSign já está hospedado e pronto para uso em mcp.zapsign.com.br.

Caminho 1 — Conector MCP via URL (recomendado)

Gere seu token da API ZapSign

Acesse app.zapsign.com.br → Configurações → Integrações → API e copie o api_token.

Adicione o conector no ChatGPT

No ChatGPT: Settings → Apps & Connectors → Advanced → Developer mode (ative). Depois, em Connectors → Create, informe:

  • Nome: ZapSign
  • URL do servidor MCP:
URL do servidor MCP ZapSignURL
https://mcp.zapsign.com.br/mcp

O ChatGPT vai redirecionar para a tela de autorização da ZapSign. Cole seu api_token no campo indicado para completar a conexão.

Teste no chat

prompt no ChatGPTchat
Usando o conector ZapSign, liste meus modelos de documento
e crie um documento de teste chamado "Teste ChatGPT" a partir
do PDF https://zapsign.s3.amazonaws.com/exemplo.pdf com
signatário Seu Nome <voce@empresa.com>.

Caminho 2 — GPT personalizado com Actions

Se você não quer usar o modo desenvolvedor, crie um GPT personalizado que chama a API da ZapSign diretamente:

  1. Em chatgpt.com → GPTs → Create, abra a aba Configure → Actions.
  2. Importe/descreva um schema OpenAPI com os endpoints que quiser expor — comece por POST /api/v1/docs/ (criar documento) e GET /api/v1/docs/ (listar). A documentação oficial tem os schemas de request/response.
  3. Em Authentication, escolha API Key → Bearer e cole seu api_token.
  4. Instrua o GPT: "Você gerencia documentos de assinatura eletrônica na ZapSign. Sempre confirme nome e e-mail do signatário antes de criar um documento."

Atenção ao compartilhar o GPT: o token embutido nas Actions dá acesso → sua conta. Mantenha o GPT privado ou use uma conta/workspace dedicado com permissões mínimas.

Problemas comuns

SintomaCausa provável e correção
Conector não conectaConfirme que a URL está exatamente como https://mcp.zapsign.com.br/mcp — sem barra no final.
401 nas ferramentasToken inválido ou expirado. Reconecte o conector e insira um novo token na tela de autorização.
Timeout em criação de documentoPDF de origem lento/inacessível. Use uma URL pública rápida ou base64.

Próximos passos