Cómo conectar DocuSeal a Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de DocuSeal.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

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