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

User Guide: connect your AI to PunchLink

Audit your projects, create reserves, submit situations in natural language from Claude, Cowork or GitHub Copilot. No heavy installation, no data duplication.

Activate in my account Installation guide

One connector, all AI assistants

PunchLink AI is based on the MCP (Model Context Protocol) standard, open and supported by all major professional AI assistants.

Instant audit

"Give me a complete audit of the REVAMP project" — response in 2 seconds with progress, reserves, payments, HSE, DOE (Executed Works File / as-built). Every figure is traceable.

Concrete actions

"Create a blocking reserve on the piping lot: P-103 tapping weld to redo" — executed directly. No need to open PunchLink.

Automatic memos

"Summary for weekly COMEX" — structured markdown report with progress, critical alerts, pending amounts, in 5 seconds.

3 ways to connect PunchLink AI

Choose the AI assistant you already use.

2 minutes

Claude Desktop

The official Anthropic application. Native connector via Settings → Connectors.

 3 minutes

Cowork

The "non-developer" mode from Anthropic. Key in the URL via the ?key= parameter.

 5 minutes

GitHub Copilot (VS Code)

Relevant for enterprises validating only Copilot (Microsoft). Native Bearer headers.

Before you start: 2 mandatory steps

1

Activate your PunchLink AI add-on

In Settings → PunchLink AI, click Subscribe 49 EUR / month. Secure Stripe payment, cancellable at any time.

2

Generate your API key

Once the add-on is active, in the same section, click + New API Key. Give it a name (e.g. "Claude Desktop personal").

The key appears in the form pl_live_XXXXXXXX.... Copy it immediately: it will never be displayed again.

Connect Claude Desktop

Recommended method: the native connector (Claude Desktop 1.0+).

1
Open Claude Desktop.
2
Click on your avatar → Settings → Connectors tab.
3
Click on Add custom connector.
4
Fill in:
  • Name : PunchLink
  • URL : https://ztavpcgkjsomfngpuxle.supabase.co/functions/v1/mcp-punchlink
  • Authentication : Bearer Token
  • Token : your key pl_live_...
5
Click Connect. Claude automatically detects the 10 PunchLink tools.
6
In a conversation, ask: "List my PunchLink projects".
Verification: If Claude replies with your projects list (code, name, sector, budget, counters), the connection is OK.

Connect Cowork

Cowork is the "non-developer" mode of Claude Desktop. Particularity: the key is passed directly in the URL.

1
Open Cowork → Customize → Connectors tab.
2
Click + at the top right → Add custom MCP connector.
3
Fill in:
  • Name: PunchLink
  • URL (with your key at the end):
https://ztavpcgkjsomfngpuxle.supabase.co/functions/v1/mcp-punchlink?key=YOUR_KEY
4
Click Save. Cowork detects the 10 tools.
5
In a conversation, type: "List my PunchLink projects".
Security: Since the key is in the URL, it appears in logs. This remains acceptable because the key is revocable at any time, but do not reuse it elsewhere. If you change computers, generate a new key.

Connect GitHub Copilot (VS Code)

Particularly relevant in enterprise: most IT departments authorize Copilot (Microsoft) for professional use. PunchLink AI integrates without additional installation.

Quick method: command palette

1
Open VS Code.
2
Ctrl + Shift + P (Windows/Linux) or Cmd + Shift + P (Mac).
3
Type MCP: Add Server and select.
4
Choose type HTTP Server.
5
Fill in:
  • Server name: punchlink
  • URL: https://ztavpcgkjsomfngpuxle.supabase.co/functions/v1/mcp-punchlink
  • Headers: name Authorization, value Bearer YOUR_KEY
6
Choose scope: User (all projects) or Workspace (this folder).
7
Open Copilot Chat → type @punchlink or in Agent mode: "Audit of REVAMP project".

Alternative method: mcp.json file

If you are comfortable, create .vscode/mcp.json at the root of a project:

{
  "servers": {
    "punchlink": {
      "type": "http",
      "url": "https://ztavpcgkjsomfngpuxle.supabase.co/functions/v1/mcp-punchlink",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}
Enterprise argument: Copilot being already approved by most IT departments (Microsoft 365 policy), PunchLink AI integrates without validating a new AI stack. Your data flows from PunchLink → your VS Code → Copilot. No additional attack surface.

10 available tools

PunchLink AI MVP v2 exposes 10 MCP tools, classified in 2 categories: read (risk-free) and write (with rights verification).

ToolDescriptionRights
list_projectsList your active projects with KPIsAny role
get_project_summaryComplete project audit (KPI, reserves, HSE, payments)Project member
list_reservesList filtered reserves (criticality/status/lot)Project member
list_orders_with_paymentsFinancial view: paid / pending / validatedProject member
search_doeSearch in DOE documentsProject member
create_reserveCreate a reserve (minor/major/blocking)PM/AMO/PC/Sup./OPC/HSE/Vendor
submit_situationSubmit a situation on an orderOrder vendor
validate_situationValidate or reject a situationPM/AMO/PC/Procurement
create_demo_projectCreate an empty project for testingAny role
invite_memberInvite a member by emailPM/AMO/PC

Library of useful prompts

Morning audit

"Give me a complete audit of project [NAME] for my 9am meeting"

Management summary

"Summary of all my projects: progress, blocking reserves, pending amounts"

Payment risk

"On project [NAME], which orders have pending payments for 30+ days?"

Create reserve

"Create a blocking reserve on lot [LOT]: [description]"

Validate situation

"Is situation 4700030247 compliant with the actual progress percentage?"

Blocker detection

"Which blocking reserves have been open for 15+ days on all my projects?"

Security and best practices

Technical guarantees provided by PunchLink AI.

Strict authentication

Each call requires a valid key + active add-on. Missing key → refused.

bcrypt hashing

Keys are stored hashed. Even L2V cannot read them in plain text.

Global kill-switch

L2V can instantly suspend all MCP access in case of incident.

Postgres RLS

Each tool verifies you are a project member before returning data.

Complete audit trail

Each call is logged: who, what, when, success/failure.

Data never sent to LLM

The AI only requests tools. Your PunchLink data stays in PunchLink.

If you suspect a key leak

  1. Go to Settings → PunchLink AI
  2. Find the suspect key in the list
  3. Click Revoke
  4. Generate a new key and reconfigure your AI client

Quick troubleshooting

ErrorCauseSolution
NO_API_KEYKey not transmittedCheck Authorization header or ?key= in URL
KEY_INVALIDWrong or truncated keyRegenerate + copy in full
KEY_NOT_FOUND_OR_REVOKEDKey revokedGenerate new key
USER_SUBSCRIPTION_INACTIVEAdd-on cancelledSubscribe / reactivate in Settings
MCP_DISABLED_GLOBALLYL2V maintenanceRetry in 10 min, otherwise contact@punchlink.app
Project not accessibleNot a project memberRequest access from PM

Ready to manage PunchLink in natural language?

Activate PunchLink AI in 30 seconds — cancellable at any time, no commitment.

Activate in my account Download PDF guide

Any question? contact@punchlink.app

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

PunchLink AI — native AI assistant

Manage your projects in natural language from Claude Desktop, ChatGPT, Cursor or Copilot. 10 database tools exposed as MCP: project audit, reserve creation, situation submission, validation, DOE search, member invitation. Add-on €49/month, disableable per project for sensitive clients.

PunchLink AI Single Folder with automatic multi-format analysis: PDF, DOCX, XLSX, PPTX, DWG, DXF, IFC, images, ZIP — patent pending

Single AI folder — proprietary method

Drag and drop a document — any format: PDF, Word, Excel, PowerPoint, DWG/DXF plans, BIM IFC model, site ZIP. The AI analyzes, classifies, routes to the right module with a confidence score. L2V proprietary method, patent pending with INPI.