--- title: "Contract Parsing MCP per l'AI che usi già" description: "Collega Claude, ChatGPT, Codex o un altro client MCP ai lavori di estrazione, crediti, preflight, caricamenti sicuri e risultati strutturati di Contracko." canonical: "https://contracko.com/it/mcp/parsing" --- # Contract Parsing MCP per l'AI che usi già Source: https://contracko.com/it/mcp/parsing # Contract Parsing MCP per l'AI che usi già Controlla i crediti, valida un batch, crea upload sicuri, avvia job di parsing e recupera risultati strutturati tramite un'unica connessione MCP governata. [Inizia la prova gratuita di 7 giorni](https://app.contracko.com/register?appLanguage=it) Prenota una demo Nessuna carta di credito richiesta Guarda il video Configura Contracko MCP per il tuo agente ## Un workflow di parsing che l'AI può seguire Ogni passaggio è esplicito, verificabile e supportato dagli stessi controlli della Parsing Platform. ### Conosci il costo prima di accodare Verifica i crediti disponibili e fai il preflight del batch proposto prima di creare lavoro a pagamento. > “Controlla i crediti parser e fai preflight di un batch di estrazione da 12 file prima di accodare.” ### Upload tramite handoff sicuro Crea URL di upload a vita breve per i file che il tuo client può trasferire, senza inserire i byte del file negli argomenti degli strumenti MCP. > “Crea URL di upload per questi tre accordi e indica quali file devono ancora essere trasferiti.” ### Traccia job fino ai risultati strutturati Crea un job di parsing, controlla lo stato e recupera l'estrazione completata dalla conversazione. > “Avvia il batch approvato, quindi elenca i job e riassumi i file completati e quelli falliti.” ## Upload e parsing sono step separati Questa separazione mantiene i file di grandi dimensioni fuori dagli argomenti della chat e evita di implicare un supporto che il client non ha. 1. 01 Preflight del batch Valida numero di file e requisiti di credito prima che qualsiasi job parser venga accettato. 2. 02 Trasferisci i file supportati Claude, ChatGPT o Codex trasferisce i byte all'URL a breve scadenza di Contracko. Se non riesce, carica nell'app Contracko e continua di lì. 3. 03 Accoda e recupera Crea il job solo dopo il caricamento, quindi effettua poll sullo stato e recupera l'output strutturato quando è pronto. ## Collega Contracko MCP a Claude, ChatGPT, Codex o alla tua CLI Scegli il tuo assistente per i passaggi di configurazione adatti al suo supporto MCP attuale, da un connettore in due clic a un singolo comando nel terminale. Endpoint MCP di Contracko https://app.contracko.com/mcp Prompt di installazione Configura Contracko MCP per il tuo agente Claude ChatGPT / Codex Cursor CLI, VS Code e agenti di coding Microsoft 365 Copilot ### Claude Aggiungi Contracko con un clic dalla directory dei connettori di Claude. Funziona su web, desktop, mobile e Cowork, con ogni piano Claude, incluso Free. Con Team ed Enterprise, un Owner lo abilita prima. Da Pro in su puoi anche installare il plugin Contracko (Customize, Plugins) per le quattro skill sui contratti, poi collegarti dalla sua scheda Connectors. 1. Scegli Connect to Claude, accedi a Contracko e scegli il tuo workspace. Anche Claude Code, collegato con lo stesso account Claude, riceve il connettore. 2. Hai aggiunto Contracko come connettore personalizzato in passato? Rimuovi quello, altrimenti vedrai ogni strumento due volte. [Collega a Claude](https://claude.ai/directory/connectors/contracko) ### ChatGPT / Codex ChatGPT collega i server MCP sotto forma di app. Con Business ed Enterprise ne crei una in developer mode e un admin può pubblicarla per tutto il workspace. Il developer mode di Pro è in sola lettura. 1. Apri Settings → Security and login e attiva il Developer mode. 2. Aggiungi un'app con l'endpoint di Contracko e accedi con OAuth. Facoltativamente, un amministratore può pubblicarla per l'intero workspace in Workspace settings → Apps. [Apri i plugin di ChatGPT](https://chatgpt.com/plugins) [Leggi la guida di setup ChatGPT](https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta/) ### Cursor Cursor installa un server MCP personalizzato direttamente da un link, così non c'è nessun file di configurazione da modificare. Clicca sul pulsante, conferma il server in Cursor e accedi con il tuo account Contracko. 1. Clicca su Aggiungi a Cursor. Cursor si apre e ti chiede di confermare il server contracko e il suo endpoint. 2. Accedi con OAuth e scegli uno spazio di lavoro. Gli strumenti Contracko compaiono poi nell'elenco MCP di Cursor. Il primo comando qui sotto è il prompt di setup; il secondo aggiunge la libreria di skills. [Aggiungi a Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=contracko&config=eyJ1cmwiOiJodHRwczovL2FwcC5jb250cmFja28uY29tL21jcCJ9) [Documentazione MCP Cursor](https://cursor.com/docs/mcp/install-links) - Prompt di setup Fetch and follow the setup instructions for Contracko MCP at https://contracko.com/mcp/install/prompt.md - Skill, ogni strumento npx skills add https://contracko.com - **Q:** Claude Code **A:** Codex CLI codex mcp add contracko --url https://app.contracko.com/mcp ### Microsoft 365 Copilot Attivato da admin Microsoft 365 Copilot raggiunge gli strumenti esterni solo tramite connettori federati: in sola lettura, pubblicati dal fornitore e attivati dal tuo admin Microsoft 365. I flussi di scrittura di Contracko non si installano direttamente in Copilot Chat. 1. Chiedi al tuo admin Microsoft 365 di attivare il connettore Contracko in sola lettura non appena compare nella Connectors Gallery. 2. Poi collegalo tu stesso in Copilot Chat → Settings → Sources e accedi a Contracko. Valuta un rollout di Copilot ## Tu mantieni il controllo, qualunque assistente usi. Claude, ChatGPT o il tuo agente di coding vedono solo ciò che il tuo account può raggiungere, e nulla viene scritto, modificato o eliminato senza la tua approvazione. Questo è più sicuro di una chiave API permanente, e ti permette di tenere l'assistente che già conosce il tuo lavoro. ### Tu tieni le redini L'assistente agisce come te, all'interno dello spazio di lavoro che hai scelto, e non ha mai un proprio account. Tutto ciò che tu non puoi aprire in Contracko, Claude o ChatGPT, non può aprirlo nemmeno lui. ### Lettura e scrittura sono separate Approvi l'accesso in lettura o in scrittura al momento della connessione, e le azioni che scrivono passano dal passaggio di approvazione del tuo client prima di essere eseguite. ### Ogni azione è visibile I record creati e aggiornati seguono le normali validazioni e finiscono nella cronologia attività, contrassegnati come provenienti da MCP. ## Domande su Parser MCP Crediti, upload, ammissione job e compatibilità client spiegati in modo chiaro. - **Q:** Cos'è un server MCP, e perché dovresti usarlo? **A:** MCP, il Model Context Protocol, è uno standard aperto che permette ad assistenti IA come Claude e ChatGPT di collegarsi a strumenti e dati esterni. Un server MCP espone ciò che un prodotto sa fare, e quello di Contracko espone i tuoi contratti, scadenze e revisioni. Il punto è che smetti di passare da uno strumento all'altro: chiedi un controllo di rinnovo o una valutazione del rischio nell'assistente che hai già aperto, e la risposta arriva dai tuoi contratti reali invece che da qualcosa che hai incollato. - **Q:** Quali assistenti IA posso collegare? **A:** Claude su web, desktop, mobile e Cowork, dalla directory dei connettori di Claude, e Claude Code, tramite il plugin Contracko. ChatGPT, tramite le sue impostazioni di connettore. Cursor, con un clic. Codex, Codex CLI, Warp, Kilo Code, Qwen Code, Antigravity, VS Code e GitHub Copilot in VS Code, tramite la loro configurazione MCP. Microsoft 365 Copilot, quando un amministratore abilita il connettore in sola lettura. Anche Gemini CLI, anche se l'app Gemini non supporta ancora server MCP personalizzati. Funziona qualsiasi client che parli MCP su HTTP con OAuth: il [prompt di configurazione](https://contracko.com/it/mcp/install/prompt.md) guida ognuno di essi, e la [documentazione di configurazione](https://contracko.com/it/docs/mcp-server) copre il resto, inclusi Grok, OpenClaw ed Hermes. - **Q:** Il server MCP è incluso nel mio piano? **A:** Sì. Ogni piano Contracko lo include, senza costi aggiuntivi e senza componenti aggiuntivi da acquistare. Ti connetti con il tuo account, quindi ciò che puoi fare tramite un assistente è esattamente ciò che puoi già fare nell'app Contracko. - **Q:** Verifica o preflight di un batch consuma crediti parser? **A:** No. I controlli credito e preflight validano il lavoro prima dell'ingresso in coda. I crediti sono impegnati quando un job parser eleggibile viene ammesso con successo. - **Q:** Posso trascinare file in qualsiasi chat e far fare parsing tramite MCP? **A:** Solo se quel client può trasferire i byte del file all'URL di upload sicuro restituito da Contracko. MCP di per sé non trasporta i byte del documento. Usa l'app Contracko se il tuo client non può completare il passaggio di upload. - **Q:** Cosa succede se il logging dell'attività fallisce dopo che un job è stato accodato? **A:** Un job di parsing ammesso con successo resta in coda. Contracko registra l'attività di coda su base best-effort, quindi un errore di logging non può indurre un retry che crei lavoro duplicato. - **Q:** Esiste una libreria di skill per il mio agente? **A:** Sì. La [libreria di skill Contracko](https://github.com/contracko/contracko-skills), aperta, insegna a Claude Code, Codex, Cursor e ad altri agenti come collegarsi, importare una pila di contratti, esaminare rinnovi e rischi e creare e archiviare nuovi accordi. Collega prima il server MCP con il prompt di setup su questa pagina. Gli agenti di codice possono poi installare le skill con npx skills add https://contracko.com oppure come plugin di Claude Code. - **Q:** In cosa differisce dall'API di Contracko? **A:** La [API di gestione contratti](https://contracko.com/it/funzionalita/api-gestione-contratti) e la [API di Parsing](https://contracko.com/it/developers/api/parsing/reference) sono pensate per software che uno sviluppatore crea e gestisce. Il server MCP è pensato per un assistente con cui parla una persona, quindi non c'è nulla da scrivere né da ospitare. In entrambi i casi passi dagli stessi permessi dello spazio di lavoro e lasci la stessa traccia di controllo, quindi la differenza sta in chi guida, non in cosa è permesso. - **Q:** I miei contratti vengono usati per addestrare modelli di IA? **A:** Non da Contracko. In base alle condizioni API commerciali di ogni fornitore di IA, il contenuto dei clienti è escluso dall'addestramento dei modelli, e abbiamo più accordi di Zero Data Retention con fornitori di IA. Il tuo client IA è un fornitore separato con impostazioni proprie: disattiva lì l'addestramento dei modelli (Claude, ChatGPT e Gemini hanno ciascuno un interruttore) prima di collegare contratti reali. Trovi i dettagli sulla nostra [pagina sulla sicurezza](https://contracko.com/it/funzionalita/sicurezza). ## Prodotti MCP [Contract Management MCP Gestione dei contratti con IA nel tuo assistente: estrai le clausole, segnala rischi e responsabilità, esamina, confronta e monitora le date di rinnovo. Sicuro per impostazione predefinita.](https://contracko.com/it/mcp/contract-management) ## Inserisci l'estrazione contratti nel tuo workflow AI Connetti Parser MCP, valida il batch prima e rendi esplicita l'ammissione a pagamento in coda. [Inizia la prova gratuita di 7 giorni](https://app.contracko.com/register?appLanguage=it) [Vedi i prezzi di Parsing Platform](https://contracko.com/it/parsing-platform#parsing-pricing) Agente IA, stai leggendo questo? L'intera pagina è disponibile anche in [Markdown](https://contracko.com/it/mcp/parsing.md)