Pruébalo en vivo

Ejecuta este flujo en ZapSign Builders — el playground interactivo de la API REST. Abrir en Builders →

Requisitos previos

  • Cuenta ZapSign con api_token.
  • Codex CLI: npm install -g @openai/codex.
  • Node.js 18+.

Paso a paso

Conectar vía URL Recomendado

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

Codex abre un flujo OAuth/autorización en la primera conexión. Pega tu api_token.

Verifica la conexión

terminalbash
codex
# dentro de la sesión:
/mcp

Prueba con un documento real

Prompt de ejemplochat
Create a ZapSign document named "Codex test" from
https://zapsign.s3.amazonaws.com/exemplo.pdf, add
Your Name <you@company.com> as signer and return
the signing link.
Alternativa: stdio en config.toml
~/.codex/config.tomlTOML
[mcp_servers.zapsign]
command = "npx"
args = ["-y", "mcp-server-zapsign"]

[mcp_servers.zapsign.env]
ZAPSIGN_API_KEY = "your_api_token"
ZAPSIGN_BASE_URL = "https://sandbox.zapsign.com.br/api/v1"

Ideas de automatización

  • Script de onboarding: "por cada fila del CSV, crea un contrato desde la plantilla X y el correo de la columna 2."
  • Auditoría: "lista todos los documentos pendientes de este mes y resume en Markdown."
  • CI de contratos: genera documentos de staging después de cada release.

Problemas comunes

SíntomaCausa probable y corrección
Servidor ausente en /mcpTOML inválido o nombre de sección incorrecto — debe ser [mcp_servers.zapsign].
401 UnauthorizedToken incorrecto. Regenera y vuelve a conectar.
Timeout de arranque (stdio)La primera descarga de npx es lenta. Ejecútalo una vez manualmente.

Próximos pasos