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 edite (ou crie) ~/.gemini/settings.json e adicione:

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

Na primeira conexão, o Gemini vai redirecionar para a tela de autorização da ZapSign. Cole seu api_token para completar.

Verifique com /mcp

terminalbash
gemini
# dentro da sessão:
/mcp

O servidor zapsign deve aparecer como CONNECTED, com as ferramentas de documentos, signatários e modelos listadas.

Teste com um documento real

prompt no Geminichat
Crie um documento na ZapSign chamado "Teste Gemini" 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.

O Gemini pedirá confirmação antes de executar a ferramenta e devolverá o sign_url.

Alternativa: configuração manual via stdio no settings.json (para desenvolvedores)

Adicione o servidor via stdio

Edite (ou crie) ~/.gemini/settings.json — ou .gemini/settings.json na raiz do projeto para escopo local:

~/.gemini/settings.jsonJSON
{
  "mcpServers": {
    "zapsign": {
      "command": "npx",
      "args": ["-y", "mcp-server-zapsign"],
      "env": {
        "ZAPSIGN_API_KEY": "seu_api_token",
        "ZAPSIGN_BASE_URL": "https://sandbox.zapsign.com.br/api/v1"
      }
    }
  }
}

Problemas comuns

SintomaCausa provável e correção
Servidor DISCONNECTED no /mcpURL incorreta ou token inválido. Confirme a URL https://mcp.zapsign.com.br/mcp e reconecte.
401 UnauthorizedToken errado. Gere um novo no painel e reconecte.
Ferramenta não → chamadaSeja explícito no prompt ("usando as ferramentas da ZapSign?") ou verifique se outro servidor MCP tem nomes conflitantes.

Próximos passos