Pré-requisitos
- Conta na ZapSign com
api_token(Configurações → Integrações → API). - Codex CLI instalado:
npm install -g @openai/codex. - Node.js 18+.
Passo a passo
Gere seu token da API ZapSign
Em app.zapsign.com.br → Configurações → Integrações → API, copie o api_token.
Adicione o servidor ao config.toml
Edite (ou crie) o arquivo ~/.codex/config.toml e acrescente:
~/.codex/config.tomlTOML
[mcp_servers.zapsign] command = "npx" args = ["-y", "mcp-server-zapsign"] [mcp_servers.zapsign.env] ZAPSIGN_API_KEY = "seu_api_token" ZAPSIGN_BASE_URL = "https://api.zapsign.com.br"
Alternativa via linha de comando (Codex recente):
terminalbash
codex mcp add zapsign \
--env ZAPSIGN_API_KEY=seu_api_token \
-- npx -y mcp-server-zapsign
Verifique a conexão
Inicie o Codex e liste os servidores MCP:
terminalbash
codex
# dentro da sessão:
/mcp
O servidor zapsign deve aparecer com suas ferramentas (documentos, signatários, modelos, webhooks, background checks e timestamp).
Teste com um documento real
prompt no Codexchat
Crie um documento na ZapSign chamado "Teste Codex" a partir de
https://zapsign.s3.amazonaws.com/exemplo.pdf, adicione
Seu Nome <voce@empresa.com> como signatário e retorne
o link de assinatura.
Ideias de automação no terminal
- Script de onboarding: "para cada linha deste CSV, crie um contrato a partir do modelo X e envie ao e-mail da coluna 2."
- Auditoria: "liste todos os documentos criados neste mês com status pendente e gere um resumo em Markdown."
- CI de contratos: gere documentos de homologação automaticamente após cada release.
Problemas comuns
| Sintoma | Causa provável e correção |
|---|---|
Servidor não listado no /mcp | TOML inválido (aspas/colchetes) ou seção com nome errado — deve ser [mcp_servers.zapsign]. |
401 Unauthorized | Token errado em ZAPSIGN_API_KEY. Gere um novo no painel. |
| Timeout ao iniciar | Primeira execução do npx baixa o pacote. Rode npx -y mcp-server-zapsign manualmente uma vez e tente de novo. |