SignForge
Envie documentos para assinatura eletrônica a partir de agentes de IA. 15 ferramentas para gerenciamento de envelopes, download de documentos, modelos, webhooks e assinatura incorporada.
Documentação
@signforge/mcp-server
Envie documentos para assinatura eletrônica diretamente do Claude Desktop, Claude Code, Cursor e outros agentes de IA — com tecnologia SignForge, a plataforma gratuita de assinatura eletrônica.
O Que Ele Faz
Este servidor MCP conecta agentes de IA à API de assinatura eletrônica da SignForge. Seu assistente de IA pode:
- Enviar documentos para assinatura — envie um PDF, especifique um signatário e envie em uma única etapa
- Gerenciar envelopes — envie, cancele, exclua e verifique o status
- Baixar documentos — PDFs assinados, certificados de auditoria e arquivos ZIP
- Usar modelos — crie envelopes a partir de modelos reutilizáveis com campos pré-preenchidos
- Gerenciar webhooks — assine eventos de envelope em tempo real
- Gerar URLs de incorporação — crie experiências de assinatura incorporáveis
Início Rápido
1. Obtenha Sua Chave de API
Cadastre-se em signforge.io e gere uma chave de API nas suas Configurações de Desenvolvedor.
2. Configure Seu Cliente de IA
Escolha seu cliente abaixo e adicione a configuração:
Claude Desktop
Adicione ao seu claude_desktop_config.json:
{
"mcpServers": {
"signforge": {
"command": "npx",
"args": ["-y", "@signforge/mcp-server"],
"env": {
"SIGNFORGE_API_KEY": "your-api-key-here"
}
}
}
}
Localização do arquivo de configuração:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Claude Code
claude mcp add signforge -- npx -y @signforge/mcp-server
Em seguida, defina a variável de ambiente no seu shell:
export SIGNFORGE_API_KEY="your-api-key-here"
Cursor
Adicione às configurações MCP do Cursor (.cursor/mcp.json):
{
"mcpServers": {
"signforge": {
"command": "npx",
"args": ["-y", "@signforge/mcp-server"],
"env": {
"SIGNFORGE_API_KEY": "your-api-key-here"
}
}
}
}
Direto (npx)
SIGNFORGE_API_KEY="your-api-key-here" npx -y @signforge/mcp-server
3. Reinicie Seu Cliente
Reinicie o Claude Desktop, Claude Code ou Cursor para carregar o novo servidor MCP.
Ferramentas
Gerenciamento de Envelopes
| Ferramenta | Descrição |
|---|---|
create_and_send | Envie um PDF, adicione um signatário e envie para assinatura eletrônica. Aceita um caminho de arquivo local ou PDF codificado em base64. |
check_status | Verifique o status de um envelope — veja o progresso da assinatura, carimbos de data/hora e documentos disponíveis. |
list_envelopes | Liste seus envelopes com filtro opcional de status (draft, sent, completed, voided, expired). |
send_envelope | Envie um envelope rascunho para assinatura. |
void_envelope | Cancele (anule) um envelope ativo com um motivo opcional. |
delete_envelope | Exclua permanentemente um envelope rascunho ou cancelado. |
Downloads de Documentos
| Ferramenta | Descrição |
|---|---|
download_signed | Baixe o PDF assinado de um envelope concluído para um arquivo local. |
download_certificate | Baixe o certificado de auditoria em PDF com o histórico completo de auditoria. |
download_archive | Baixe um arquivo ZIP com o PDF assinado, certificado e todos os documentos. |
Assinatura Incorporada
| Ferramenta | Descrição |
|---|---|
get_embed_url | Gere uma URL de assinatura incorporável para experiências de assinatura no aplicativo. |
Modelos
| Ferramenta | Descrição |
|---|---|
list_templates | Liste seus modelos de documentos reutilizáveis. |
create_from_template | Crie um envelope a partir de um modelo com valores de campo pré-preenchidos opcionais. Envie imediatamente ou salve como rascunho. |
Webhooks
| Ferramenta | Descrição |
|---|---|
create_webhook | Assine eventos de envelope (enviado, visualizado, assinado, concluído, expirado, cancelado, recusado). |
list_webhooks | Liste todos os webhooks configurados. |
delete_webhook | Exclua um webhook por ID. |
Exemplos de Conversas
Enviar um documento para assinatura
You: Send my NDA at ~/Documents/nda.pdf to jane@example.com (Jane Smith) for signature.
AI: I'll send that NDA for signature now.
[Uses create_and_send tool]
Done! I've created and sent the envelope:
- Envelope ID: a1b2c3d4-...
- Status: sent
- Jane Smith (jane@example.com) will receive a signing link via email.
Verificar status e baixar
You: Has Jane signed the NDA yet?
AI: Let me check.
[Uses check_status tool]
Yes! Jane signed it on April 7 at 2:15 PM. The envelope is now completed.
You: Great, download the signed copy and the audit certificate.
[Uses download_signed tool]
[Uses download_certificate tool]
Done! Files saved:
- Signed PDF: ~/Documents/nda-signed.pdf
- Audit Certificate: ~/Documents/nda-certificate.pdf
Usar um modelo com campos pré-preenchidos
You: Send our standard consulting agreement to bob@acme.com.
Pre-fill the company name as "Acme Corp" and the start date as "May 1, 2026".
AI: I'll create that from your consulting agreement template.
[Uses list_templates tool — finds "Consulting Agreement" template]
[Uses create_from_template tool — with prefill_fields and send_immediately: true]
Done! Envelope created and sent:
- Title: Consulting Agreement
- Recipient: bob@acme.com
- Pre-filled: company = "Acme Corp", start_date = "May 1, 2026"
- Status: sent
Gerenciar o ciclo de vida do envelope
You: List my sent envelopes.
[Uses list_envelopes tool with status: "sent"]
You: Void the contract for Project Alpha — the deal fell through.
[Uses void_envelope tool with reason]
You: Now delete it.
[Uses delete_envelope tool]
Done — envelope voided and deleted.
Configurar um webhook
You: Set up a webhook to notify my server when documents are signed or completed.
[Uses create_webhook tool]
Webhook created:
- URL: https://api.yourapp.com/webhooks/signforge
- Events: envelope.signed, envelope.completed
- Secret: whsec_abc123... (save this for signature verification!)
Variáveis de Ambiente
| Variável | Obrigatória | Padrão | Descrição |
|---|---|---|---|
SIGNFORGE_API_KEY | Sim | — | Sua chave de API da SignForge. Obtenha uma em signforge.io/dashboard/developers. |
SIGNFORGE_API_URL | Não | https://signforge.io/api/v1 | URL base da API. Altere apenas para instâncias auto-hospedadas ou de homologação. |
Modo Sandbox
Chaves de API criadas no modo sandbox criarão envelopes de teste que não enviam e-mails reais. Use o modo sandbox durante o desenvolvimento e os testes.
Solução de Problemas
"SIGNFORGE_API_KEY environment variable is required"
Certifique-se de ter definido o SIGNFORGE_API_KEY na configuração do seu cliente MCP. Consulte as instruções de configuração acima.
"SignForge API error (401)" Sua chave de API é inválida ou expirou. Gere uma nova em signforge.io/dashboard/developers.
"SignForge API error (403)" Sua chave de API não tem permissão para esta operação. Verifique os escopos da sua chave.
"SignForge API error (429)" Você atingiu o limite de taxa. Aguarde um momento e tente novamente.
Servidor não aparece no Claude Desktop
- Certifique-se de que o JSON de configuração é válido (sem vírgulas finais)
- Reinicie o Claude Desktop completamente (sair + reabrir)
- Verifique os logs do servidor MCP no console do desenvolvedor do Claude Desktop
Links
- SignForge — Plataforma gratuita de assinatura eletrônica
- Documentação da API — Referência completa da API
- GitHub — Código-fonte
- Protocolo MCP — Especificação do Model Context Protocol
Licença
MIT