SignForge
Envía documentos para firma electrónica desde agentes de IA. 15 herramientas para gestión de sobres, descarga de documentos, plantillas, webhooks y firma integrada.
Documentación
@signforge/mcp-server
Envía documentos para firma electrónica directamente desde Claude Desktop, Claude Code, Cursor y otros agentes de IA, con la tecnología de SignForge, la plataforma gratuita de firma electrónica.
Qué Hace
Este servidor MCP conecta agentes de IA con la API de firma electrónica de SignForge. Tu asistente de IA puede:
- Enviar documentos para firma — sube un PDF, especifica un firmante y envíalo en un solo paso
- Gestionar sobres — enviar, anular, eliminar y consultar el estado
- Descargar documentos — PDF firmados, certificados de auditoría y archivos ZIP
- Usar plantillas — crear sobres a partir de plantillas reutilizables con campos prellenados
- Gestionar webhooks — suscribirse a eventos de sobres en tiempo real
- Generar URL de inserción — crear experiencias de firma integrables
Inicio Rápido
1. Obtén tu Clave de API
Regístrate en signforge.io y genera una clave de API desde tu Configuración de Desarrollador.
2. Configura tu Cliente de IA
Elige tu cliente a continuación y añade la configuración:
Claude Desktop
Añade a tu claude_desktop_config.json:
{
"mcpServers": {
"signforge": {
"command": "npx",
"args": ["-y", "@signforge/mcp-server"],
"env": {
"SIGNFORGE_API_KEY": "your-api-key-here"
}
}
}
}
Ubicación del archivo de configuración:
- 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
Luego establece la variable de entorno en tu shell:
export SIGNFORGE_API_KEY="your-api-key-here"
Cursor
Añade a tu configuración de MCP de Cursor (.cursor/mcp.json):
{
"mcpServers": {
"signforge": {
"command": "npx",
"args": ["-y", "@signforge/mcp-server"],
"env": {
"SIGNFORGE_API_KEY": "your-api-key-here"
}
}
}
}
Directo (npx)
SIGNFORGE_API_KEY="your-api-key-here" npx -y @signforge/mcp-server
3. Reinicia tu Cliente
Reinicia Claude Desktop, Claude Code o Cursor para que detecten el nuevo servidor MCP.
Herramientas
Gestión de Sobres
| Herramienta | Descripción |
|---|---|
create_and_send | Sube un PDF, añade un firmante y envía para firma electrónica. Acepta una ruta de archivo local o un PDF codificado en base64. |
check_status | Consulta el estado de un sobre: progreso de firma, marcas de tiempo y documentos disponibles. |
list_envelopes | Lista tus sobres con filtrado opcional por estado (draft, sent, completed, voided, expired). |
send_envelope | Envía un sobre en borrador para firma. |
void_envelope | Anula (cancela) un sobre activo con un motivo opcional. |
delete_envelope | Elimina permanentemente un sobre en borrador o anulado. |
Descarga de Documentos
| Herramienta | Descripción |
|---|---|
download_signed | Descarga el PDF firmado de un sobre completado a un archivo local. |
download_certificate | Descarga el certificado de auditoría en PDF con el historial completo de auditoría. |
download_archive | Descarga un archivo ZIP con el PDF firmado, el certificado y todos los documentos. |
Firma Integrada
| Herramienta | Descripción |
|---|---|
get_embed_url | Genera una URL de firma integrable para experiencias de firma dentro de la aplicación. |
Plantillas
| Herramienta | Descripción |
|---|---|
list_templates | Lista tus plantillas de documentos reutilizables. |
create_from_template | Crea un sobre a partir de una plantilla con valores de campos prellenados opcionales. Envía inmediatamente o guarda como borrador. |
Webhooks
| Herramienta | Descripción |
|---|---|
create_webhook | Suscríbete a eventos de sobres (enviado, visto, firmado, completado, expirado, anulado, rechazado). |
list_webhooks | Lista todos los webhooks configurados. |
delete_webhook | Elimina un webhook por ID. |
Ejemplos de Conversaciones
Enviar un documento para firma
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.
Consultar estado y descargar
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 una plantilla con campos prellenados
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
Gestionar el ciclo de vida de un sobre
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 un 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!)
Variables de Entorno
| Variable | Obligatoria | Predeterminado | Descripción |
|---|---|---|---|
SIGNFORGE_API_KEY | Sí | — | Tu clave de API de SignForge. Obtén una en signforge.io/dashboard/developers. |
SIGNFORGE_API_URL | No | https://signforge.io/api/v1 | URL base de la API. Solo cámbiala para instancias autoalojadas o de pruebas. |
Modo Sandbox
Las claves de API creadas en modo sandbox generarán sobres de prueba que no envían correos reales. Usa el modo sandbox durante el desarrollo y las pruebas.
Solución de Problemas
"Se requiere la variable de entorno SIGNFORGE_API_KEY"
Asegúrate de haber establecido la SIGNFORGE_API_KEY en la configuración de tu cliente MCP. Consulta las instrucciones de configuración anteriores.
"Error de la API de SignForge (401)" Tu clave de API no es válida o ha caducado. Genera una nueva en signforge.io/dashboard/developers.
"Error de la API de SignForge (403)" Tu clave de API no tiene permiso para esta operación. Comprueba los alcances de tu clave.
"Error de la API de SignForge (429)" Has alcanzado el límite de solicitudes. Espera un momento e inténtalo de nuevo.
El servidor no aparece en Claude Desktop
- Asegúrate de que el JSON de configuración sea válido (sin comas finales)
- Reinicia Claude Desktop por completo (salir + volver a abrir)
- Revisa los registros del servidor MCP en la consola de desarrollador de Claude Desktop
Enlaces
- SignForge — Plataforma gratuita de firma electrónica
- Documentación de la API — Referencia completa de la API
- GitHub — Código fuente
- Protocolo MCP — Especificación del Model Context Protocol
Licencia
MIT