Pré-requisitos
- Conta na ZapSign com
api_token(Configurações → Integrações → API). - Gemini CLI instalado:
npm install -g @google/gemini-cli. - 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 settings.json
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://api.zapsign.com.br"
}
}
}
}
Verifique com /mcp
terminalbash
gemini
# dentro da sessão:
/mcp
O servidor zapsign deve aparecer como CONNECTED, com as ferramentas de documentos, signatários, modelos e webhooks 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.
Problemas comuns
| Sintoma | Causa provável e correção |
|---|---|
Servidor DISCONNECTED no /mcp | JSON inválido ou npx indisponível. Valide o arquivo e teste npx -y mcp-server-zapsign à mão. |
401 Unauthorized | Token errado em ZAPSIGN_API_KEY. Gere um novo no painel da ZapSign. |
| Ferramenta não é chamada | Seja explícito no prompt ("usando as ferramentas da ZapSign…") ou verifique se outro servidor MCP tem nomes conflitantes. |