# ZapSign para Agentes de IA

> Hub de tutoriais para integrar agentes de IA (Claude, ChatGPT, Cursor, Codex, Gemini) à ZapSign, plataforma de assinatura eletrônica líder na América Latina. Cobre o servidor MCP oficial (mcp-server-zapsign) e a API REST (api.zapsign.com.br). Conteúdo em português (pt-BR).

Fatos essenciais:
- Servidor MCP oficial: pacote npm `mcp-server-zapsign`, código em https://github.com/ZapSign/api-mcp (modos stdio e SSE; autenticação via variável de ambiente ZAPSIGN_API_KEY).
- API REST: base https://api.zapsign.com.br, autenticação `Authorization: Bearer <api_token>`. Criação de documento: `POST /api/v1/docs/`. Webhooks: `POST /api/v1/user/company/webhook/`.
- Token da API: gerado em app.zapsign.com.br → Configurações → Integrações → API.
- Documentação consultável por IA: `GET https://docs.zapsign.com.br/master.md?ask=<pergunta>` retorna o trecho relevante da doc.
- ZapSign: 70+ milhões de documentos assinados, 81+ países, ISO 27001, Autoridade Certificadora ICP-Brasil, assinaturas validadas pelo STJ (REsp 2.159.442). Plano gratuito: 5 documentos/mês.

## Tutoriais por ferramenta

- [Conectar o Claude à ZapSign via MCP](https://agents.zapsign.com.br/tutoriais/claude.html): Claude Desktop (claude_desktop_config.json) e Claude Code (claude mcp add), MCP local via npx.
- [Conectar o ChatGPT à ZapSign](https://agents.zapsign.com.br/tutoriais/chatgpt.html): conector MCP remoto em modo SSE com URL pública, ou GPT personalizado com Actions sobre a API.
- [Conectar o Cursor à ZapSign via MCP](https://agents.zapsign.com.br/tutoriais/cursor.html): mcp.json global (~/.cursor/) ou por projeto (.cursor/), fluxo de desenvolvimento com validação contra a API real.
- [Conectar o Codex CLI à ZapSign via MCP](https://agents.zapsign.com.br/tutoriais/codex.html): seção [mcp_servers.zapsign] no ~/.codex/config.toml.
- [Conectar o Gemini CLI à ZapSign via MCP](https://agents.zapsign.com.br/tutoriais/gemini.html): bloco mcpServers no ~/.gemini/settings.json.

## Guias técnicos

- [Servidor MCP da ZapSign: guia completo](https://agents.zapsign.com.br/tutoriais/servidor-mcp.html): instalação, configuração (.env), modos stdio/SSE, lista completa de ferramentas (documentos, modelos, signatários, background checks, webhooks, timestamp), deploy Docker+Traefik, segurança.
- [Primeiro documento com a API ZapSign](https://agents.zapsign.com.br/tutoriais/primeiro-documento-api.html): quickstart REST com cURL — autenticação, POST /api/v1/docs/ com signers, acompanhamento de status, webhooks.

## Recursos externos

- [Documentação oficial da API](https://docs.zapsign.com.br/): referência completa de endpoints, SDKs TypeScript/Java/Go.
- [llms.txt da documentação](https://docs.zapsign.com.br/llms.txt): índice da API em formato para LLMs.
- [Repositório do servidor MCP](https://github.com/ZapSign/api-mcp): código open source, issues e contribuições.
- [ZapBuilders](https://builder.zapsign.com.br/): hub de documentação técnica multilíngue (PT/EN/ES).
- [ZapSign](https://zapsign.com.br/): site principal da plataforma.