Cómo conectar DocuSeal a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → DocuSeal, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

DocuSeal + Cursor

DocuSeal, la plataforma de firma electrónica de código abierto, en la nube (US o EU) o autoalojada: busca plantillas, envíos y firmantes, comprueba quién ha firmado, obtén los PDF firmados y los eventos de finalización, envía plantillas o PDF sueltos a firmar, modifica firmantes y crea plantillas desde PDF, DOCX o HTML.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

DOCUSEAL_API_URL, DOCUSEAL_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta en DocuSeal Cloud o acceso a un DocuSeal autoalojado.

1. Copia tu clave de API: en DocuSeal Cloud en https://console.docuseal.com/api (cuentas EU: https://console.docuseal.eu/api), en un DocuSeal autoalojado en Settings > API (https://<your host>/settings/api).
2. Pégala en DOCUSEAL_API_KEY. Se envía en la cabecera X-Auth-Token y actúa como el usuario al que pertenece.
3. Configura DOCUSEAL_API_URL: https://api.docuseal.com para la nube de EE. UU., https://api.docuseal.eu para la nube de la UE o https://<your host>/api para una instancia propia (la dirección desde la que abres DocuSeal, más /api). Sin barra final.
4. Instala el conector y ejecuta docuseal_list_templates para comprobar la clave.

Modo de prueba: DocuSeal Cloud tiene un modo de prueba con su propia clave de API, que activas en la consola. Los envíos de prueba son gratuitos y no tienen validez legal, así que usa la clave de prueba mientras pruebas el conector.

Qué lee:

• Plantillas con sus roles, campos (nombre, tipo, rol, obligatorio) y documentos, con búsqueda por nombre (q), carpeta o id externo. Los nombres de los campos son las claves de los valores precargados.
• Envíos (solicitudes de firma) con estado, plantilla, email, rol y estado de cada firmante, historial de eventos, documento combinado y enlace al registro de auditoría. Filtros por plantilla, estado, carpeta o firmante.
• Firmantes de todos los envíos con las horas de envío, apertura, finalización o rechazo, el motivo del rechazo, los valores que introdujeron y su enlace personal de firma embed_src.
• Enlaces de descarga de los documentos de un envío: los PDF firmados al terminar, antes los rellenados en parte, o un único PDF combinado con merge.
• Eventos de finalización: uno por cada firmante que terminó (form.completed) y uno por cada envío firmado por todos (submission.completed), con los mismos datos que un webhook, para ponerse al día con todo lo firmado desde un momento dado.

Qué escribe:

• Enviar a firmar: docuseal_create_submission envía una plantilla con un firmante por rol; role debe coincidir con los nombres de rol de la plantilla, por ejemplo "First Party", y values precarga campos por su nombre. docuseal_create_submissions_from_emails es la vía rápida para plantillas de un solo firmante: un envío por dirección de email y las invitaciones salen enseguida. docuseal_create_submission_from_pdf envía un PDF suelto sin guardar antes una plantilla.
• Seguimiento: docuseal_update_submitter corrige nombre, email o teléfono, precarga valores, reenvía la invitación con send_email o firma en nombre del firmante con completed. docuseal_update_submission renombra un envío, cambia su caducidad o lo archiva y restaura; docuseal_archive_submission lo archiva y sus enlaces de firma dejan de funcionar.
• Plantillas: docuseal_create_template_from_pdf, docuseal_create_template_from_docx, docuseal_create_template_from_html, docuseal_clone_template, docuseal_update_template (renombrar, mover a una carpeta, renombrar roles, archivar o desarchivar) y docuseal_archive_template.

Todas las herramientas vienen activadas al instalar, también las que envían, y el envío es real: un envío nuevo manda un email a los firmantes salvo que send_email sea false, completed: true firma por alguien y archivar desactiva los enlaces de firma. La IA te muestra la plantilla o el documento, los firmantes con sus roles y el mensaje, y solo envía tras un sí claro.

Archivos y campos: documents[].file acepta una URL pública, que DocuSeal descarga, o contenido en Base64. Los campos salen de etiquetas de texto en el documento, como {{Full Name;role=Signer;type=text}}, {{Sign here;role=Signer;type=signature}} o {{Date;role=Signer;type=date}}, o de fields con areas exactas (page, x, y, w, h como fracciones de la página). Los tipos incluyen text, signature, initials, date, number, image, checkbox, select, radio, file, stamp, payment y phone. Las plantillas HTML usan etiquetas como <signature-field name="Signature" role="Signer"></signature-field>; las plantillas DOCX pueden usar [[variables]] para documentos dinámicos.

Formatos de datos: los ids son enteros. Las horas son ISO 8601 con zona horaria. El status de un envío es pending, completed, declined o expired; el de un firmante es awaiting (aún no invitado por el orden de firma), sent, opened, completed o declined. Las URL de los documentos son temporales, así que descarga los archivos pronto.

Paginación: las listas devuelven data y pagination con count, next y prev, del más reciente al más antiguo, 10 elementos por defecto y hasta 100 con limit. La IA pasa pagination.next como after para la página siguiente, más antigua, y para cuando next es null. Las herramientas de eventos de finalización paginan igual, por hora de finalización en segundos Unix.

Errores comunes: 401 "Not authenticated" indica una clave de API incorrecta o ausente, o una clave de la nube de EE. UU. usada en el host de la UE y al revés. 403 significa que el usuario de la clave no puede ver el elemento, 404 un id desconocido. 422 llega con un mensaje error ante datos no válidos: nombre de rol desconocido, email ausente, plantilla archivada, plantilla sin campos o archivo ilegible. 429 indica que se alcanzó el límite de peticiones. En una instancia autoalojada, 404 en cada llamada significa que falta /api en DOCUSEAL_API_URL.

El conector archiva plantillas y envíos pero nunca los borra, y no gestiona usuarios de DocuSeal, ajustes de la cuenta ni suscripciones a webhooks.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de DocuSeal.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué envíos de la plantilla NDA siguen pendientes y quién no ha firmado todavía?"
• "Envía la plantilla "Contrato de trabajo" a [email protected] como First Party y precarga su nombre y la fecha de incorporación. Muéstrame todo antes de enviar."
• "¿Qué se ha firmado desde el lunes? Lista cada firmante con el documento y la hora de finalización."
• "Obtén los documentos firmados del envío 4521 en un único PDF combinado, junto con el enlace al registro de auditoría."
• "El firmante [email protected] no ha abierto la invitación: corrige su dirección a [email protected] y reenvíala."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot