DocuSign su MCP: Pilota DocuSign da qualsiasi agente AI

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

DocuSign

Fai lavorare la tua AI con DocuSign eSignature: trova le buste e controlla chi ha già firmato, leggi destinatari, documenti, dati dei moduli e audit trail, invia documenti o modelli per la firma, reinvia o annulla le buste e sfoglia i modelli. Demo o produzione, con l'accesso di un utente DocuSign.

Setup

1. Crea un account sviluppatore gratuito (demo) su docusign.com/developers/sandbox, oppure usa il tuo account di produzione. Apri Apps and Keys: admindemo.docusign.com/apps-and-keys per la demo, admin.docusign.com/apps-and-keys per la produzione (oppure Settings → Integrations → Apps and Keys).
2. Clicca su Add App and Integration Key e dai un nome all'app, per esempio "AnythingMCP". In User Application → Authentication method rispondi Yes alla domanda "Is your application able to securely store a client secret?" (Authorization Code Grant).
3. Clicca su Add Secret Key e copiala subito: viene mostrata una sola volta. Inseriscila in DOCUSIGN_CLIENT_SECRET, e l'Integration Key (un GUID) in DOCUSIGN_CLIENT_ID.
4. In Redirect URIs aggiungi https://cloud.anythingmcp.com/api/mcp-oauth/callback. Se ospiti AnythingMCP in proprio, inserisci invece https://tuo-host-anythingmcp/api/mcp-oauth/callback. L'URI deve corrispondere esattamente. Salva; le modifiche possono richiedere fino a 5 minuti.
5. Nella stessa pagina, in My Account Information, copia l'API Account ID (un GUID, non il numero di account breve) in DOCUSIGN_ACCOUNT_ID e l'Account's Base URI (per esempio https://demo.docusign.net o https://eu.docusign.net, senza /restapi e senza barra finale) in DOCUSIGN_BASE_URI.
6. Imposta DOCUSIGN_AUTH_URL su https://account-d.docusign.com per un account demo oppure su https://account.docusign.com per la produzione.
7. Installa il connettore, clicca su Authorize with Provider nella pagina del connettore e accedi a DocuSign.
8. Comincia con docusign_get_user_info: elenca tutti gli account a cui questo utente può accedere, ciascuno con account_id e base_uri. Se non corrispondono a DOCUSIGN_ACCOUNT_ID o DOCUSIGN_BASE_URI, correggi le variabili. Il base URI appartiene all'account e può cambiare quando DocuSign sposta un account.

Passaggio in produzione: una nuova integration key funziona solo in demo. Per la produzione scegli Actions → Start Go-Live Review nella pagina Apps and Keys della demo. Poi, nel tuo account di produzione, aggiungi di nuovo una secret key (per DOCUSIGN_CLIENT_SECRET) e il redirect URI, perché non vengono copiati, e porta DOCUSIGN_AUTH_URL, DOCUSIGN_BASE_URI e DOCUSIGN_ACCOUNT_ID ai valori di produzione.

Restare connessi: il connettore richiede gli scope signature ed extended. Gli access token durano 8 ore e vengono rinnovati automaticamente; ogni rinnovo emette un nuovo refresh token valido 30 giorni, quindi il connettore resta connesso finché lo usi almeno una volta al mese. Dopo una pausa più lunga, o se l'accesso è stato revocato, clicca di nuovo su Authorize with Provider.

Permessi e solo lettura: il connettore lavora come l'utente DocuSign che ha effettuato l'accesso, nei limiti dei suoi permessi. Per un setup in sola lettura, disattiva docusign_create_envelope_from_template, docusign_create_envelope_with_document, docusign_send_draft_envelope, docusign_resend_envelope e docusign_void_envelope.

Disattivati all'installazione: docusign_move_envelope_to_trash, che sposta le buste nella cartella Deleted. Una bozza viene scartata, ma una busta già inviata viene annullata (voided). Resta recuperabile per 24 ore. Attivalo solo se l'AI deve fare pulizia tra le buste.

L'invio è reale: una busta inviata manda a ogni destinatario una richiesta di firma via email a nome della tua azienda. docusign_create_envelope_from_template e docusign_create_envelope_with_document creano una bozza, a meno che non si chieda di inviare; docusign_send_draft_envelope, docusign_resend_envelope e docusign_void_envelope agiscono invece su destinatari reali. L'AI ti dice prima chi riceverà cosa e aspetta il tuo sì. Si possono annullare solo le buste in attesa di firma, e l'annullamento non si può revocare.

Documenti e modelli: i documenti passano per la conversazione, quindi tienili leggeri (una richiesta intera è limitata a circa 35 MB). docusign_download_document restituisce un singolo documento, tutti i documenti in un unico PDF oppure il certificato di completamento; i file oltre circa 1,5 MB arrivano troncati, e DocuSign consente solo pochi download dello stesso documento all'ora. docusign_get_form_data richiede l'impostazione dell'account che permette ai mittenti di scaricare i dati dei moduli. Per inviare da un modello, ogni ruolo del modello deve avere un nome e un indirizzo email.

Limiti: 3.000 chiamate API all'ora per account, condivise da tutte le integrazioni, e picchi fino a 500 chiamate in 30 secondi (200 in demo). DocuSign chiede di non controllare la stessa busta più di una volta ogni 15 minuti.

Errori comuni: 401 AUTHORIZATION_INVALID_TOKEN o USER_AUTHENTICATION_FAILED significa che l'accesso è scaduto o è stato revocato, oppure che DOCUSIGN_AUTH_URL non corrisponde all'ambiente (account-d per la demo, account per la produzione): controllalo, poi clicca di nuovo su Authorize with Provider. 400 USER_LACKS_MEMBERSHIP o 404 significa che DOCUSIGN_ACCOUNT_ID o DOCUSIGN_BASE_URI non appartiene all'utente connesso: confrontali con docusign_get_user_info. 400 TEMPLATE_ROLE_NAME_MISMATCH indica un nome di ruolo che non esiste nel modello, INVALID_EMAIL_ADDRESS_FOR_RECIPIENT un indirizzo email del destinatario non valido e ENVELOPE_CANNOT_VOID_INVALID_STATE una busta che non è in attesa di firma. 429 o HOURLY_APIINVOCATION_LIMIT_EXCEEDED significa che è stato raggiunto il limite orario: attendi l'ora successiva.

Il connettore non gestisce la firma o l'invio incorporati (embedded views), i PowerForms, l'invio massivo (bulk send) e i webhook Connect, e non modifica modelli, utenti o impostazioni dell'account.

Prerequisiti: DOCUSIGN_CLIENT_ID, DOCUSIGN_CLIENT_SECRET, DOCUSIGN_AUTH_URL, DOCUSIGN_BASE_URI, DOCUSIGN_ACCOUNT_ID

Installazione locale del connettore

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

Apri http://localhost:3000/connectors/store, scegli DocuSign e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Quali buste inviate negli ultimi 30 giorni sono ancora in attesa di firma, e chi non ha ancora firmato?"
• "Mostrami l'audit trail del contratto di servizio con Acme Srl: quando è stato aperto e quando è stato firmato?"
• "Cosa ha inserito il firmatario nei campi del modulo di onboarding fornitori di Northwind?"
• "Prepara una bozza dal nostro modello "Mutual NDA" per Giulia Bianchi ([email protected]) e mostrami chi riceve cosa prima di inviare qualsiasi cosa."

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT