@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ía en un solo paso.

• Gestionar sobres: enviar, anular, eliminar y comprobar el estado.

• Descargar documentos: PDFs firmados, certificados de auditoría y archivos ZIP.

• Usar plantillas: crea sobres a partir de plantillas reutilizables con campos prellenados.

• Gestionar webhooks: suscríbete a eventos de sobres en tiempo real.

• Generar URLs de incrustación: crea experiencias de firma incrustables.

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 terminal:

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 cargar el nuevo servidor MCP.

Herramientas

Gestión de sobres

Descargas de documentos

Firma incrustada

Plantillas

Webhooks

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.

Comprobar 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 del 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

Modo Sandbox

Las claves de API creadas en modo sandbox crearán sobres de prueba que no envían correos electrónicos reales. Usa el modo sandbox durante el desarrollo y las pruebas.

Solución de problemas

"SIGNFORGE_API_KEY environment variable is required" Asegúrate de haber configurado la SIGNFORGE_API_KEY en la configuración de tu cliente MCP. Consulta las instrucciones de configuración anteriores.

"SignForge API error (401)" Tu clave de API no es válida o ha caducado. Genera una nueva en signforge.io/dashboard/developers.

"SignForge API error (403)" Tu clave de API no tiene permiso para esta operación. Comprueba los alcances (scopes) de tu clave.

"SignForge API error (429)" Has alcanzado el límite de velocidad. 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 (cerrar + volver a abrir).

3. Comprueba 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 Protocolo de Contexto de Modelo

Licencia

MIT