Podłączenie asystenta AI przez MCP

Czym jest serwer MCP Wlaunch

Wlaunch ma serwer Model Context Protocol (MCP). Podłącz do niego Claude, ChatGPT lub innego klienta MCP, a Twój asystent AI będzie odpowiadać na pytania o dane Twojego biznesu w Wlaunch: klientów, wizyty, grafiki, finanse i raporty. Asystent tylko odczytuje dane i niczego nie zmienia.

Ten artykuł to krótka instrukcja. Wszystkie klienty MCP, limity i rozwiązywanie problemów opisuje strona dla deweloperów.

Kto może z niego korzystać

Serwer MCP jest częścią Licencji rozszerzonej, razem z integracjami API. Do połączenia potrzebujesz Licencji rozszerzonej i osobistego tokena dostępu.

Jak uzyskać token dostępu

Tokeny dostępu wydaje wsparcie Wlaunch. Skontaktuj się ze wsparciem i poproś o osobisty token dostępu do swojego konta Wlaunch.

Traktuj token jak hasło:

• daje dostęp do wszystkiego, co widzi Twoje konto, we wszystkich Twoich firmach;
• nie przechowuj go we wspólnych konfiguracjach, w git ani na zrzutach ekranu;
• uzyskaj osobny token dla każdej osoby i nikomu go nie przekazuj;
• jeśli token wpadł w niepowołane ręce lub nie jest już potrzebny, skontaktuj się ze wsparciem, a zostanie unieważniony.

Jak podłączyć asystenta

Adres serwera:

https://mcp.wlaunch.net/mcp

Serwer oczekuje tokena w standardowym nagłówku każdego żądania:

Authorization: Bearer <access_token>

W krokach dla Claude Desktop poniżej zastąp <access_token> tokenem, który przesłało wsparcie.

Claude Code

Umieść token w zmiennej środowiskowej WLAUNCH_MCP_TOKEN, wczytując go z menedżera sekretów lub systemowego pęku kluczy, a potem dodaj serwer z terminala:

claude mcp add --transport http wlaunch https://mcp.wlaunch.net/mcp \
  --header "Authorization: Bearer $WLAUNCH_MCP_TOKEN"

Sprawdź, czy serwer został dodany, poleceniem claude mcp list. Nie wpisuj samego tokena w poleceniu: powłoka zapisuje każde polecenie w historii. Claude Code zapisuje token w swojej konfiguracji otwartym tekstem, więc traktuj ten plik jak dane logowania.

Claude Desktop

Token wpisuje się w sekcji Request headers okna Add custom connector. Anthropic udostępnia tę sekcję w wersji beta ograniczonej grupie organizacji: jeśli w Twoim oknie jej nie ma, połącz się przez Claude Code. W planach Team i Enterprise własny łącznik może dodać tylko właściciel (Owner), a nagłówek jest wtedy wspólny dla całej organizacji, więc tam też korzystaj z Claude Code.

Kolejność kroków ma znaczenie: najpierw uwierzytelnianie, potem nagłówek.

1. Otwórz Customize → Connectors i naciśnij Add custom connector.
2. Wpisz Wlaunch w polu Name i https://mcp.wlaunch.net/mcp w polu URL, a potem naciśnij Continue.
3. W sekcji Authentication wybierz No sign-in. Okno może samo zaznaczyć Sign in now: nie przyjmuj tego, bo logowanie zakończy się błędem.
4. W sekcji Request headers naciśnij Add header, wybierz authorization i wpisz wartość Bearer <access_token>.
5. Naciśnij Add.

Instrukcje dla Codex CLI, ChatGPT i innych klientów MCP znajdziesz na stronie dla deweloperów.

Jak sprawdzić, czy wszystko działa

Zapytaj asystenta: „Jakie firmy widzi ta integracja?”

Asystent powinien wywołać narzędzie wlaunch_company_context i wymienić Twoje firmy. Od niego zaczyna się każde inne pytanie: zwraca słownik Twojej firmy (statusy wizyt, oddziały, tagi, typy operacji finansowych), którego pozostałe narzędzia potrzebują, aby odpowiadać poprawnie.

Co asystent może, a czego nie

• Odczytuje dane za pomocą 25 narzędzi: klienci, wizyty, grafiki, usługi, abonamenty, zamówienia, finanse, wynagrodzenia, magazyn, oceny, ankiety, wiadomości, a także raporty P&L, przepływów pieniężnych, stanu środków, statystyki i retencji klientów.
• Tylko odczytuje. Żadne narzędzie niczego nie tworzy, nie edytuje, nie anuluje ani nie usuwa: asystent nie umówi wizyty, nie zmieni ceny i nie doda klienta.
• Widzi nie więcej niż Ty. Każde żądanie idzie w imieniu Twojego konta, z tymi samymi uprawnieniami co w backoffice. Jeśli Twoje konto nie widzi wynagrodzeń oddziału, asystent też ich nie zobaczy.

Przykładowe pytania dla właściciela i menedżera zebraliśmy w osobnym poradniku.