Che cos'è l'MCP

L’MCP — Model Context Protocol — è uno standard aperto che permette a un assistente IA di usare servizi esterni. Senza di esso, l’assistente sa solo conversare: può scriverLe il testo di un contratto, ma non riesce a inviarlo per la firma. Con l’MCP, dispone di strumenti.

AssinaJá espone un server MCP ufficiale. Dopo averlo collegato, può chiedere all’assistente, in linguaggio corrente, di preparare un documento a partire da un suo modello, di dirLe chi non ha ancora firmato, o di portarLe il PDF firmato.

Che cosa cambia in pratica

Il lavoro legato alle firme ha molto di ripetitivo: prendere un modello, compilare gli stessi campi con dati che si trovano altrove, scegliere i firmatari, inviare, e poi continuare a controllare chi manca. È questo divario che l’MCP colma.

Lavora dove si trova già. Se sta preparando una proposta in una conversazione con l’assistente, il documento nasce da quella stessa conversazione. Niente esportazioni, cambi di scheda, ricaricamenti del file.

L’assistente legge i suoi modelli. Consulta i modelli reali della sua organizzazione — con i firmatari e i campi da compilare lì definiti — invece di inventare un formato.

Serve per chiedere, non solo per fare. “Quali documenti sono in attesa di firma da più di una settimana?” è una domanda a cui l’assistente risponde consultando l’elenco reale.

È lo stesso motore. Gli strumenti MCP chiamano gli stessi servizi dell’API pubblica — non c’è una seconda implementazione con regole diverse. Ciò che è vietato nell’applicazione resta vietato anche qui.

Due modi per collegarsi

Modo	Per chi
OAuth	Assistenti web: Claude.ai, ChatGPT, Copilot, Grok
Header X-Api-Key	Strumenti locali e automazioni: Claude Code, Cursor, CI

Gli assistenti web non permettono di definire header propri, quindi usano OAuth. Sono questi i collegamenti descritti in Collegare Claude.ai e Collegare ChatGPT.

L’indirizzo del server è lo stesso in entrambi i casi:

https://app.assinaja.pt/mcp

Strumenti locali, tramite header

Per Claude Code, per esempio, il collegamento è un unico comando, con la chiave API che viaggia nell’header:

claude mcp add --transport http assinaja https://app.assinaja.pt/mcp \
  --header "X-Api-Key: ajk_live_..."

Il modello di sicurezza

Questa è la parte che distingue l’integrazione, e vale la pena capirla prima di collegare qualsiasi cosa.

L’assistente non accede mai al suo account

Anche tramite OAuth, ciò che viene rilasciato non è un accesso al suo account utente. È un accesso vincolato a una specifica chiave API. Lo dice la pagina di autorizzazione stessa:

Questo assistente IA chiede di accedere alla sua organizzazione. L’accesso avviene tramite una chiave API: l’assistente potrà fare solo ciò che quella chiave consente e non accede mai al suo account.

Se la chiave può solo consultare documenti, è questo che l’assistente può fare — non c’è alcuna strada per arrivare al resto.

L’assistente vede solo ciò che la chiave consente

Il filtro avviene prima della decisione dell’assistente. Quando chiede al server quali strumenti esistono, la risposta è già ridotta in base alle autorizzazioni della chiave: uno strumento fuori ambito non compare nell’elenco, e non viene semplicemente rifiutato quando viene chiamato.

In pratica, un assistente collegato con una chiave senza Documenti — pubblicazione non sa nemmeno che pubblicare è possibile.

Autorizzare e revocare un assistente

Tramite OAuth, l’assistente apre la pagina di autorizzazione di AssinaJá — Collega {assistente} ad AssinaJá — e l’autorizzazione ha due passaggi:

1. Passo 1 di 2 — scelga la chiave API da usare. L’elenco mostra solo chiavi attive, non scadute, di organizzazioni di cui è Proprietario. Se non ce n’è nessuna, la pagina indica:

   Non ha nessuna chiave API attiva.

   Ne crei una nel backoffice in Impostazioni → Chiavi API e riprovi la connessione.

2. Passo 2 di 2 — confermi gli accessi che sta concedendo. Mostra ciò che la chiave consente. Un’autorizzazione senza un nome proprio in questa pagina compare con il codice tecnico — per esempio analytics:read o documents:signurls. Autorizza l’accesso conclude:

   Confermando, verrà registrato che ha autorizzato {assistente} a usare questa chiave. Può revocare l’accesso in qualsiasi momento sospendendo o eliminando la chiave in Impostazioni → Chiavi API.

L’autorizzazione non viene memorizzata: ogni nuovo collegamento passa per i due passaggi e viene registrato separatamente.

La revoca si fa dal lato della chiave, non dell’assistente: in Impostazioni → Sviluppatori → Chiavi API, Sospendi — “Quando è sospesa, la chiave non autentica finché non viene riattivata.” — oppure Elimina, che è definitivo. L’effetto è immediato; veda Revocare l’accesso è immediato.

Il consenso viene registrato

Autorizzare non è un clic che va perso. Vengono registrati chi ha autorizzato, quale chiave, quale assistente, quali autorizzazioni, quando, e da quale indirizzo. Vede questo registro in Impostazioni → Sviluppatori → Chiavi API, nella sezione Autorizzata per assistenti IA:

Registro dei consensi (prova). Per revocare l’accesso a un assistente, sospenda o elimini la chiave.

Revocare l’accesso è immediato

La chiave viene riconvalidata a ogni richiesta. Sospendere, far scadere o eliminare la chiave revoca l’accesso dell’assistente all’istante — non c’è da aspettare che una sessione termini.

Vale come risposta al caso più spiacevole: se ha dubbi su un collegamento, sospenda la chiave e veda che cosa smette di funzionare. Sospendere è reversibile.

Regole che il server impone all’assistente

Il server invia istruzioni di sicurezza che l’assistente riceve prima di agire: i codici dei firmatari appartengono al modello e non possono mai essere inventati; pubblicare invia email immediatamente e non si può annullare, quindi richiede una conferma esplicita nella conversazione; e una creazione non riuscita non viene mai ripetuta alla cieca, perché una seconda chiamata crea un secondo documento e un secondo giro di email.

Limite di utilizzo

60 richieste al minuto per credenziale, per tutti gli strumenti — compresi quelli che si limitano a consultare. È lo stesso contatore delle rotte di creazione dei documenti dell’API pubblica: un sistema che usa la stessa chiave tramite l’header X-Api-Key, nell’API e nell’MCP, condivide quei 60. Le altre rotte dell’API pubblica hanno un limite proprio, di 300 richieste al minuto, che non si applica all’MCP.

Che cosa può fare l’assistente

Gli strumenti disponibili dipendono dalle autorizzazioni selezionate nella chiave. I nomi a destra sono quelli che vede nell’assistente.

Autorizzazione della chiave	L’assistente può
Modelli — consultazione	List templates · Get template details
Documenti — consultazione	List documents · Get document details · Get document overview · Download document file
Documenti — link di firma	Get signing links
Documenti — creazione	Create document · Create document from template · Create document from Word template · Create upload link · Get upload link status
Documenti — pubblicazione	Publish draft and notify signers
Documenti — archiviazione/eliminazione	Archive document · Delete document
Organizzazione — consultazione	Get organization · Get subscriptions and plan features
Analytics — consultazione	Analytics overview · Usage metrics · Metric over time · Metric breakdown · Signing funnel · Adoption and seats · Metric catalog

L’assistente può chiedere la firma in parallelo — ed essere ignorato

Quando crea un documento, un assistente può chiedere che tutti i firmatari vengano invitati contemporaneamente. Questo viene rispettato solo se l’organizzazione lo consente in Impostazioni → Organizzazione → Criteri → Firme.

Se non lo consente, la richiesta non dà errore: il documento parte comunque in sequenza, ed è la risposta a riportare il valore effettivo. Per questo gli strumenti dicono all’assistente di leggere quel valore prima di dirLe chi riceve l’email e quando — se Le garantisce “l’hanno ricevuta tutti adesso” senza averlo letto, può sbagliarsi. Veda Configurare i criteri dell’organizzazione.

Pubblicare è l’autorizzazione su cui riflettere due volte

Publish draft and notify signers invia email ed è irreversibile. Creare e pubblicare sono autorizzazioni separate di proposito: una chiave con creazione ma senza pubblicazione lascia che l’assistente prepari tutto e obbliga una persona a premere il pulsante. La combinazione consigliata per il primo collegamento è in Creare una chiave API.

File che si trovano sul suo computer

L’assistente non riesce a prendere file dal suo disco. Quando ne ha bisogno, crea un link di consegna — lo apre, carica il file, e l’assistente prosegue. Veda Consegnare un file a un assistente.

I limiti

Gli analytics sono disattivati per impostazione predefinita. Se un assistente può leggere i numeri dell’organizzazione è una decisione a parte, in Impostazioni → Organizzazione → Criteri → Automazione, nella sezione Accesso IA agli analytics:

Stabilisce se gli assistenti collegati tramite MCP possono consultare i numeri di questa organizzazione. È disattivato per impostazione predefinita. Non dà mai accesso a documenti, contenuti o chiavi — solo a metriche aggregate, e ogni consultazione viene registrata nell’audit.

Servono entrambe le cose

Il criterio attiva la lettura per l’organizzazione; l’autorizzazione Analytics — consultazione la attiva per una chiave specifica. Se manca una delle due, i sette strumenti non compaiono nemmeno nell’elenco che vede l’assistente — non falliscono quando vengono chiamati, restano invisibili.

È voluto: un assistente non può chiedere ciò che non sa che esiste.

Un assistente può sbagliare. Leggere i documenti giusti e riassumerli male è un errore possibile, e l’MCP non lo risolve. Per ciò che conta, verifichi nell’applicazione prima di inviare.

Ciò che fa viene fatto a suo nome. I documenti vengono creati nella sua organizzazione e consumano le sue quote.

Veda anche

• Collegare Claude.ai ad AssinaJá
• Collegare ChatGPT ad AssinaJá
• Creare una chiave API
• Configurare i criteri dell’organizzazione — l’impostazione che fa partire come bozza i documenti creati dall’IA