Skip to content

Inizi la prova gratuita

Server MCP

The full contract lifecycle, run from Claude over MCP

Il server MCP di Contracko collega il tuo spazio di lavoro contrattuale all'assistente AI che già usi. Chiedi a Claude, ChatGPT, Gemini o Copilot informazioni sui tuoi contratti e leggeranno i dati reali: parti, date, valori e i documenti stessi. Dai loro accesso in scrittura e potranno importare contratti, impostare promemoria e archiviare nuovi accordi per te.

Mantieni sempre il controllo. Read e Write sono permessi separati, scegli tu quali concedere, e puoi disconnetterti in qualsiasi momento.

Connetti in due passaggi

Aggiungi le skill in modo che l'assistente sappia come aiutarti con i contratti. Le skill sono quattro brevi guide pubblicate su contracko/contracko-skills.
Aggiungi la connessione in modo che possa raggiungere il tuo spazio di lavoro. Incolla questo indirizzo quando richiesto:

https://app.contracko.com/mcp

Si apre una finestra del browser. Accedi a Contracko, oppure avvia una prova gratuita da quella schermata se non hai ancora un account.

Aggiungere le skill non collega automaticamente il tuo spazio di lavoro. Se Contracko compare già nell'elenco dei connettori del tuo assistente, salta il passaggio 2 invece di aggiungerlo due volte. Usi Claude o Claude Code? Segui invece i passaggi per Claude in Connetti il tuo assistente: Contracko è nella directory dei connettori di Claude.

Quando accedi, seleziona Read in modo che l'assistente possa rispondere alle domande. Seleziona Write solo se deve aggiungere o modificare contratti. Lascia Write disattivato a meno che tu non lo voglia.

Scegli l'accesso in lettura o scrittura

Permesso	Cosa consente	Quando concederlo
Read	Trovare contratti, leggere date, valori e parti estratti, cercare all'interno dei documenti, vedere analisi AI e commenti	Sempre. È sufficiente per fare domande sul tuo spazio di lavoro.
Write	Importare contratti, aggiornare campi, aggiungere documenti e commenti, creare tipi di contratto e controparti, creare, rinominare e spostare cartelle, archiviare contratti nelle cartelle che puoi vedere, impostare e modificare promemoria	Solo quando vuoi che l'assistente apporti modifiche. Inizia senza.

Con Read l'assistente può anche mostrarti chi può accedere a un contratto o a una cartella. Puoi anche limitare le ricerche di contratti a una cartella che puoi vedere. La modifica degli accessi e l'eliminazione delle cartelle si fanno solo nell'app Contracko. Chiedi all'assistente di confermare le modifiche proposte prima di apportarle. Agisce come te e può quindi raggiungere solo contratti e cartelle a cui hai accesso nel rispetto dei permessi del tuo spazio di lavoro. Consulta i permessi sui contratti per capire come viene deciso l'accesso.

Questo è diverso da Clara AI, che lavora all'interno di Contracko. Usa Clara nell'app e connettiti via MCP quando vuoi lavorare da Claude, ChatGPT o un altro assistente che hai già aperto.

Trova i contratti che ti servono

Chiedi un fornitore, un tipo di contratto, uno stato, un intervallo per le date di fine o per le date di preavviso. Il tuo assistente può restringere l'elenco dei contratti prima di leggere i risultati. Per esempio: «Quali contratti Acme terminano o richiedono preavviso il prossimo trimestre?». Se più fornitori hanno lo stesso nome, conferma quello che intendi.

Il tuo assistente deve controllare ogni pagina di contratti corrispondenti prima di dichiarare completo il risultato. Le ricerche per data escludono i contratti senza una data corrispondente, quindi chiedi separatamente le date mancanti. Una data di fine da sola non significa che un contratto si rinnovi automaticamente. Le domande su importi, valute, campi mancanti o clausole possono richiedere ulteriori controlli.

Usa la connessione esistente

OAuth è il metodo predefinito per collegare Contracko al tuo assistente. Non ti servono una nuova connessione, una chiave API sostitutiva o autorizzazioni aggiuntive per usare una ricerca migliore negli strumenti che già possiedi. Se il tuo assistente mostra ancora le vecchie opzioni, aggiorna gli strumenti o ricollega il connettore esistente.

Se OAuth non è disponibile, puoi usare una chiave API MCP dedicata. Inviala con ogni richiesta nell'header Authorization: Bearer <la-tua-chiave-API-MCP>. Conserva la chiave in modo sicuro e non condividerla.

Le azioni disponibili dipendono dalla connessione e dai permessi nel tuo spazio di lavoro. Mantieni Read per le domande. Concedi Write solo se vuoi che l'assistente apporti modifiche. Se manca un'azione, controlla lo spazio di lavoro selezionato e i permessi della connessione oppure contatta il supporto.

Controlla le modifiche incerte prima di riprovare

Se il tuo assistente non può confermare che una modifica è riuscita, controlla il contratto in Contracko prima di riprovare. Un errore non significa sempre che non sia stato modificato nulla.

Agenti e sviluppatori trovano gli argomenti degli strumenti e le indicazioni per gestire le risposte nelle istruzioni per la configurazione degli agenti.

Connetti il tuo assistente

Scegli il prodotto che usi. Ogni percorso finisce allo stesso modo: accedi tramite la finestra del browser che si apre.

Claude

Per Claude sul web, su desktop, su mobile e in Cowork.

Apri Contracko nella directory dei connettori di Claude.
Scegli Connect to Claude.
Accedi a Contracko tramite il browser che si apre.

Funziona con tutti i piani Claude, incluso Free. Su Team ed Enterprise, un Owner deve prima abilitarlo. Un connettore aggiunto sul web o su desktop funziona anche nell'app mobile di Claude.

Da Pro in su puoi anche installare il plugin Contracko (Customize → Plugins) per le quattro skill sui contratti, poi connetterti dalla sua scheda Connectors.

Avevi aggiunto Contracko come connettore personalizzato? Rimuovilo, altrimenti vedrai ogni strumento due volte.

ChatGPT

Vai su Settings → Plugins → Import marketplace e inserisci contracko/contracko-skills.
Attiva Developer mode.
Vai su Settings → Apps → Create e incolla https://app.contracko.com/mcp.
Accedi tramite il browser che si apre.

Grok

Apri grok.com/connectors.
Aggiungi https://app.contracko.com/mcp.
Accedi tramite il browser che si apre.

Claude Code

Hai effettuato l'accesso con il tuo account Claude? Un connettore aggiunto in Claude è già disponibile qui, quindi non c'è nulla da aggiungere.

Per le skill, installa il plugin. Registra anche la connessione:

/plugin marketplace add https://github.com/contracko/contracko-skills.git
/plugin install contracko@contracko

Usa l'indirizzo GitHub completo, non un nome abbreviato owner/repo. Poi digita /mcp nella sessione e accedi.

Usi una chiave API senza il plugin? Esegui questo comando solo se claude mcp list non mostra alcuna voce Contracko:

claude mcp add --transport http contracko https://app.contracko.com/mcp

Poi digita /mcp e accedi.

Codex

npx skills@latest add contracko/contracko-skills
codex mcp add contracko --url https://app.contracko.com/mcp
codex mcp login contracko

Cursor

npx skills@latest add contracko/contracko-skills

Poi aggiungi questo a .cursor/mcp.json nel tuo progetto, creando il file se non esiste:

{ "mcpServers": { "contracko": { "url": "https://app.contracko.com/mcp" } } }

Riavvia Cursor se non rileva subito la connessione.

GitHub Copilot in VS Code

npx skills@latest add contracko/contracko-skills

Poi aggiungi questo a .vscode/mcp.json:

{ "servers": { "contracko": { "type": "http", "url": "https://app.contracko.com/mcp" } } }

Gemini CLI

npx skills@latest add contracko/contracko-skills

Poi aggiungi questo a ~/.gemini/settings.json:

{ "mcpServers": { "contracko": { "httpUrl": "https://app.contracko.com/mcp" } } }

OpenClaw

npx skills@latest add contracko/contracko-skills
openclaw mcp set contracko '{"url":"https://app.contracko.com/mcp","transport":"streamable-http"}'
openclaw mcp configure contracko --auth oauth
openclaw mcp login contracko

Hermes

npx skills@latest add contracko/contracko-skills

Poi aggiungi questo a ~/.hermes/config.yaml:

mcp_servers:
  contracko:
    url: "https://app.contracko.com/mcp"
    auth: oauth

Esegui hermes mcp login contracko e accedi.

Qualsiasi altro assistente

Incolla questo nell'assistente e lascia che segua le istruzioni:

Fetch and execute https://contracko.com/mcp/install/prompt.md

Se preferisci aggiungere tu stesso la connessione, l'indirizzo resta https://app.contracko.com/mcp.

Prova a chiedere

Una volta connesso, parla con l'assistente come faresti con un collega.

Prova a chiedere	Cosa fa
Stiamo facendo l'onboarding di un cliente. Prendi tutti i PDF da questa cartella e caricali in Contracko.	Trova i file, verifica l'elenco con te, li importa e lascia che Contracko estragga date, parti e tipi.
Non voglio rinnovi taciti. Cosa richiede disdetta, scade o si rinnova automaticamente nel prossimo trimestre? Imposta promemoria per tutto.	Elenca le date che contano, poi crea i promemoria in modo che tu venga avvisato in tempo.
Confronta l'MSA di Acme con quello di Beta. Chi ha il tetto di responsabilità, la clausola di recesso e le condizioni sul trattamento dati migliori?	Mette a confronto i due contratti, con le clausole citate.
Controlla i nostri contratti fornitori per responsabilità illimitata, manleve a senso unico e termini di preavviso mancanti.	Scorre il portafoglio e cita la frase dietro ogni criticità trovata.
Il nostro archivio è un disastro. Aiutami a concordare una struttura di cartelle per MSA, NDA, SOW e DPA, poi creala e archivia i nostri contratti al suo interno.	Conferma la struttura con te, poi crea le cartelle e archivia i contratti a cui hai accesso. Organizza anche i tipi, i campi e le controparti che usi.
Cosa dovremmo guardare questo mese? Cos'è urgente e cosa ci sta sfuggendo?	Classifica lo spazio di lavoro per urgenza e lacune.
Guidami nella creazione di un nuovo NDA, invialo per la firma e archivia il PDF firmato quando torna indietro.	Esegue il questionario, poi archivia la copia firmata.

Non serve nominare una skill. Chiedere in linguaggio naturale è sufficiente.

Cosa fanno le skill

Skill	Usala per
`contracko`	Connettersi, poi organizzare tipi di contratto, campi personalizzati, controparti e cartelle
`contracko-import`	Importare PDF e file Word da disco, Drive, SharePoint, Box o da un link
`contracko-review`	Date di disdetta, promemoria, confronti, linguaggio di rischio e cosa guardare dopo
`contracko-create`	Un nuovo accordo, dalle domande fino all'archiviazione del PDF firmato

Connettiti invece con un token

Usa l'accesso dal browser (OAuth) per la maggior parte delle connessioni. Se il tuo client o la tua automazione non possono usarlo, crea una chiave API MCP dedicata in Contracko: Settings → Integrations → API keys. Configura il client per inviarla come header Authorization: Bearer a https://app.contracko.com/mcp. Conserva la chiave nelle impostazioni segrete del client, non nelle chat o nei file condivisi. Entrambi i metodi di connessione rispettano l'accesso che concedi e i permessi del tuo spazio di lavoro.

Gestisci le connessioni in Contracko

Dopo che approvi l'accesso, l'assistente compare in MCP Connections su Settings → Integrations. Puoi vedere chi l'ha collegato, quale accesso ha e quando è stato usato l'ultima volta.

Puoi disconnettere qualsiasi connessione in elenco. Solo chi l'ha collegata può approvare altro accesso OAuth. Solo i proprietari e gli admin possono creare, modificare o revocare le API keys.

Vedere una connessione

Apri Settings, poi Integrations.
Trova l'assistente in MCP Connections.
Apri il menu della riga e scegli Manage connection.

La finestra mostra Connected by, Last used e Current access.

Disconnettere un assistente

Scegli Disconnect dal menu della riga, oppure apri Manage connection e usa il controllo per disconnettere.
Conferma Disconnect.

Quell'assistente perde l'accesso a questo spazio di lavoro. Le altre connessioni restano. Rimuovi il connettore anche nell'assistente, altrimenti ti chiederà di accedere di nuovo.

Cambiare l'accesso o ruotare l'autorizzazione

Non puoi cambiare i permessi OAuth da questa schermata. Per cambiare Read o Write, ricollega dal tuo assistente e approva di nuovo i permessi.

In Contracko, apri Manage connection e scegli Connection setup se ti servono l'indirizzo MCP o i passaggi del client.
Nell'assistente, ricollega Contracko e accedi.
Nella schermata di approvazione, seleziona Read. Seleziona Write solo se l'assistente deve modificare i contratti.
Scegli Disconnect per la connessione non usata in Contracko, così lo stesso assistente non compare due volte.

Ricollegarsi è anche il modo per ruotare l'autorizzazione OAuth. Non c'è un pulsante separato per ruotare il token.

Ruotare o revocare una chiave API

Le connessioni con token si gestiscono in API keys nella stessa pagina, non in MCP Connections.

Crea una nuova chiave MCP server se ti serve ancora un token. Copia il segreto una sola volta.
Inserisci il nuovo segreto nell'header Authorization: Bearer del client.
Apri la chiave precedente e scegli Revoke key.

Manage key può aggiungere accesso senza cambiare il segreto. Le chiavi scadono dopo 12 mesi.

Risolvi i problemi più comuni

"Your Contracko connection needs to be renewed." La connessione è scaduta. Riconnettiti dalle impostazioni dei connettori del tuo assistente e accedi di nuovo.

L'assistente dice di non trovare un tool. Controlla lo spazio di lavoro selezionato e i permessi della connessione, poi aggiorna gli strumenti dell'assistente. Concedi Write solo se vuoi che apporti modifiche. Contatta il supporto se l'azione continua a non essere disponibile.

L'assistente non riesce a vedere un contratto che tu vedi. Verifica di aver effettuato l'accesso allo spazio di lavoro corretto e che il contratto sia condiviso con te in Contracko.

Contracko compare due volte. Hai due connessioni allo stesso server. In Claude, rimuovi il connettore personalizzato aggiunto in precedenza e tieni quello della directory dei connettori. In Claude Code, se hai installato il plugin e hai anche eseguito claude mcp add, esegui claude mcp remove contracko. Negli altri assistenti, rimuovi il connettore duplicato. Aggiungere le skill e aggiungere la connessione sono passaggi separati, e aggiungere la connessione due volte crea due voci.

Prima di condividere contratti reali

Contracko non addestra modelli sui tuoi contratti, e le nostre analisi girano sotto i termini API commerciali con Zero Data Retention dove disponibile.

Connettere un assistente è diverso. Quando Claude, ChatGPT o un altro prodotto chiama Contracko, il testo del tuo contratto viene inviato a quel prodotto, e Contracko non può controllare cosa gli succede lì. Disattiva l'addestramento dei modelli in quel prodotto prima di usarlo con contratti reali. Consulta Sicurezza per capire come gestiamo i tuoi dati dal nostro lato.

Ottieni assistenza

Per domande su Contracko in generale, leggi la documentazione o contattaci.

Per una domanda sulle skill, un suggerimento o un miglioramento, apri una issue sul repository delle skill.

Se vuoi la versione leggibile da macchina di questa documentazione per un agente o un crawler, consulta strumenti per agenti.