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

Mode d emploi : connecter votre IA a PunchLink

Auditez vos projets, creez des reserves, soumettez des situations en langage naturel depuis Claude, Cowork ou GitHub Copilot. Aucune installation lourde, aucune duplication de donnees.

Activer dans mon compte Guide d installation

Un connecteur, tous les assistants IA

PunchLink AI repose sur le standard MCP (Model Context Protocol), ouvert et supporte par tous les assistants IA professionnels majeurs.

Audit instantane

"Donne-moi un audit complet du projet REVAMP" — reponse en 2 secondes avec avancement, reserves, paiements, HSE, DOE. Chaque chiffre tracable.

Actions concretes

"Cree une reserve bloquante sur le lot tuyauterie : soudure piquage P-103 a reprendre" — executee directement. Pas besoin d ouvrir PunchLink.

Memos automatiques

"Synthese pour le COMEX hebdo" — rapport markdown structure avec avancement, alertes critiques, montants en attente, en 5 secondes.

3 facons de connecter PunchLink AI

Choisissez l assistant IA que vous utilisez deja.

2 minutes

Claude Desktop

L application officielle Anthropic. Connecteur natif via Settings → Connectors.

 3 minutes

Cowork

Le mode "non-developpeur" d Anthropic. Cle dans l URL via le parametre ?key=.

 5 minutes

GitHub Copilot (VS Code)

Pertinent pour entreprises ne validant que Copilot (Microsoft). Headers Bearer natifs.

Avant de commencer : 2 etapes obligatoires

1

Activer votre add-on PunchLink AI

Dans Reglages → PunchLink AI, cliquez sur Souscrire 49 EUR / mois. Paiement Stripe securise, resiliable a tout moment.

2

Generer votre cle API

Une fois l add-on actif, dans la meme section, cliquez sur + Nouvelle cle API. Donnez-lui un nom (ex. "Claude Desktop perso").

La cle s affiche sous la forme pl_live_XXXXXXXX.... Copiez-la immediatement : elle ne sera plus jamais affichee.

Connecter Claude Desktop

Methode recommandee : le connecteur natif (Claude Desktop 1.0+).

1
Ouvrez Claude Desktop.
2
Cliquez sur votre avatar → Settings → onglet Connectors.
3
Cliquez sur Add custom connector.
4
Remplissez :
  • Name : PunchLink
  • URL : https://ztavpcgkjsomfngpuxle.supabase.co/functions/v1/mcp-punchlink
  • Authentication : Bearer Token
  • Token : votre cle pl_live_...
5
Cliquez sur Connect. Claude detecte automatiquement les 10 outils PunchLink.
6
Dans une conversation, demandez : "Liste mes projets PunchLink".
Verification : Si Claude vous repond avec la liste de vos projets (code, nom, secteur, budget, compteurs), la connexion est OK.

Connecter Cowork

Cowork est le mode "non-developpeur" de Claude Desktop. Particularite : la cle se passe directement dans l URL.

1
Ouvrez Cowork → Customize → onglet Connecteurs.
2
Cliquez sur + en haut a droite → Ajouter un connecteur MCP personnalise.
3
Remplissez :
  • Nom : PunchLink
  • URL (avec votre cle a la fin) :
https://ztavpcgkjsomfngpuxle.supabase.co/functions/v1/mcp-punchlink?key=VOTRE_CLE
4
Cliquez sur Enregistrer. Cowork detecte les 10 outils.
5
Dans une conversation, tapez : "Liste mes projets PunchLink".
Securite : La cle etant dans l URL, elle apparait dans les logs. Cela reste acceptable car la cle est revocable a tout moment, mais ne la reutilisez pas ailleurs. Si vous changez de PC, generez une nouvelle cle.

Connecter GitHub Copilot (VS Code)

Particulierement pertinent en entreprise : la plupart des DSI autorisent Copilot (Microsoft) pour les usages professionnels. PunchLink AI se branche dessus sans installation supplementaire.

Methode rapide : palette de commandes

1
Ouvrez VS Code.
2
Ctrl + Shift + P (Windows/Linux) ou Cmd + Shift + P (Mac).
3
Tapez MCP: Add Server et selectionnez.
4
Choisissez le type HTTP Server.
5
Renseignez :
  • Server name : punchlink
  • URL : https://ztavpcgkjsomfngpuxle.supabase.co/functions/v1/mcp-punchlink
  • Headers : nom Authorization, valeur Bearer VOTRE_CLE
6
Choisissez la portee : User (tous projets) ou Workspace (ce dossier).
7
Ouvrez Copilot Chat → tapez @punchlink ou en mode Agent : "Audit du projet REVAMP".

Methode alternative : fichier mcp.json

Si vous etes a l aise, creez .vscode/mcp.json a la racine d un projet :

{
  "servers": {
    "punchlink": {
      "type": "http",
      "url": "https://ztavpcgkjsomfngpuxle.supabase.co/functions/v1/mcp-punchlink",
      "headers": { "Authorization": "Bearer VOTRE_CLE" }
    }
  }
}
Argument entreprise : Copilot etant deja approuve par la plupart des DSI (politique Microsoft 365), PunchLink AI s y branche sans valider une nouvelle stack IA. Vos donnees vont de PunchLink → votre VS Code → Copilot. Aucune surface d attaque ajoutee.

10 outils disponibles

PunchLink AI MVP v2 expose 10 outils MCP, classes en 2 categories : lecture (sans risque) et ecriture (avec verifications de droits).

OutilDescriptionDroits
list_projectsListe vos projets actifs avec KPITout role
get_project_summaryAudit complet projet (KPI, reserves, HSE, paiements)Membre projet
list_reservesListe reserves filtrees (criticite/statut/lot)Membre projet
list_orders_with_paymentsVue financiere : paye / en attente / valideMembre projet
search_doeRecherche dans les documents DOEMembre projet
create_reserveCree une reserve (mineure/majeure/bloquante)DO/AMO/CDP/Sup./OPC/HSE/Presta
submit_situationSoumet une situation sur une commandePrestataire commande
validate_situationValide ou refuse une situationDO/AMO/CDP/Achats
create_demo_projectCree un projet vide pour testTout role
invite_memberInvite un membre par emailDO/AMO/CDP

Bibliotheque de prompts utiles

Audit matinal

"Donne-moi un audit complet du projet [NOM] pour ma reunion de 9h"

Synthese direction

"Synthese de tous mes projets : avancement, reserves bloquantes, montants en attente"

Risque paiement

"Sur le projet [NOM], quelles commandes ont des paiements en attente depuis +30 jours ?"

Creation reserve

"Cree une reserve bloquante sur le lot [LOT] : [description]"

Validation situation

"La situation 4700030247 est-elle conforme au pourcentage d avancement reel ?"

Detection bloqueurs

"Quelles reserves bloquantes sont ouvertes depuis +15 jours sur tous mes projets ?"

Securite et bonnes pratiques

Garanties techniques offertes par PunchLink AI.

Authentification stricte

Chaque appel necessite une cle valide + add-on actif. Cle absente → refus.

Hachage bcrypt

Les cles sont stockees hashees. Meme L2V ne peut pas les lire en clair.

Kill-switch global

L2V peut suspendre instantanement tous les acces MCP en cas d incident.

RLS Postgres

Chaque outil verifie que vous etes membre du projet avant retour de donnees.

Audit trail complet

Chaque appel est trace : qui, quoi, quand, succes / echec.

Donnees jamais envoyees aux LLM

L IA ne fait que demander des outils. Vos donnees PunchLink restent dans PunchLink.

Si vous suspectez une fuite de cle

  1. Allez dans Reglages → PunchLink AI
  2. Trouvez la cle suspecte dans la liste
  3. Cliquez sur Revoquer
  4. Generez une nouvelle cle et reconfigurez votre client IA

Depannage rapide

ErreurCauseSolution
NO_API_KEYCle non transmiseVerifier header Authorization ou ?key= dans URL
KEY_INVALIDCle erronee ou tronqueeRegenerer + recopier integralement
KEY_NOT_FOUND_OR_REVOKEDCle revoqueeGenerer nouvelle cle
USER_SUBSCRIPTION_INACTIVEAdd-on resilieSouscrire / reactiver dans Reglages
MCP_DISABLED_GLOBALLYMaintenance L2VReessayer dans 10 min, sinon contact@punchlink.app
Project not accessiblePas membre du projetDemander acces au DO

Pret a piloter PunchLink en langage naturel ?

Activez PunchLink AI en 30 secondes — resiliable a tout moment, sans engagement.

Activer dans mon compte Telecharger le guide PDF

Une question ? contact@punchlink.app