Come collegare DocuSeal a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → DocuSeal, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

DocuSeal + Gemini

DocuSeal, la piattaforma open source di firma elettronica, in cloud (US o EU) o self-hosted: trova modelli, invii e firmatari, controlla chi ha firmato, recupera i PDF firmati e gli eventi di completamento, invia modelli o PDF singoli alla firma, modifica i firmatari e crea modelli da PDF, DOCX o HTML.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

DOCUSEAL_API_URL, DOCUSEAL_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account su DocuSeal Cloud o l'accesso a un DocuSeal self-hosted.

1. Copia la tua chiave API: su DocuSeal Cloud in https://console.docuseal.com/api (account EU: https://console.docuseal.eu/api), su un DocuSeal self-hosted in Settings > API (https://<your host>/settings/api).
2. Incollala in DOCUSEAL_API_KEY. Viene inviata nell'header X-Auth-Token e agisce come l'utente a cui appartiene.
3. Imposta DOCUSEAL_API_URL: https://api.docuseal.com per il cloud US, https://api.docuseal.eu per il cloud EU oppure https://<your host>/api per un'istanza propria (l'indirizzo da cui apri DocuSeal, più /api). Senza barra finale.
4. Installa il connettore ed esegui docuseal_list_templates per verificare la chiave.

Modalità test: DocuSeal Cloud ha una modalità test con una chiave API propria, che attivi dalla console. Gli invii di test sono gratuiti e non hanno valore legale: usa la chiave di test mentre provi il connettore.

Cosa legge:

• Modelli con ruoli, campi (nome, tipo, ruolo, obbligatorio) e documenti, ricercabili per nome (q), cartella o id esterno. I nomi dei campi sono le chiavi per i valori precompilati.
• Invii (richieste di firma) con stato, modello, email, ruolo e stato di ogni firmatario, cronologia degli eventi, documento combinato e link all'audit log. Filtri per modello, stato, cartella o firmatario.
• Firmatari di tutti gli invii con orari di invio, apertura, completamento o rifiuto, motivo del rifiuto, valori inseriti e link personale di firma embed_src.
• Link di download dei documenti di un invio: i PDF firmati a completamento, prima quelli compilati in parte, oppure un unico PDF unito con merge.
• Eventi di completamento: uno per ogni firmatario che ha finito (form.completed) e uno per ogni invio firmato da tutti (submission.completed), con gli stessi dati di un webhook, per recuperare tutto ciò che è stato firmato da un certo momento.

Cosa scrive:

• Invio alla firma: docuseal_create_submission invia un modello con un firmatario per ruolo; role deve corrispondere ai nomi dei ruoli del modello, ad esempio "First Party", e values precompila i campi per nome. docuseal_create_submissions_from_emails è la via rapida per i modelli con un solo firmatario: un invio per indirizzo email, inviti spediti subito. docuseal_create_submission_from_pdf invia un PDF singolo senza salvare prima un modello.
• Solleciti e correzioni: docuseal_update_submitter corregge nome, email o telefono, precompila valori, rimanda l'invito con send_email o firma a nome del firmatario con completed. docuseal_update_submission rinomina un invio, cambia la scadenza o lo archivia e lo ripristina; docuseal_archive_submission lo archivia e i suoi link di firma smettono di funzionare.
• Modelli: docuseal_create_template_from_pdf, docuseal_create_template_from_docx, docuseal_create_template_from_html, docuseal_clone_template, docuseal_update_template (rinominare, spostare in una cartella, rinominare i ruoli, archiviare o ripristinare) e docuseal_archive_template.

Tutti gli strumenti sono attivi all'installazione, anche quelli che inviano, e l'invio è reale: un nuovo invio manda un'email ai firmatari a meno che send_email sia false, completed: true firma per qualcuno e l'archiviazione disattiva i link di firma. L'AI ti mostra il modello o il documento, i firmatari con i loro ruoli e il messaggio, e invia solo dopo un sì chiaro.

File e campi: documents[].file accetta un URL pubblico, che DocuSeal scarica, oppure contenuto Base64. I campi arrivano dai tag di testo nel documento, come {{Full Name;role=Signer;type=text}}, {{Sign here;role=Signer;type=signature}} o {{Date;role=Signer;type=date}}, oppure da fields con areas esatte (page, x, y, w, h come frazioni della pagina). I tipi includono text, signature, initials, date, number, image, checkbox, select, radio, file, stamp, payment e phone. I modelli HTML usano tag come <signature-field name="Signature" role="Signer"></signature-field>; i modelli DOCX possono usare [[variables]] per documenti dinamici.

Formati dei dati: gli id sono numeri interi. Gli orari sono ISO 8601 con fuso orario. Lo status di un invio è pending, completed, declined o expired; quello di un firmatario è awaiting (non ancora invitato per l'ordine di firma), sent, opened, completed o declined. Gli URL dei documenti sono temporanei: scarica i file presto.

Paginazione: gli elenchi restituiscono data e pagination con count, next e prev, dal più recente, 10 elementi per impostazione predefinita e fino a 100 con limit. L'AI passa pagination.next come after per la pagina successiva, più vecchia, e si ferma quando next è null. Gli strumenti degli eventi di completamento paginano allo stesso modo per orario di completamento in secondi Unix.

Errori comuni: 401 "Not authenticated" indica una chiave API errata o mancante, oppure una chiave del cloud US usata sull'host EU e viceversa. 403 significa che l'utente della chiave non può vedere l'elemento, 404 un id sconosciuto. 422 arriva con un messaggio error per input non validi: nome di ruolo sconosciuto, email mancante, modello archiviato, modello senza campi o file illeggibile. 429 indica che è stato raggiunto il rate limit. Su un'istanza self-hosted, 404 a ogni chiamata significa che manca /api in DOCUSEAL_API_URL.

Il connettore archivia modelli e invii ma non li elimina mai, e non gestisce utenti DocuSeal, impostazioni dell'account o sottoscrizioni webhook.

Step 2 — Installa l'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

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

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

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di DocuSeal.

Tool disponibili

Esempi di prompt

• "Quali invii del modello NDA sono ancora in attesa, e chi non ha ancora firmato?"
• "Invia il modello "Contratto di lavoro" ad [email protected] come First Party e precompila il suo nome e la data di inizio. Mostrami tutto prima di inviare."
• "Cosa è stato firmato da lunedì? Elenca ogni firmatario con il documento e l'orario di completamento."
• "Recupera i documenti firmati dell'invio 4521 in un unico PDF unito, insieme al link all'audit log."
• "Il firmatario [email protected] non ha aperto l'invito: correggi il suo indirizzo in [email protected] e rimandalo."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot