Come collegare Adobe Acrobat Sign a Cursor via MCP

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

Adobe Acrobat Sign + Cursor

Adobe Acrobat Sign REST API v6, con accesso come utente Acrobat Sign: trova gli accordi e verifica chi ha firmato, leggi partecipanti, eventi, dati dei moduli, link di firma, il PDF firmato e il registro di controllo, invia documenti o modelli della libreria per la firma, invia promemoria e consulta modelli, moduli web, utenti, gruppi, workflow e webhook. L'annullamento degli accordi è disattivato all'installazione.

Prerequisiti

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

ADOBE_SIGN_SHARD, ADOBE_SIGN_CLIENT_ID, ADOBE_SIGN_CLIENT_SECRET

Step 1 — Ottieni le credenziali

La configurazione richiede circa 15 minuti. Ti servono un account Acrobat Sign (Business, Enterprise o un account sviluppatore gratuito per i test) e un amministratore dell'account che crei l'applicazione API.

1. Accedi ad Acrobat Sign come amministratore dell'account e annota il tuo shard dall'indirizzo del browser: https://secure.na1.adobesign.com/... significa na1; gli altri sono na2, na3, na4, eu1, eu2, jp1, au1, in1 e sg1. Inserisci solo il codice dello shard in ADOBE_SIGN_SHARD.
2. Apri Account, Acrobat Sign API, API Applications, clicca +, inserisci un nome e un nome visualizzato e scegli il dominio CUSTOMER.
3. Seleziona la nuova applicazione e clicca Configure OAuth for Application. Imposta il Redirect URI su https://cloud.anythingmcp.com/api/mcp-oauth/callback su AnythingMCP Cloud, oppure su <your AnythingMCP URL>/api/mcp-oauth/callback se ospiti AnythingMCP in proprio. Deve essere https e coincidere esattamente.
4. Nella stessa pagina attiva gli scope user_read, agreement_read, agreement_write, agreement_send, library_read, widget_read, workflow_read e webhook_read. Scegli il modificatore self per un connettore personale; gli amministratori dell'account possono scegliere account per raggiungere gli accordi di tutti gli utenti (vedi Scope più sotto). Salva.
5. Clicca View/Edit sull'applicazione e copia l'Application ID in ADOBE_SIGN_CLIENT_ID e il Client Secret in ADOBE_SIGN_CLIENT_SECRET. Installa il connettore.
6. Nella pagina del connettore clicca Authorize with Provider e accedi ad Acrobat Sign. Poi esegui adobe_acrobat_sign_get_base_uris: apiAccessPoint deve contenere il tuo shard. Se ne mostra un altro, correggi ADOBE_SIGN_SHARD e autorizza di nuovo.

Scope: il connettore chiede user_read agreement_read agreement_write agreement_send library_read widget_read workflow_read webhook_read, cioè il modificatore :self: gli accordi, i modelli e i moduli web dell'utente collegato. Un amministratore dell'account che vuole far vedere all'AI tutto l'account li cambia nelle impostazioni OAuth del connettore in agreement_read:account, user_read:account e così via (gli stessi modificatori devono essere attivi nell'applicazione) e autorizza di nuovo. adobe_acrobat_sign_list_users richiede user_read:account.

Token: gli access token durano un'ora e si rinnovano da soli tramite /oauth/v2/refresh sul tuo shard. Un refresh token non usato per 60 giorni scade; a quel punto clicca di nuovo Authorize with Provider.

Cosa legge: gli accordi, elencati dal più recente o cercati per testo (nomi, e-mail e nomi dei partecipanti, messaggi, ID esterni, contenuto dei campi) con filtri per stato, ruolo, tipo, data di creazione o modifica ed e-mail del partecipante; un accordo con mittente, gruppi di partecipanti, elenco cc, messaggio, date e documenti di origine; i membri di un accordo e il passo a cui si trova ciascuno; gli eventi di controllo (creato, inviato, visualizzato, firmato, delegato, promemoria inviato, completato); i valori inseriti nei campi del modulo; i link di firma dei partecipanti che devono agire ora; i documenti di un accordo; l'accordo come unico PDF, come link temporaneo o come file, e il report del registro di controllo come file PDF; i promemoria; i documenti della libreria (modelli riutilizzabili) con i loro campi; i moduli web con URL pubblico, impostazioni, dati inseriti e gli accordi che hanno generato; utenti, gruppi e membri dei gruppi; i workflow di invio personalizzati; i webhook.

Cosa scrive: adobe_acrobat_sign_upload_transient_document scarica un file (PDF, Word, Excel, immagine) da un URL e lo carica, fino a 10 MB; i documenti temporanei scadono dopo 7 giorni. adobe_acrobat_sign_create_agreement crea un accordo da un documento temporaneo, da un modello della libreria o da un URL pubblico di un file: con state IN_PROCESS viene inviato subito, DRAFT lo lascia non inviato e AUTHORING permette al mittente di posizionare prima i campi in Acrobat Sign. adobe_acrobat_sign_send_agreement invia un accordo in DRAFT o AUTHORING, e adobe_acrobat_sign_create_reminder ricorda ai partecipanti che non hanno ancora agito, una volta o con una pianificazione. Questi tool sono attivi all'installazione, e invii e promemoria mandano e-mail a persone reali, quindi l'AI ti mostra i documenti, i destinatari nel loro ordine e il messaggio, e invia solo dopo un sì chiaro.

Creare un accordo: file_infos accetta una voce per documento, un transientDocumentId, un libraryDocumentId o un urlFileInfo con url, name e mimeType che Adobe scarica da sé. participant_sets elenca i destinatari con order (1, 2, ...) e role (SIGNER, APPROVER, ACCEPTOR, FORM_FILLER, CERTIFIED_RECIPIENT). Se il documento non ha campi firma (text tag o campi del modello), Acrobat Sign aggiunge un blocco firma alla fine. merge_field_info precompila i campi del modello per nome; adobe_acrobat_sign_list_library_document_form_fields mostra i nomi.

Disattivato all'installazione: adobe_acrobat_sign_cancel_agreement, perché un accordo annullato non si può più firmare e l'annullamento non si può revocare. Un admin lo attiva quando il team ne ha bisogno.

Formati dei dati: lo status di un accordo è OUT_FOR_SIGNATURE, OUT_FOR_APPROVAL, SIGNED, APPROVED, ACCEPTED, FORM_FILLED, DELIVERED, CANCELLED, EXPIRED, DRAFT, AUTHORING e pochi altri. Lo status di un membro, come WAITING_FOR_MY_SIGNATURE, NOT_YET_VISIBLE o COMPLETED, mostra il passo di ogni partecipante. Le date sono ISO 8601 in UTC. I dati dei moduli arrivano come testo CSV; solo il mittente può leggerli, di default solo per accordi completati. I PDF di adobe_acrobat_sign_download_combined_document e adobe_acrobat_sign_download_audit_trail vengono consegnati come allegati, fino a 10 MB. I link di firma sono disponibili qualche secondo dopo l'invio.

Paginazione: i tool di elenco restituiscono page.nextCursor, che l'AI passa come cursor finché manca. adobe_acrobat_sign_search_agreements si sfoglia con start_index (da searchPageInfo.nextIndex), fino a 100 risultati per pagina e 10.000 in totale.

Limiti: Acrobat Sign limita le chiamate API per utente e per account in base al piano; una risposta 429 contiene Retry-After in secondi.

Errori comuni: 401 INVALID_ACCESS_TOKEN indica che l'autorizzazione è scaduta o revocata: autorizza di nuovo. Un 401 subito dopo l'autorizzazione indica di solito un ADOBE_SIGN_SHARD errato. 403 PERMISSION_DENIED o INVALID_API_ACCESS_POINT indica che manca uno scope o il suo modificatore (per esempio user_read:account per gli utenti), che l'utente non può vedere quell'accordo o che la chiamata è andata allo shard sbagliato. 404 INVALID_AGREEMENT_ID o un altro INVALID_..._ID indica un ID errato, o un accordo di un altro utente con scope :self. 400 INVALID_ARGUMENTS, MISSING_REQUIRED_PARAM o INVALID_EMAIL nomina il campo mancante o errato. 404 AGREEMENT_NOT_EXPOSED sui link di firma indica che l'accordo è ancora in preparazione: aspetta qualche secondo e richiedi.

Il connettore non crea né modifica modelli della libreria, moduli web, workflow, webhook, utenti o gruppi, e non cancella nulla.

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 Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Adobe Acrobat Sign.

Tool disponibili

Esempi di prompt

• "Quali accordi sono in attesa di firma da più di una settimana, e chi deve ancora firmare ciascuno?"
• "Scarica il PDF firmato e il registro di controllo dell'NDA con Esempio Srl."
• "Invia il modello della libreria NDA reciproco a [email protected] per la firma, con me come secondo firmatario. Mostrami tutto prima di inviare."
• "Invia un promemoria ai partecipanti che non hanno ancora firmato il contratto fornitori Q4."
• "Mostra in una tabella i dati inseriti nel modulo web Iscrizione evento."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

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