PunchLink MCP-Konnektor: Claude, Cowork oder Copilot verbinden

Was ist ein MCP?

Wenn Ihnen das Kürzel noch nie begegnet ist, genügt dieser Abschnitt.

Eine genormte Steckdose zwischen Ihrem KI-Assistenten und PunchLink

MCP steht für Model Context Protocol. Es ist eine genormte Steckdose: auf der einen Seite Ihr KI-Assistent (Claude, Cowork, GitHub Copilot), auf der anderen PunchLink. Jeder Assistent, der den Standard unterstützt, wird eingesteckt — ohne Sonderentwicklung, ohne maßgeschneiderte Schnittstelle, ohne Ihre Daten anderswohin zu exportieren.

Ohne MCP weiß Ihr Assistent nichts über Ihr Projekt: Sie müssen Auszüge aus Tabellen oder PDF-Dateien kopieren. Mit MCP fragt er PunchLink direkt ab — mit Ihren Rechten und nicht mehr. Jeder Aufruf wird protokolliert.

Was sich in der Praxis ändert

Vor der Baubesprechung: „Welche blockierenden Mängel sind im Los Rohrleitungsbau noch offen?“ — der Assistent liest den echten Stand in PunchLink statt in einer veralteten Tabelle.
Vor dem Lenkungsausschuss: „Erstelle mir ein Geschäftsleitungsmemo zum Projekt REVAMP“ — Fortschritt, Mängel, offene Abschlagsrechnungen, aus der Datenbank statt aus dem Gedächtnis.
Im Streitfall: „Finde das Prüfprotokoll der Pumpe P-103 in der Bestandsdokumentation“ — der Nachweis wird in der Projektdokumentation gefunden, nicht im Postfach.

Der Assistent fordert bei PunchLink nur Werkzeuge an. Ihre Daten bleiben bei PunchLink: Sie dienen nicht dem Training von Modellen.

Ein Connector für alle KI-Assistenten

Der PunchLink MCP-Konnektor basiert auf dem Standard MCP (Model Context Protocol), offen und unterstützt von allen großen professionellen KI-Assistenten.

Sofortiges Audit

"Geben Sie mir ein vollständiges Audit des Projekts REVAMP" — Antwort in 2 Sekunden mit Fortschritt, Reserven, Zahlungen, HSE, DÜ (Dokumentation ausgeführter Arbeiten / Aufmaßdokumentation / as-built). Jede Zahl ist nachverfolgbar.

Konkrete Maßnahmen

"Erstellen Sie eine blockierende Reserve für das Rohrleitungswerk: Schweißnaht Anschluss P-103 muss überarbeitet werden" — sofort ausgeführt. Sie müssen PunchLink nicht öffnen.

Automatische Memos

"Zusammenfassung für wöchentliches Managementtreffen" — strukturierter Markdown-Bericht mit Fortschritt, kritischen Warnungen, ausstehenden Beträgen in 5 Sekunden.

Bevor Sie beginnen: ein einziger Schritt

Erstellen Sie Ihren API-Schlüssel

Der MCP-Konnektor steht in Ihrem Konto bereits zur Verfügung: Es gibt nichts zu aktivieren. Unter Einstellungen → MCP-Konnektor klicken Sie auf + Neuer API-Schlüssel. Geben Sie ihm einen Namen (z. B. „Claude Desktop personal“).

Der Schlüssel wird in der Form pl_live_XXXXXXXX... angezeigt. Kopieren Sie ihn sofort: Er wird nie wieder angezeigt.

Bei Claude Desktop und Cowork genügt die OAuth-Verbindung mit einem Klick — ganz ohne Schlüssel.

Claude Desktop verbinden

Empfohlene Methode: Der native Connector (Claude Desktop 1.0+).

Öffnen Sie Claude Desktop.

Klicken Sie auf Ihren Avatar → Einstellungen → Reiter Connectoren.

Klicken Sie auf Benutzerdefinierten Connector hinzufügen.

Füllen Sie aus:

Name : PunchLink
URL : https://www.punchlink.app/mcp
Authentication: OAuth — lassen Sie Client ID / Secret leer. Beim Klick auf Connect öffnet sich die PunchLink-Anmeldeseite: Melden Sie sich mit Ihrem Konto an.

Klicken Sie auf Verbinden. Claude erkennt automatisch die 10 PunchLink-Tools.

Fragen Sie in einer Unterhaltung: "Meine PunchLink-Projekte auflisten".

Überprüfung : Wenn Claude Ihnen mit der Liste Ihrer Projekte antwortet (Code, Name, Sektor, Budget, Zähler), ist die Verbindung OK.

Cowork verbinden

Cowork ist der „Nicht-Entwickler“-Modus von Claude. Dieselbe Adresse wie überall, Anmeldung per OAuth: kein Schlüssel nötig.

Öffnen Sie Cowork → Anpassen → Reiter Konnektoren.

Klicken Sie oben rechts auf + → Benutzerdefinierten MCP-Konnektor hinzufügen.

Ausfüllen: Name PunchLink · URL https://www.punchlink.app/mcp — ohne Schlüssel, erweiterte Felder leer.

Speichern und auf Verbinden klicken: Die PunchLink-Anmeldeseite öffnet sich — melden Sie sich mit Ihrem PunchLink-Konto an.

Cowork erkennt die 11 Tools. Schreiben Sie in einer Unterhaltung: "Liste meine PunchLink-Projekte".

Sicherheit: Es ist kein Schlüssel unterwegs. Ihr Assistent erhält ein widerrufbares Token, beschränkt auf Ihre Projekte — und der Server weist jeden Schlüssel in einer URL zurück.

GitHub Copilot verbinden (VS Code)

Besonders relevant im Unternehmen: Die meisten CIOs genehmigen Copilot (Microsoft) für geschäftliche Zwecke. Der MCP-Konnektor dockt sich darauf an, ohne zusätzliche Installation erforderlich.

Schnelle Methode: Befehlspalette

Öffnen Sie VS Code.

Strg + Umschalt + P (Windows/Linux) oder Cmd + Shift + P (Mac).

Geben Sie MCP: Add Server ein und wählen Sie aus.

Wählen Sie den Typ HTTP Server.

Geben Sie ein:

Server name : punchlink
URL : https://www.punchlink.app/mcp
Headers : Name Authorization, Wert Bearer IHR_SCHLÜSSEL

Wählen Sie den Umfang: User (alle Projekte) oder Workspace (dieser Ordner).

Öffnen Sie Copilot Chat → geben Sie @punchlink ein oder im Agent-Modus: "Audit des Projekts REVAMP".

Alternative Methode: mcp.json-Datei

Wenn Sie sich komfortabel fühlen, erstellen Sie .vscode/mcp.json im Stamm eines Projekts:

{

  "servers": {

    "punchlink": {

      "type": "http",

      "url": "https://www.punchlink.app/mcp",

      "headers": { "Authorization": "Bearer IHR_SCHLÜSSEL" }

    }

  }

}

Enterprise-Argument : Da Copilot bereits von den meisten CIOs genehmigt ist (Microsoft 365-Richtlinie), dockt der MCP-Konnektor sich an, ohne einen neuen KI-Stack zu validieren. Ihre Daten gehen von PunchLink → Ihrem VS Code → Copilot. Keine zusätzliche Angriffsfläche.

10 verfügbare Tools

Der PunchLink MCP-Konnektor stellt 10 Tools bereit, eingeteilt in 2 Kategorien: Lesen (risikolos) und Schreiben (mit Berechtigungsprüfungen).

Tool	Beschreibung	Berechtigungen
`list_projects`	Listet Ihre aktiven Projekte mit KPIs auf	Jede Rolle
`get_project_summary`	Vollständiger Projekt-Audit (KPI, Reservierungen, HSE, Zahlungen)	Projektmitglied
`list_reserves`	Reservierungen filtern (Kritikalität/Status/Los)	Projektmitglied
`list_orders_with_payments`	Finanzielle Ansicht: bezahlt / ausstehend / validiert	Projektmitglied
`search_doe`	In DOE-Dokumenten suchen	Projektmitglied
`create_reserve`	Erstellt eine Reservierung (minor/major/blocking)	DO/AMO/CDP/Sup./OPC/HSE/Presta
`submit_situation`	Reicht eine Situation für einen Auftrag ein	Auftragsanbieter
`validate_situation`	Validiert oder lehnt eine Situation ab	DO/AMO/CDP/Einkauf
`create_demo_project`	Erstellt ein leeres Projekt zum Testen	Jede Rolle
`invite_member`	Lädt ein Mitglied per E-Mail ein	DO/AMO/CDP

Bibliothek nützlicher Prompts

Morgen-Audit

"Geben Sie mir ein vollständiges Audit des Projekts [NAME] für mein 9-Uhr-Treffen"

Managementzusammenfassung

"Zusammenfassung aller meiner Projekte: Fortschritt, blockierende Reservierungen, ausstehende Beträge"

Zahlungsrisiko

"Für Projekt [NAME], welche Aufträge haben Zahlungen, die seit +30 Tagen ausstehen?"

Reservierung erstellen

"Erstellen Sie eine blockierende Reservierung für Los [LOS]: [Beschreibung]"

Situation validieren

"Entspricht Situation 4700030247 dem Prozentsatz des tatsächlichen Fortschritts?"

Blocker-Erkennung

"Welche blockierenden Reservierungen sind seit +15 Tagen offen in allen meinen Projekten?"

Sicherheit und Best Practices

Technische Garantien des MCP-Konnektors.

Strikte Authentifizierung

Jeder Aufruf erfordert einen gültigen Schlüssel oder eine aktive OAuth-Sitzung. Fehlender Schlüssel → Ablehnung.

Bcrypt-Hashing

Schlüssel werden gehashed gespeichert. Selbst L2V kann sie nicht im Klartext lesen.

Globaler Kill-Switch

L2V kann im Falle eines Vorfalls sofort alle MCP-Zugriffe deaktivieren.

Postgres RLS

Jedes Tool prüft, dass Sie Projektmitglied sind, bevor Daten zurückgegeben werden.

Vollständiger Audit-Trail

Jeder Aufruf wird verfolgt: Wer, Was, Wann, Erfolg/Fehler.

Daten nie an LLMs gesendet

Die KI fragt nur nach Tools. Ihre PunchLink-Daten bleiben in PunchLink.

Wenn Sie einen Schlüsselleck vermuten

Gehen Sie zu Einstellungen → MCP-Konnektor
Finden Sie den verdächtigen Schlüssel in der Liste
Klicken Sie auf Widerrufen
Generieren Sie einen neuen Schlüssel und konfigurieren Sie Ihren KI-Client neu

Schnelle Fehlerbehebung

Fehler	Ursache	Lösung
`NO_API_KEY`	Schlüssel nicht übertragen	Prüfen Sie den Authorization-Header (Bearer pl_live_...) — oder wiederholen Sie die OAuth-Anmeldung. Schlüssel in der URL werden zurückgewiesen.
`KEY_INVALID`	Falscher oder verkürzter Schlüssel	Neu generieren + vollständig kopieren
`KEY_NOT_FOUND_OR_REVOKED`	Schlüssel widerrufen	Neuen Schlüssel generieren
`USER_SUBSCRIPTION_INACTIVE`	PunchLink-Konto ohne aktives Angebot	Kontostatus mit Ihrem Administrator prüfen
`MCP_DISABLED_GLOBALLY`	L2V-Wartung	In 10 Min erneut versuchen, ansonsten contact@punchlink.app
Project not accessible	Nicht Projektmitglied	Zugriff vom DO anfordern

Anleitung: Verbinden Sie Ihre KI mit PunchLink