PunchLink PunchLink
Add-on PunchLink AI · 49 EUR / mese

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.

Un connettore, tutti gli assistenti IA

PunchLink AI 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 AI

Scegli l'assistente IA che usi già.

Prima di iniziare: 2 passaggi obbligatori

1

Attiva il tuo add-on PunchLink AI

In Impostazioni → PunchLink AI, fai clic su Sottoscrivi 49 EUR / mese. Pagamento Stripe sicuro, cancellabile in qualsiasi momento.

2

Genera la tua chiave API

Una volta attivato l'add-on, nella stessa sezione, 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.

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://ztavpcgkjsomfngpuxle.supabase.co/functions/v1/mcp-punchlink
  • Autenticazione : Token Bearer
  • Token : la tua chiave pl_live_...
5
Fai clic su Connetti. Claude rileva automaticamente i 10 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 Desktop. Particolarità: la chiave viene passata direttamente nell'URL.

1
Apri CoworkCustomize → scheda Connettori.
2
Fai clic su + in alto a destra → Aggiungi un connettore MCP personalizzato.
3
Compila:
  • Nome: PunchLink
  • URL (con la tua chiave alla fine):
https://ztavpcgkjsomfngpuxle.supabase.co/functions/v1/mcp-punchlink?key=TUA_CHIAVE
4
Fai clic su Salva. Cowork rileverà i 10 strumenti.
5
In una conversazione, digita: "Elenca i miei progetti PunchLink".
Sicurezza: Poiché la chiave è nell'URL, apparirà nei registri. Questo è accettabile perché la chiave è revocabile in qualsiasi momento, ma non riutilizzarla altrove. Se cambi PC, genera una nuova chiave.

Collegare GitHub Copilot (VS Code)

Particolarmente rilevante in azienda: la maggior parte dei CIO autorizza Copilot (Microsoft) per gli usi professionali. PunchLink AI 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://ztavpcgkjsomfngpuxle.supabase.co/functions/v1/mcp-punchlink
  • 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://ztavpcgkjsomfngpuxle.supabase.co/functions/v1/mcp-punchlink",
      "headers": { "Authorization": "Bearer TUA_CHIAVE" }
    }
  }
}
Argomento aziendale: Poiché Copilot è già approvato da la maggior parte dei CIO (politica Microsoft 365), PunchLink AI 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.

10 strumenti disponibili

PunchLink AI MVP v2 espone 10 strumenti MCP, 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 da PunchLink AI.

Autenticazione rigorosa

Ogni chiamata richiede una chiave valida + componente aggiuntivo attivo. 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 → PunchLink AI
  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 trasmessaVerifica l'intestazione Authorization o ?key= nell'URL
KEY_INVALIDChiave errata o troncataRigenerare + copiare integralmente
KEY_NOT_FOUND_OR_REVOKEDChiave revocataGenera una nuova chiave
USER_SUBSCRIPTION_INACTIVEComponente aggiuntivo annullatoSottoscrivere / riattivare nelle Impostazioni
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?

Attiva PunchLink AI in 30 secondi — rescindibile in qualsiasi momento, senza impegno.

Attiva nel mio account Scarica la guida PDF

Una domanda? contact@punchlink.app

PunchLink AI add-on MCP: collegamento Claude Desktop, ChatGPT, Cursor, Cline, Continue, Cowork, GitHub Copilot — 49 €/mese

PunchLink AI — assistente IA nativo

Pilota i tuoi progetti in linguaggio naturale da Claude Desktop, ChatGPT, Cursor o Copilot. 10 strumenti BDD esposti in MCP: audit progetto, creazione di riserve, inoltro di situazioni, convalida, ricerca DOE, invito di membri. Componente aggiuntivo 49 €/mese, 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 — brevetto in corso

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, brevetto in fase di deposito all'INPI.