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.
  • Gemini CLI: npm install -g @google/gemini-cli.
  • Node.js 18+.

Paso a paso

Conectar vía URL Recomendado

~/.gemini/settings.jsonJSON
{
  "mcpServers": {
    "zapsign": {
      "type": "url",
      "url": "https://mcp.zapsign.com.br/mcp"
    }
  }
}

Verifica con /mcp

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

El servidor zapsign debería aparecer como CONNECTED.

Prueba con un documento real

Prompt de ejemplochat
Create a ZapSign document named "Gemini 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 settings.json
~/.gemini/settings.jsonJSON
{
  "mcpServers": {
    "zapsign": {
      "command": "npx",
      "args": ["-y", "mcp-server-zapsign"],
      "env": {
        "ZAPSIGN_API_KEY": "your_api_token",
        "ZAPSIGN_BASE_URL": "https://sandbox.zapsign.com.br/api/v1"
      }
    }
  }
}

Problemas comunes

SíntomaCausa probable y corrección
Servidor DISCONNECTED en /mcpURL incorrecta o token inválido. Confirma https://mcp.zapsign.com.br/mcp y vuelve a conectar.
401 UnauthorizedToken incorrecto. Regenera y vuelve a conectar.
Herramienta no llamadaSé explícito ("usando herramientas ZapSign") o revisa nombres de servidores MCP en conflicto.

Próximos pasos