Come collegare BoldSign a Microsoft Copilot 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 + Microsoft Copilot

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

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.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di BoldSign.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

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

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse