Konektor MCP PunchLink: połącz Claude, Cowork lub Copilot

Czym jest MCP?

Jeśli nigdy nie spotkałeś się z tym skrótem, ta sekcja wystarczy.

Znormalizowane gniazdo między asystentem AI a PunchLink

MCP oznacza Model Context Protocol. To znormalizowane gniazdo, jak gniazdko elektryczne: z jednej strony asystent AI (Claude, Cowork, GitHub Copilot), z drugiej PunchLink. Każdy asystent zgodny ze standardem po prostu się podłącza — bez dedykowanego rozwoju, bez własnej bramki, bez eksportowania danych na zewnątrz.

Bez MCP asystent nie wie nic o projekcie: trzeba kopiować fragmenty arkuszy lub plików PDF. Z MCP odpytuje PunchLink bezpośrednio, w zakresie Twoich uprawnień i nic ponadto. Każde wywołanie jest rejestrowane.

Co to zmienia na budowie

Przed naradą na obiekcie: „które usterki blokujące pozostają otwarte w pakiecie robót rurociągowych?” — asystent czyta rzeczywisty stan w PunchLink, a nie nieaktualny arkusz.
Przed komitetem: „przygotuj notatkę dla kierownictwa o zadaniu REVAMP” — postęp, usterki, oczekujące protokoły zaawansowania, wprost z bazy, a nie z pamięci.
W sporze: „znajdź protokół kontroli pompy P-103 w dokumentacji powykonawczej” — dokument znajduje się w dokumentacji projektu, a nie w skrzynce pocztowej.

Asystent jedynie prosi PunchLink o narzędzia. Twoje dane pozostają w PunchLink: nie służą do trenowania żadnego modelu.

Jeden łącznik, wszystkie asystenci AI

Konektor MCP PunchLink opiera się na standardzie MCP (Model Context Protocol), otwartym i obsługiwanym przez wszystkich głównych profesjonalnych asystentów AI.

Natychmiastowy audyt

"Daj mi pełny audyt projektu REVAMP" — odpowiedź w 2 sekundy z postępem, rezerwami, płatnościami, BHP, DOE (Dossier d'Ouvrages Exécutés / dokumentacja odbioru / as-built). Każda liczba jest śledzona.

Konkretne działania

"Utwórz rezerwę blokującą na dziale rur: spawanie podejścia P-103 do naprawy" — wykonana natychmiast. Nie trzeba otwierać PunchLink.

Automatyczne notatki

"Streszczenie dla tygodniowego COMEX" — raport markdown ze strukturą z postępem, alertami krytycznymi, kwotami oczekującymi w 5 sekund.

Przed rozpoczęciem: jeden krok

Wygeneruj swój klucz API

Konektor MCP jest już dostępny na Twoim koncie: nie ma nic do aktywowania. W Ustawienia → Konektor MCP kliknij + Nowy klucz API. Nadaj mu nazwę (np. „Claude Desktop osobisty”).

Klucz pojawia się w formacie pl_live_XXXXXXXX.... Skopiuj go natychmiast: nigdy więcej nie będzie wyświetlany.

W Claude Desktop i Cowork połączenie OAuth jednym kliknięciem pozwala obejść się bez klucza.

Połącz Claude Desktop

Zalecana metoda: natywny łącznik (Claude Desktop 1.0+).

Otwórz Claude Desktop.

Kliknij na swój awatar → Settings → zakładka Connectors.

Kliknij na Add custom connector.

Wypełnij:

Name : PunchLink
URL : https://www.punchlink.app/mcp
Authentication: OAuth — pozostaw puste pola Client ID / Secret. Po kliknięciu Connect otworzy się strona logowania PunchLink: zaloguj się swoim kontem.

Kliknij na Connect. Claude automatycznie wykryje 11 narzędzi PunchLink.

W konwersacji zapytaj: "Wypisz moje projekty PunchLink".

Weryfikacja: Jeśli Claude odpowie listą twoich projektów (kod, nazwa, sektor, budżet, liczniki), połączenie jest OK.

Połączenie Cowork

Cowork to tryb „nie-programisty" Claude. Ten sam adres co wszędzie, logowanie przez OAuth: żadnych kluczy.

Otwórz Cowork → Dostosuj → zakładka Konektory.

Kliknij + w prawym górnym rogu → Dodaj niestandardowy konektor MCP.

Wypełnij: Nazwa PunchLink · URL https://www.punchlink.app/mcp — bez klucza, pola zaawansowane puste.

Zapisz, a następnie kliknij Połącz: otworzy się strona logowania PunchLink — zaloguj się kontem PunchLink.

Cowork wykrywa 11 narzędzi. W rozmowie wpisz: "Wypisz moje projekty PunchLink".

Bezpieczeństwo: żaden klucz nie krąży. Twój asystent otrzymuje odwoływalny token, ograniczony do Twoich projektów — a serwer odrzuca każdy klucz umieszczony w URL.

Połącz GitHub Copilot (VS Code)

Szczególnie istotne w przedsiębiorstwie: większość CIO autoryzuje Copilot (Microsoft) do użytku biznesowego. Konektor MCP podłącza się bez dodatkowej instalacji.

Szybka metoda: paleta poleceń

Otwórz VS Code.

Ctrl + Shift + P (Windows/Linux) lub Cmd + Shift + P (Mac).

Wpisz MCP: Add Server i wybierz.

Wybierz typ HTTP Server.

Podaj:

Nazwa serwera: punchlink
URL: https://www.punchlink.app/mcp
Nagłówki: nazwa Authorization, wartość Bearer TWÓJ_KLUCZ

Wybierz zakres: User (wszystkie projekty) lub Workspace (ten folder).

Otwórz Copilot Chat → wpisz @punchlink lub w trybie Agenta: "Audyt projektu REVAMP".

Alternatywna metoda: plik mcp.json

Jeśli czujesz się komfortowo, utwórz .vscode/mcp.json w głównym folderze projektu:

{

  "servers": {

    "punchlink": {

      "type": "http",

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

      "headers": { "Authorization": "Bearer TWÓJ_KLUCZ" }

    }

  }

}

Argument dla przedsiębiorstwa: Ponieważ Copilot jest już zatwierdzony przez większość CIO (polityka Microsoft 365), konektor MCP podłącza się bez zatwierdzenia nowego stosu AI. Twoje dane przechodzą z PunchLink → Twój VS Code → Copilot. Żadna dodatkowa powierzchnia ataku.

10 dostępnych narzędzi

Konektor MCP PunchLink udostępnia 11 narzędzi, podzielonych na 2 kategorie: odczyt (bez ryzyka) i zapis (z weryfikacją uprawnień).

Narzędzie	Opis	Uprawnienia
`list_projects`	Wyświetla Twoje aktywne projekty z KPI	Każda rola
`get_project_summary`	Pełny audyt projektu (KPI, rezerwy, BHP, płatności)	Członek projektu
`list_reserves`	Wyświetla rezerwy filtrowane (ważność/status/partia)	Członek projektu
`list_orders_with_payments`	Widok finansowy: zapłacone / oczekujące / zatwierdzone	Członek projektu
`search_doe`	Wyszukiwanie w dokumentach DOE	Członek projektu
`create_reserve`	Tworzy rezerwę (drobna/większa/blokująca)	DO/AMO/CDP/Sup./OPC/BHP/Prestatariusz
`submit_situation`	Przesyła sytuację dla zamówienia	Prestatariusz zamówienia
`validate_situation`	Zatwierdza lub odrzuca sytuację	DO/AMO/CDP/Zakupy
`create_demo_project`	Tworzy pusty projekt do testów	Każda rola
`invite_member`	Zaprasza członka przez email	DO/AMO/CDP

Biblioteka przydatnych promptów

Poranny audyt

"Daj mi pełny audyt projektu [NAZWA] do mojego spotkania o 9 rano"

Streszczenie dla kierownictwa

"Streszczenie wszystkich moich projektów: postęp, rezerwy blokujące, kwoty oczekujące"

Ryzyko płatności

"W projekcie [NAZWA] które zamówienia mają płatności oczekujące przez +30 dni?"

Tworzenie rezerwy

"Utwórz rezerwę blokującą dla partii [PARTIA]: [opis]"

Zatwierdzenie sytuacji

"Czy sytuacja 4700030247 zgadza się z rzeczywistym procentem postępu?"

Wykrywanie blokad

"Które rezerwy blokujące są otwarte od +15 dni na wszystkich moich projektach?"

Bezpieczeństwo i dobre praktyki

Gwarancje techniczne konektora MCP.

Ścisłe uwierzytelnianie

Każde żądanie wymaga ważnego klucza lub aktywnej sesji OAuth. Brak klucza → odmowa.

Skrót bcrypt

Klucze są przechowywane w postaci haszowanej. Nawet L2V nie może ich przeczytać w czystym tekście.

Wyłącznik awaryjny

L2V może natychmiast zawiesić wszystkie dostępy MCP w przypadku incydentu.

RLS Postgres

Każde narzędzie weryfikuje, że jesteś członkiem projektu, zanim zwróci dane.

Pełny ślad audytu

Każde żądanie jest rejestrowane: kto, co, kiedy, powodzenie / niepowodzenie.

Dane nigdy nie są wysyłane do LLM

AI jedynie żąda narzędzi. Twoje dane PunchLink pozostają w PunchLink.

Jeśli podejrzewasz wyciek klucza

Przejdź do Ustawienia → Konektor MCP
Znajdź podejrzany klucz na liście
Kliknij Odwołaj
Wygeneruj nowy klucz i ponownie skonfiguruj klienta AI

Szybkie rozwiązywanie problemów

Błąd	Przyczyna	Rozwiązanie
`NO_API_KEY`	Klucz nie przesłany	Sprawdź nagłówek Authorization (Bearer pl_live_...) — lub powtórz logowanie OAuth. Klucze w URL są odrzucane.
`KEY_INVALID`	Klucz błędny lub obcięty	Wygeneruj ponownie + skopiuj całkowicie
`KEY_NOT_FOUND_OR_REVOKED`	Klucz odwołany	Wygeneruj nowy klucz
`USER_SUBSCRIPTION_INACTIVE`	Konto PunchLink bez aktywnej oferty	Sprawdź status konta u administratora
`MCP_DISABLED_GLOBALLY`	Konserwacja L2V	Spróbuj za 10 minut, inaczej contact@punchlink.app
Projekt niedostępny	Nie jesteś członkiem projektu	Poproś o dostęp do DO

Instrukcja: połącz swoją sztuczną inteligencję z PunchLink