Teste ao vivo

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

Pré-requisitos

Passo a passo

Opção mais fácil: conecte via URL Recomendado

Gere seu token em app.zapsign.com.br → Configurações → Integrações → API. Depois adicione o servidor MCP via URL no config.toml:

~/.codex/config.tomlTOML
[mcp_servers.zapsign]
type = "url"
url = "https://mcp.zapsign.com.br/mcp"

O Codex vai abrir um fluxo de autorização OAuth na primeira conexão. Cole seu api_token na tela de autorização da ZapSign para completar.

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).

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.
Alternativa: configuração manual via stdio no config.toml (para desenvolvedores)

Adicione o servidor ao config.toml via stdio

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://sandbox.zapsign.com.br/api/v1"

Alternativa via linha de comando (Codex recente):

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

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

SintomaCausa provável e correção
Servidor não listado no /mcpTOML inválido (aspas/colchetes) ou seção com nome errado — deve ser [mcp_servers.zapsign].
401 UnauthorizedToken errado. Gere um novo no painel ou reconecte via URL.
Timeout ao iniciar (modo stdio)Primeira execução do npx baixa o pacote. Rode npx -y mcp-server-zapsign manualmente uma vez e tente de novo.

Próximos passos