Come collegare BoldSign a Cursor via MCP

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

BoldSign + Cursor

Firme elettroniche BoldSign nella regione USA, UE, Canada o Australia: trova i documenti e vedi chi ha firmato, scarica PDF firmati e audit trail, invia file o modelli da firmare, manda promemoria, proroga la scadenza, cambia firmatari e precompila i campi, e consulta modelli, identità mittente, contatti, team, utenti, brand e crediti API.

Prerequisiti

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

BOLDSIGN_API_URL, BOLDSIGN_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un piano BoldSign che includa l'API, oppure un account Sandbox gratuito.

1. Accedi a BoldSign (https://app.boldsign.com, account UE https://app-eu.boldsign.com) e apri API nel menu a sinistra, poi API Key.
2. Clicca Generate API Key, scegli Sandbox (gratuito, documenti con filigrana, 50 richieste all'ora) o Live, imposta se vuoi una data di validità e copia la chiave in BOLDSIGN_API_KEY. Viene inviata nell'header X-API-KEY e ha tutti i permessi.
3. Imposta BOLDSIGN_API_URL sull'indirizzo API della regione del tuo account, senza barra finale: https://api.boldsign.com (USA), https://api-eu.boldsign.com (UE), https://api-ca.boldsign.com (Canada) o https://api-au.boldsign.com (Australia). L'indirizzo nel browser dopo l'accesso ti dice la regione: app-eu è UE, app-ca Canada, app-au Australia, app semplice USA.
4. Installa il connettore ed esegui boldsign_list_documents per verificare chiave e regione.

Trovare i documenti e vedere chi ha firmato:

• boldsign_list_documents elenca i documenti che hai inviato o ricevuto, dal più recente, con stato, mittente, stato di ogni firmatario, cc, etichette e date. Puoi filtrare per testo, status (WaitingForMe, WaitingForOthers, NeedAttention, Completed, Declined, Revoked, Expired, Draft, Scheduled), transmit_type (Sent, Received, Both), un intervallo sulla data di invio o di scadenza, etichette, brand, email del mittente o del firmatario.
• boldsign_list_team_documents mostra i documenti del tuo team (gli amministratori di team: dei team che gestiscono), filtrabili per team e utente. boldsign_list_behalf_documents mostra i documenti inviati per conto di altri tramite un'identità mittente, o inviati da altri per conto tuo.
• boldsign_get_document legge un documento per intero: file, ogni firmatario con ordine, stato, visualizzazione, autenticazione e valori dei campi, cc, la cronologia degli eventi, scadenza, impostazioni dei promemoria ed eventuale motivo di revoca o rifiuto.

File firmati: boldsign_download_document restituisce il PDF firmato quando il documento è completato, altrimenti lo stato attuale; più file arrivano in un unico PDF combinato o, con il formato Individually, in uno ZIP. boldsign_download_audit_log restituisce il PDF dell'audit trail con ogni evento (inviato, visualizzato, firmato, rifiutato), ora, email e indirizzo IP. Per i documenti inviati per conto di qualcuno, indica l'email dell'identità mittente in on_behalf_of.

Inviare da firmare:

• Da un modello: boldsign_list_templates, poi boldsign_get_template per gli indici dei ruoli e gli id dei campi, poi boldsign_send_from_template con una voce in roles per ogni ruolo (roleIndex, signerName, signerEmail, facoltativo existingFormFields per precompilare). I ruoli omessi mantengono il firmatario predefinito del modello; role_removal_indices toglie ruoli da questo documento.
• Un file: boldsign_send_document accetta file PDF, Word o immagini come URL pubblici in file_urls (BoldSign li scarica) o come data URI Base64 in files, mai entrambi. Ogni firmatario ha name, emailAddress, facoltativi signerOrder, signerType (Signer, Reviewer o InPersonSigner) e formFields (Signature, Initial, CheckBox, TextBox, DateSigned, RadioButton, Dropdown, Name, Email, ciascuno con pagina e bounds). Invece di posizionare i campi puoi usare tag di testo scritti nel documento (use_text_tags) o lasciare che BoldSign trasformi in campi i campi modulo e le righe vuote presenti (auto_detect_fields).
• Entrambi accettano titolo e messaggio, cc, ordine di firma, scadenza (Days di default, 60 giorni; Hours o SpecificDateTime), promemoria automatici, un brand, etichette e on_behalf_of per un'identità mittente in stato Verified. disable_emails non invia email; boldsign_get_embedded_sign_link fornisce allora un link di firma diretto per ogni firmatario, con durata limitata e indirizzo di reindirizzamento se vuoi. boldsign_send_draft invia un documento salvato come bozza.
• L'invio è asincrono: la risposta contiene subito il documentId, e poco dopo boldsign_get_document mostra se è partito (un invio fallito compare nella cronologia).

L'invio è reale: inviare, mandare promemoria, cambiare un firmatario e creare un'identità mittente manda email a persone vere, un documento Live ha valore legale e può consumare crediti API. L'AI ti mostra file o modello, firmatari e messaggio e invia solo dopo il tuo sì esplicito.

Seguito: boldsign_remind_document manda un promemoria a tutti i firmatari in attesa o solo alle email indicate. boldsign_extend_expiry sposta la scadenza di un documento in corso: una data yyyy-MM-dd per scadenze in giorni, un numero di ore per scadenze in ore, una data-ora ISO 8601 per una scadenza precisa. boldsign_change_recipient sostituisce un firmatario che non ha ancora firmato, con un motivo registrato nell'audit trail. boldsign_prefill_fields imposta i valori dei campi prima che i firmatari li compilino (id dei campi da boldsign_get_document).

Account: identità mittente con boldsign_list_sender_identities, boldsign_get_sender_identity e boldsign_create_sender_identity (BoldSign manda alla persona una richiesta di approvazione via email; l'identità è utilizzabile quando il suo stato è Verified, gli stati sono Pending, Verified e Denied). Contatti con boldsign_list_contacts, boldsign_get_contact, boldsign_create_contacts e boldsign_update_contact. Team, utenti (ruolo Admin, TeamAdmin o Member, stato Active o Invited) e brand sono in sola lettura. boldsign_get_api_credits mostra il saldo dei crediti e quanti ne sono stati usati.

Disattivati all'installazione: boldsign_revoke_document (interrompe la firma e comunica il motivo ai firmatari; il documento non può riprendere) e boldsign_delete_document (lo sposta nel cestino o lo cancella definitivamente con delete_permanently). Nessuno dei due si può annullare, quindi un amministratore del workspace li attiva quando servono al team.

Formati dei dati: gli id sono stringhe GUID (documentId, templateId). Date come createdDate, activityDate ed expiryDate sono timestamp Unix in secondi; i filtri accettano ISO 8601 (2026-10-01T00:00:00Z). Lo stato del documento è InProgress, Completed, Declined, Expired, Revoked, Draft o Scheduled; quello del firmatario NotCompleted, Completed, Declined, Revoked o Expired. I ruoli dei modelli sono numerati da 1. I bounds dei campi (x, y, width, height) si misurano dall'angolo in alto a sinistra della pagina, e gli id dei campi usano solo lettere, cifre e trattini bassi.

Paginazione: gli strumenti di elenco accettano page (da 1) e page_size (da 1 a 100, predefinito 10) e restituiscono pageDetails con totalRecordsCount e totalPages, più le voci in result (results per i team). Oltre 10.000 documenti l'AI passa il cursor dell'ultimo documento come next_cursor.

Limiti: 2.000 richieste all'ora per account su Live e 50 su Sandbox, contando insieme chiave API e OAuth. I documenti Sandbox hanno una filigrana. Nei piani a crediti ogni documento inviato tramite API consuma crediti.

Errori comuni: 401 indica una chiave errata o scaduta, oppure una chiave usata sull'indirizzo di un'altra regione. 403 indica che il piano non include l'API o che l'utente non può vedere l'elemento. 400 arriva con un messaggio per input non validi, ad esempio un indice di ruolo sconosciuto, un'email del firmatario mancante o un file che BoldSign non riesce a leggere. 429 indica che il limite orario è raggiunto; aspetta fino a X-RateLimit-Reset.

Il connettore non crea né modifica modelli, non gestisce webhook, non crea team, utenti o brand e non elimina contatti.

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 BoldSign.

Tool disponibili

Esempi di prompt

• "Quali documenti aspettano ancora la firma di altri, e chi esattamente non ha ancora firmato?"
• "[email protected] ha firmato l'NDA che abbiamo mandato lunedì? Mostrami la cronologia degli eventi."
• "Scarica il PDF firmato e l'audit trail del contratto di servizio con Acme."
• "Invia il nostro modello di contratto freelance a [email protected] come collaboratore. Mostrami ruoli e messaggio prima di inviare."
• "Manda un promemoria ai firmatari in attesa del contratto di locazione e proroga la scadenza al 30 novembre."

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