Pré-requisitos

  • Conta na ZapSign com api_token (Configurações → Integrações → API).
  • Plano do ChatGPT com suporte a conectores/modo desenvolvedor (Plus, Pro, Team ou Enterprise).
  • Um lugar para rodar o servidor com URL pública HTTPS: VPS, Railway, Render, Fly.io ou Docker + Traefik.

Por que remoto? Diferente do Claude Desktop e do Cursor, o ChatGPT não executa servidores MCP locais via stdio — ele consome conectores por URL. O repositório oficial já traz o modo SSE e setup Docker/Traefik prontos para isso.

Caminho 1 — Conector MCP (recomendado)

Clone e configure o servidor

terminalbash
git clone https://github.com/ZapSign/api-mcp.git
cd api-mcp
npm install
cp .env.example .env

No .env, preencha ao menos:

.envenv
ZAPSIGN_API_KEY=seu_api_token
ZAPSIGN_BASE_URL=https://api.zapsign.com.br
PORT=3001
ENABLE_RATE_LIMITING=true

Suba em modo SSE com URL pública

Local (para testar com um túnel como ngrok/cloudflared):

terminalbash
npm run start:sse
# Health check:
curl http://localhost:3001/health

Em produção, o repositório traz Docker Compose com Traefik (TLS automático):

terminalbash
chmod +x setup-traefik.sh
./setup-traefik.sh
docker-compose up -d

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: https://seu-dominio.com/sse
  • Autenticação: conforme sua exposição do servidor (o token da ZapSign já fica no .env do servidor, não no ChatGPT).

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 hospedar nada, 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 conectaURL sem HTTPS válido ou endpoint SSE errado. Confirme o /health e o caminho do SSE.
401 nas ferramentasZAPSIGN_API_KEY ausente/errada no .env do servidor. Reinicie após corrigir.
Timeout em criação de documentoPDF de origem lento/inacessível. Use uma URL pública rápida ou base64.

Próximos passos