PunchLink by IndustriaLink Richiedi una demo
Connettore MCP · incluso in tutte le offerte

Guida utente: connetti la tua IA a PunchLink

Esegui audit dei tuoi progetti, crea accantonamenti, invia situazioni in linguaggio naturale da Claude, Cowork o GitHub Copilot. Nessuna installazione pesante, nessuna duplicazione dei dati.

Il connettore MCP è incluso in tutte le offerte PunchLink. Nessun supplemento, nessuna casella da spuntare, nessun abbonamento separato: è disponibile non appena il vostro account è attivo. Serve solo una chiave API — oppure una connessione OAuth con un clic. Altrove un connettore di questo tipo viene di norma fatturato a parte.

Che cos'è un MCP?

Se non avete mai sentito questa sigla, questa sezione basta.

Una presa standard tra il vostro assistente IA e PunchLink

MCP significa Model Context Protocol. È una presa standard, come una presa di corrente: da un lato il vostro assistente IA (Claude, Cowork, GitHub Copilot), dall'altro PunchLink. Qualsiasi assistente conforme allo standard vi si collega — senza sviluppi specifici, senza gateway su misura, senza esportare i vostri dati altrove.

Senza MCP l'assistente non sa nulla del vostro progetto: dovete copiare e incollare estratti di fogli di calcolo o di PDF. Con l'MCP interroga direttamente PunchLink, con i vostri diritti e nulla di più. Ogni chiamata è tracciata.

Che cosa cambia su una commessa

L'assistente si limita a richiedere strumenti a PunchLink. I vostri dati restano in PunchLink: non servono ad addestrare alcun modello.

Un connettore, tutti gli assistenti IA

Il connettore MCP PunchLink si basa sullo standard MCP (Model Context Protocol), aperto e supportato da tutti i principali assistenti IA professionali.

Audit istantaneo

"Dammi un audit completo del progetto REVAMP" — risposta in 2 secondi con avanzamento, accantonamenti, pagamenti, HSE, DOE (Dossier di Opere Eseguite / dossier di collaudo / as-built). Ogni cifra tracciabile.

Azioni concrete

"Crea un accantonamento bloccante sul lotto tubazioni: saldatura presa P-103 da riprendere" — eseguita direttamente. Non c'è bisogno di aprire PunchLink.

Memo automatici

"Sintesi per il COMEX settimanale" — report markdown strutturato con avanzamento, avvisi critici, importi in sospeso, in 5 secondi.

3 modi per connettere PunchLink

Scegli l'assistente IA che usi già.

Prima di iniziare: un solo passaggio

1

Genera la tua chiave API

Il connettore MCP è già disponibile sul tuo account: non c'è nulla da attivare. In Impostazioni → Connettore MCP, fai clic su + Nuova chiave API. Assegnale un nome (es. «Claude Desktop personale»).

La chiave viene visualizzata nel formato pl_live_XXXXXXXX.... Copiarla immediatamente: non sarà mai più visualizzata.

Con Claude Desktop e Cowork, la connessione OAuth con un clic evita del tutto la chiave.

Connetti Claude Desktop

Metodo consigliato: il connettore nativo (Claude Desktop 1.0+).

1
Apri Claude Desktop.
2
Fai clic sul tuo avatar → Impostazioni → scheda Connettori.
3
Fai clic su Aggiungi connettore personalizzato.
4
Compila:
  • Nome : PunchLink
  • URL : https://www.punchlink.app/mcp
  • Authentication: OAuth — lasciate vuoti i campi Client ID / Secret. Al clic su Connect si apre la pagina di accesso PunchLink: accedete con il vostro account.
5
Fai clic su Connetti. Claude rileva automaticamente i 11 strumenti PunchLink.
6
In una conversazione, chiedi: "Elenca i miei progetti PunchLink".
Verifica: Se Claude ti risponde con l'elenco dei tuoi progetti (codice, nome, settore, budget, contatori), la connessione è OK.

Collegare Cowork

Cowork è la modalità "non sviluppatore" di Claude. Stesso indirizzo ovunque, accesso via OAuth: nessuna chiave da gestire.

1
Aprite Cowork → Personalizza → scheda Connettori.
2
Cliccate su + in alto a destra → Aggiungi connettore MCP personalizzato.
3
Compilate: Nome PunchLink · URL https://www.punchlink.app/mcp — senza chiave, campi avanzati vuoti.
4
Salvate poi cliccate su Connetti: si apre la pagina di accesso PunchLink — accedete con il vostro account PunchLink.
5
Cowork rileva gli 11 strumenti. In una conversazione, scrivete: "Elenca i miei progetti PunchLink".
Sicurezza: nessuna chiave circola. Il vostro assistente riceve un token revocabile, limitato ai vostri progetti — e il server rifiuta qualsiasi chiave inserita in un URL.

Collegare GitHub Copilot (VS Code)

Particolarmente rilevante in azienda: la maggior parte dei CIO autorizza Copilot (Microsoft) per gli usi professionali. Il connettore MCP si collega senza installazione aggiuntiva.

Metodo rapido: tavolozza dei comandi

1
Apri VS Code.
2
Ctrl + Maiusc + P (Windows/Linux) oppure Cmd + Maiusc + P (Mac).
3
Digita MCP: Add Server e seleziona.
4
Scegli il tipo HTTP Server.
5
Compila:
  • Server name: punchlink
  • URL: https://www.punchlink.app/mcp
  • Headers: nome Authorization, valore Bearer TUA_CHIAVE
6
Scegli l'ambito: User (tutti i progetti) oppure Workspace (questa cartella).
7
Apri Copilot Chat → digita @punchlink oppure in modalità Agente: "Audit del progetto REVAMP".

Metodo alternativo: file mcp.json

Se sei a tuo agio, crea .vscode/mcp.json alla radice di un progetto:

{
  "servers": {
    "punchlink": {
      "type": "http",
      "url": "https://www.punchlink.app/mcp",
      "headers": { "Authorization": "Bearer TUA_CHIAVE" }
    }
  }
}
Argomento aziendale: Poiché Copilot è già approvato da la maggior parte dei CIO (politica Microsoft 365), il connettore MCP vi si collega senza validare un nuovo stack IA. I tuoi dati vanno da PunchLink → il tuo VS Code → Copilot. Nessuna superficie di attacco aggiunta.

11 strumenti disponibili

Il connettore MCP PunchLink espone 11 strumenti, classificati in 2 categorie: lettura (senza rischi) e scrittura (con verifiche di autorizzazione).

StrumentoDescrizioneDiritti
list_projectsElenca i tuoi progetti attivi con KPITutti i ruoli
get_project_summaryAudit completo del progetto (KPI, riserve, HSE, pagamenti)Membro progetto
list_reservesElenca riserve filtrate (criticità/stato/lotto)Membro progetto
list_orders_with_paymentsVista finanziaria: pagato / in attesa / convalidatoMembro progetto
search_doeRicerca nei documenti DOEMembro progetto
create_reserveCrea una riserva (minore/maggiore/bloccante)DO/AMO/CDP/Sup./OPC/HSE/Presta
submit_situationInvia una situazione su un ordineFornitore ordine
validate_situationConvalida o rifiuta una situazioneDO/AMO/CDP/Acquisti
create_demo_projectCrea un progetto vuoto per testTutti i ruoli
invite_memberInvita un membro per emailDO/AMO/CDP

Libreria di prompt utili

Audit mattutino

"Dammi un audit completo del progetto [NOME] per la mia riunione delle 9"

Sintesi direzione

"Sintesi di tutti i miei progetti: avanzamento, riserve bloccanti, importi in attesa"

Rischio pagamento

"Nel progetto [NOME], quali ordini hanno pagamenti in attesa da più di 30 giorni?"

Creazione riserva

"Crea una riserva bloccante sul lotto [LOTTO]: [descrizione]"

Convalida situazione

"La situazione 4700030247 è conforme alla percentuale di avanzamento reale?"

Rilevamento blocchi

"Quali riserve bloccanti sono aperte da più di 15 giorni su tutti i miei progetti?"

Sicurezza e best practice

Garanzie tecniche offerte dal connettore MCP.

Autenticazione rigorosa

Ogni chiamata richiede una chiave valida o una sessione OAuth attiva. Chiave assente → rifiuto.

Hashing bcrypt

Le chiavi sono archiviate con hash. Anche L2V non può leggerle in chiaro.

Kill-switch globale

L2V può sospendere istantaneamente tutti gli accessi MCP in caso di incidente.

RLS Postgres

Ogni strumento verifica che tu sia membro del progetto prima di restituire i dati.

Audit trail completo

Ogni chiamata è tracciata: chi, cosa, quando, successo / errore.

Dati mai inviati ai LLM

L'IA richiede solo gli strumenti. I tuoi dati PunchLink rimangono in PunchLink.

Se sospetti una fuga di chiave

  1. Vai a Impostazioni → Connettore MCP
  2. Trova la chiave sospetta nell'elenco
  3. Fai clic su Revoca
  4. Genera una nuova chiave e riconfigura il tuo client IA

Risoluzione rapida dei problemi

ErroreCausaSoluzione
NO_API_KEYChiave non trasmessaVerificate l'header Authorization (Bearer pl_live_...) — o ripetete l'accesso OAuth. Le chiavi nell'URL sono rifiutate.
KEY_INVALIDChiave errata o troncataRigenerare + copiare integralmente
KEY_NOT_FOUND_OR_REVOKEDChiave revocataGenera una nuova chiave
USER_SUBSCRIPTION_INACTIVEAccount PunchLink senza offerta attivaVerificare lo stato dell'account con il proprio amministratore
MCP_DISABLED_GLOBALLYManutenzione L2VRiprova tra 10 minuti, altrimenti contact@punchlink.app
Project not accessibleNon sei membro del progettoRichiedi l'accesso al DO

Pronto a pilotare PunchLink in linguaggio naturale?

Il connettore MCP è incluso nella tua offerta. Genera la tua chiave API e collega il tuo assistente in 3 minuti.

Genera la mia chiave API Scarica la guida PDF

Una domanda? contact@punchlink.app · +33 9 72 10 52 94

Connettore MCP PunchLink: collegamento Claude Desktop, ChatGPT, Cursor, Cline, Continue, Cowork, GitHub Copilot

Connettore MCP PunchLink

Pilota i tuoi progetti in linguaggio naturale da Claude Desktop, ChatGPT, Cursor o Copilot. 11 strumenti BDD esposti in MCP: audit progetto, creazione di riserve, inoltro di situazioni, convalida, ricerca DOE, invito di membri. Incluso in tutte le offerte, disattivabile per progetto per i clienti sensibili.

Deposito singolo IA PunchLink con analisi automatica multi-formato: PDF, DOCX, XLSX, PPTX, DWG, DXF, IFC, immagini, ZIP — anteriorità depositata presso l'INPI

Deposito singolo IA — metodo proprietario

Trascina e rilascia un documento — qualsiasi: PDF, Word, Excel, PowerPoint, piano DWG/DXF, modello BIM IFC, ZIP di cantiere. L'IA analizza, classifica, instrada verso il modulo corretto con un punteggio di confidenza. Metodo proprietario L2V SASU, anteriorità depositata presso l'INPI (busta Soleau).