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

HerramientaDescripción
create_and_sendSube 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_statusConsulta el estado de un sobre: progreso de firma, marcas de tiempo y documentos disponibles.
list_envelopesLista tus sobres con filtrado opcional por estado (draft, sent, completed, voided, expired).
send_envelopeEnvía un sobre en borrador para firma.
void_envelopeAnula (cancela) un sobre activo con un motivo opcional.
delete_envelopeElimina permanentemente un sobre en borrador o anulado.

Descarga de Documentos

HerramientaDescripción
download_signedDescarga el PDF firmado de un sobre completado a un archivo local.
download_certificateDescarga el certificado de auditoría en PDF con el historial completo de auditoría.
download_archiveDescarga un archivo ZIP con el PDF firmado, el certificado y todos los documentos.

Firma Integrada

HerramientaDescripción
get_embed_urlGenera una URL de firma integrable para experiencias de firma dentro de la aplicación.

Plantillas

HerramientaDescripción
list_templatesLista tus plantillas de documentos reutilizables.
create_from_templateCrea un sobre a partir de una plantilla con valores de campos prellenados opcionales. Envía inmediatamente o guarda como borrador.

Webhooks

HerramientaDescripción
create_webhookSuscríbete a eventos de sobres (enviado, visto, firmado, completado, expirado, anulado, rechazado).
list_webhooksLista todos los webhooks configurados.
delete_webhookElimina 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

VariableObligatoriaPredeterminadoDescripción
SIGNFORGE_API_KEYTu clave de API de SignForge. Obtén una en signforge.io/dashboard/developers.
SIGNFORGE_API_URLNohttps://signforge.io/api/v1URL 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

  1. Asegúrate de que el JSON de configuración sea válido (sin comas finales)
  2. Reinicia Claude Desktop por completo (salir + volver a abrir)
  3. Revisa los registros del servidor MCP en la consola de desarrollador de Claude Desktop

Enlaces

Licencia

MIT