PunchLink by IndustriaLink Request a demo
MCP connector · included in every plan

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.

The MCP connector is included in every PunchLink plan. No extra charge, no box to tick, no separate subscription: it is available as soon as your account is active. All you need is an API key — or a one-click OAuth connection. This kind of connector is usually billed as an extra elsewhere.

What is an MCP?

If you have never come across the acronym, this section is enough.

A standard socket between your AI assistant and PunchLink

MCP stands for Model Context Protocol. It is a standard socket, like a power outlet: your AI assistant (Claude, Cowork, GitHub Copilot) on one side, PunchLink on the other. Any assistant that follows the standard plugs straight in — no bespoke development, no custom gateway, no exporting your data somewhere else.

Without MCP, your assistant knows nothing about your project: you have to copy and paste extracts from spreadsheets or PDFs. With MCP it queries PunchLink directly, with your permissions and nothing more. Every call is logged.

What it changes on a job

The assistant only asks PunchLink for tools. Your data stays with PunchLink: it is never used to train any model.

One connector, all AI assistants

The PunchLink MCP connector 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

Choose the AI assistant you already use.

Before you start: a single step

1

Generate your API key

The MCP connector is already available on your account: there is nothing to activate. In Settings → MCP connector, 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.

With Claude Desktop and Cowork, the one-click OAuth connection means you do not even need a key.

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://www.punchlink.app/mcp
  • Authentication: OAuth — leave the Client ID / Secret fields empty. When you click Connect, the PunchLink sign-in page opens: log in with your account.
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 Claude's "non-developer" mode. Same address as everywhere else, with OAuth sign-in: no key to handle.

1
Open Cowork → Customize → Connectors tab.
2
Click + at the top right → Add custom MCP connector.
3
Fill in: Name PunchLink · URL https://www.punchlink.app/mcp — no key, advanced fields empty.
4
Save, then click Connect: the PunchLink sign-in page opens — log in with your PunchLink account.
5
Cowork detects the 11 tools. In a conversation, type: "List my PunchLink projects".
Security: no key ever travels. Your assistant receives a revocable token, limited to your projects — and the server refuses any key placed in a URL.

Connect GitHub Copilot (VS Code)

Particularly relevant in enterprise: most IT departments authorize Copilot (Microsoft) for professional use. The MCP connector 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://www.punchlink.app/mcp
  • 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://www.punchlink.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}
Enterprise argument: Copilot being already approved by most IT departments (Microsoft 365 policy), the MCP connector integrates without validating a new AI stack. Your data flows from PunchLink → your VS Code → Copilot. No additional attack surface.

10 available tools

The PunchLink MCP connector exposes 10 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 the MCP connector.

Strict authentication

Each call requires a valid key or an active OAuth session. 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 → MCP connector
  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 the Authorization header (Bearer pl_live_...) — or redo the OAuth sign-in. Keys in the URL are refused.
KEY_INVALIDWrong or truncated keyRegenerate + copy in full
KEY_NOT_FOUND_OR_REVOKEDKey revokedGenerate new key
USER_SUBSCRIPTION_INACTIVEPunchLink account without an active planCheck the account status with your administrator
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?

The MCP connector is included in your plan. Generate your API key and connect your assistant in 3 minutes.

Generate my API key Download PDF guide

Any question? contact@punchlink.app · +33 9 72 10 52 94

PunchLink MCP connector: connection Claude Desktop, ChatGPT, Cursor, Cline, Continue, Cowork, GitHub Copilot

PunchLink MCP connector

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. Included in every plan, disableable per project for sensitive clients.

Single AI folder in PunchLink with automatic multi-format analysis: PDF, DOCX, XLSX, PPTX, DWG, DXF, IFC, images, ZIP — prior-art filing with INPI

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, INPI prior-art filing with INPI.