Dla deweloperów
Serwer MCP: połącz Claude i ChatGPT
Wlaunch udostępnia serwer Model Context Protocol (MCP). Podłącz do niego Claude, ChatGPT lub dowolnego innego klienta MCP, a Twój asystent AI będzie odpowiadać na pytania o dane Twojego biznesu w Wlaunch: klientów, wizyty, finanse i raporty. Asystent tylko odczytuje dane i niczego nie zmienia.
Adres serwera MCP
https://mcp.wlaunch.net/mcp- Tylko odczyt
- Licencja rozszerzona
- Streamable HTTP
Co robi serwer MCP
Daje asystentowi AI dostęp do odczytu Twoich danych w Wlaunch przez 25 narzędzi. Obejmują one:
Klienci
Wizyty
Grafiki
Usługi
Abonamenty
Zamówienia
Finanse
Wynagrodzenia
Magazyn
Oceny
Ankiety
Wiadomości
Raporty P&L, przepływów pieniężnych, stanu środków, statystyki i retencji klientów
Każde narzędzie korzysta ze stałego adresu API wybranego podczas jego tworzenia. Dzięki temu asystent ma dostęp do sprawdzonej listy danych, a nie do wszystkiego, o co postanowi zapytać.
Serwer tylko odczytuje. Żadne narzędzie niczego nie tworzy, nie edytuje, nie anuluje ani nie usuwa: nie rezerwuje wizyt, nie zmienia cen, nie dodaje klientów. Każde narzędzie jest oznaczone jako readOnlyHint: true.
Asystent nie widzi też więcej niż Ty. Serwer nie ma własnej autoryzacji: każde żądanie trafia do API Wlaunch w Twoim imieniu, z tymi samymi regułami dostępu do firm i uprawnień co w backoffice. Jeśli Twoje konto nie widzi wynagrodzeń oddziału, asystent też ich nie zobaczy.
Na serwerze są też 3 narzędzia ogólnego przeznaczenia do diagnostyki przez zespół Wlaunch, na przykład wlaunch_api_get. Na kontach klientów są one zablokowane: jeśli asystent spróbuje ich użyć, zobaczysz odmowę.
Kto może z niego korzystać
Serwer MCP jest częścią Licencji rozszerzonej, razem z integracjami API.
Licencja rozszerzona na stronie cen
Do połączenia potrzebujesz Licencji rozszerzonej i osobistego tokena dostępu, który wsparcie Wlaunch wydaje na prośbę. Jak go uzyskać, opisuje następny krok.
Krok 1:Poproś o token dostępu
Tokeny dostępu wydaje wsparcie Wlaunch. Skontaktuj się ze wsparciem i poproś o osobisty token dostępu do swojego konta Wlaunch.
Poproś wsparcie Wlaunch o token
Wsparcie prześle Ci token. W każdym przykładzie poniżej zastąp nim <access_token>.
Krok 2:Podłącz klienta AI
Serwer działa w protokole MCP przez Streamable HTTP i oczekuje tokena w standardowym nagłówku Bearer w każdym żądaniu:
Authorization: Bearer <access_token>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, a usuń go poleceniem claude mcp remove wlaunch. 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.
Codex CLI
Gdy token jest już w zmiennej środowiskowej WLAUNCH_MCP_TOKEN, dodaj serwer:
codex mcp add wlaunch \
--url https://mcp.wlaunch.net/mcp \
--bearer-token-env-var WLAUNCH_MCP_TOKENAlbo dodaj go w ~/.codex/config.toml:
[mcp_servers.wlaunch]
url = "https://mcp.wlaunch.net/mcp"
bearer_token_env_var = "WLAUNCH_MCP_TOKEN"bearer_token_env_var zawiera nie sam token, lecz nazwę zmiennej środowiskowej: Codex odczytuje ją przy połączeniu i wysyła Authorization: Bearer <access_token>. Wybieraj ten sposób zamiast zapisywania tokena w pliku. To jedyny klient tutaj, który trzyma token poza konfiguracją i logami: wczytuj token do zmiennej środowiskowej z menedżera sekretów lub systemowego pęku kluczy, a nie zapisuj go otwartym tekstem w profilu powłoki ani w repozytorium.
Istnieją też http_headers (stała wartość) i env_http_headers (wartość ze zmiennej środowiskowej), ale ten serwer odczytuje tylko nagłówek Authorization, więc używaj bearer_token_env_var.
Claude Desktop
Dodaj serwer jako własny łącznik. Token wpisuje się w sekcji Request headers okna Add custom connector.
Anthropic udostępnia Request headers w wersji beta ograniczonej grupie organizacji. Jeśli w Twoim oknie nie ma sekcji Request headers, Twoje konto jeszcze jej nie otrzymało i Claude Desktop nie przekaże temu serwerowi Twojego tokena: połącz się przez Claude Code.
W planach Team i Enterprise własny łącznik może dodać tylko właściciel (Owner) w Organization settings → Connectors, a zapisany tam nagłówek jest jednym poświadczeniem wspólnym dla całej organizacji. To przeczy zasadzie jednego tokena na osobę, więc w tych planach łącz się przez Claude Code.
Kolejność poniższych kroków ma znaczenie: najpierw ustaw uwierzytelnianie, potem nagłówek.
- Otwórz Customize → Connectors i naciśnij Add custom connector.
- Wpisz
Wlaunchw polu Name (ta nazwa pojawi się na liście łączników) ihttps://mcp.wlaunch.net/mcpw polu URL, a potem naciśnij Continue. - W sekcji Authentication wybierz No sign-in. Okno może wykryć Sign in now i zaznaczyć tę opcję samo: nie przyjmuj jej. Serwer nie publikuje metadanych OAuth discovery (każdy adres
/.well-known/oauth-*zwraca404), więc logowanie nie znajdzie serwera autoryzacji i zakończy się błędem. Po wybraniu No sign-in sekcja OAuth client przestaje mieć znaczenie. - W sekcji Request headers naciśnij Add header. Nazwę nagłówka wybiera się z listy: wybierz
authorizationi wpisz wartośćBearer <access_token>. Zostaw zaznaczone Required. Podaj schematBearerw wartości: sam token bez niego zostanie odrzucony. Serwer nie odczytuje innych nazw nagłówków, więcx-api-keyi pozostałe zostaną zignorowane. - Naciśnij Add. Okno zapisuje wartości nagłówków i nie pokazuje ich ponownie, więc przechowuj token tam, skąd możesz go odzyskać.
Jeśli authorization jest na liście nieaktywny, nadal masz wybrane Sign in now. W tym trybie Claude sam wypełnia ten nagłówek i nie pozwala go zmienić. Wróć, wybierz No sign-in i otwórz listę ponownie.
Po połączeniu strona łącznika pokazuje sekcję Tool permissions: 28 narzędzi tylko do odczytu, łącznie z narzędziami diagnostycznymi. Dla każdego można wybrać Always allow, Needs approval, Blocked lub Custom, pojedynczo albo dla całej grupy naraz. Wszystkie narzędzia tylko odczytują, ale ich wyniki zawierają tekst wpisany przez Twoich klientów, na przykład imiona i komentarze, a taki tekst może zawierać polecenia dla asystenta. Wybieraj Always allow tylko wtedy, gdy ten asystent nie ma narzędzi, które mogą wysyłać dane na zewnątrz; w przeciwnym razie zostaw Needs approval, przynajmniej dla wlaunch_api_get.
Aplikacja ChatGPT
W aplikacji ChatGPT własne łączniki znajdują się w Settings → Connectors, w planach, które oferują Developer Mode. Dodaj serwer, podając jego adres:
https://mcp.wlaunch.net/mcpOkno łączników ChatGPT jest zbudowane wokół OAuth lub pracy bez uwierzytelniania, a ten serwer wymaga stałego tokena Bearer. Jeśli okno nie daje pola na własny nagłówek, takie połączenie nie jest obsługiwane, a działającą drogą jest Responses API opisane niżej. Nie udało nam się potwierdzić, jak zachowuje się obecna wersja okna, więc spróbuj aplikacji, a jeśli się nie uda, skorzystaj z API.
ChatGPT: Responses API
Responses API od OpenAI przyjmuje serwer MCP jako narzędzie i pozwala ustawić nagłówki, a tego właśnie potrzebuje ten serwer. Gdy token jest w zmiennej środowiskowej WLAUNCH_MCP_TOKEN, wyślij żądanie:
curl https://api.openai.com/v1/responses \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d @- <<EOF
{
"model": "gpt-5",
"tools": [{
"type": "mcp",
"server_label": "wlaunch",
"server_url": "https://mcp.wlaunch.net/mcp",
"headers": { "Authorization": "Bearer $WLAUNCH_MCP_TOKEN" }
}],
"input": "What companies can this integration see?"
}
EOFrequire_approval decyduje, czy model czeka na Twoje potwierdzenie przed każdym wywołaniem narzędzia. Przykład go pomija, więc każde wywołanie czeka na Twoje potwierdzenie. Wartość "never" to opcja tylko dla asystenta bez narzędzi, które mogą wysyłać dane na zewnątrz: wyniki narzędzi zawierają tekst wpisany przez Twoich klientów, na przykład imiona i komentarze, a taki tekst może zawierać polecenia dla modelu.
W tym nagłówku Twój token Wlaunch trafia do OpenAI. To ta sama decyzja o zaufaniu co wklejenie go do dowolnego asystenta w chmurze.
Dowolny inny klient MCP
Użyj transportu Streamable HTTP, adresu https://mcp.wlaunch.net/mcp i nagłówka Authorization. W protokole nie ma niczego specyficznego dla Wlaunch, więc zadziała każdy klient, który obsługuje MCP przez HTTP i pozwala ustawić nagłówek.
Krok 3:Sprawdź, czy działa
Zapytaj asystenta:
Jakie firmy widzi ta integracja?
Asystent powinien wywołać wlaunch_company_context bez argumentów i wymienić Twoje firmy. To jedyne narzędzie, które nie wymaga identyfikatora firmy, i od niego zaczyna się każde inne pytanie: zwraca też słownik Twojej firmy (statusy wizyt, oddziały, tagi, typy operacji finansowych), którego pozostałe narzędzia potrzebują, aby odpowiadać poprawnie.
Potem zadaj prawdziwe pytanie:
Ile wizyt zostało zakończonych w naszym głównym oddziale w zeszłym miesiącu?
O co możesz zapytać
Najlepiej działają pytania, które zadałbyś menedżerowi, a nie te, które wpisałbyś do bazy danych:
- Którzy klienci nie umówili się na wizytę od marca?
- Jaki był nasz przychód w zeszłym miesiącu w podziale na usługi?
- Pokaż grafik oddziału w Kijowie na przyszły wtorek.
- Klientka mówi, że nie dostała przypomnienia. Co się stało?
- Jakie wyniki miał każdy specjalista w pierwszej połowie czerwca?
Asystent zwykle najpierw czyta słownik Twojej firmy, a dopiero potem wykonuje inne zapytania.
Limity
Limity żądań
Limity liczy się według wywołań narzędzi, osobno dla każdego użytkownika i każdej firmy, a łącznie dla wszystkich firm użytkownika są ograniczone do wartości 3 razy większej.
| Grupa limitów | Limit | Narzędzia |
|---|---|---|
general | 60 wywołań na 5 minut | Wszystkie pozostałe narzędzia |
expensive | 10 wywołań na 5 minut | reports_*, statistics_*, retention_*, clients_segment |
Po przekroczeniu limitu nie dostaniesz HTTP 429 i nie będzie nagłówka Retry-After. Wywołanie narzędzia kończy się sukcesem na poziomie protokołu i zwraca błąd, który podaje grupę, limit i czas oczekiwania:
{
"error": "rate_limited",
"message": "Rate limit reached for expensive tools: 10 calls per window.",
"guidance": "Wait 47 seconds before calling this tool again. …",
"metadata": { "bucket": "expensive", "limit": 10, "resetInMs": 47000 }
}Rozmiar strony i duże odpowiedzi
Domyślnie strona zawiera 20 rekordów, maksymalnie 100: to limit samego API Wlaunch.
Duże odpowiedzi są skracane o całe wiersze, nigdy przez ucięcie wiersza w połowie. Odpowiedź wtedy o tym informuje, a total pozostaje dokładne, więc liczbie można ufać, nawet gdy lista jest niepełna. Jeśli potrzebujesz tylko liczby, kosztuje to jedno wywołanie z size: 1.
Rozwiązywanie problemów
Połączenie odrzucone z HTTP 401
Treść odpowiedzi i nagłówek WWW-Authenticate zawierają kod do odczytu maszynowego. Czytaj kod, a nie tekst: opis dla ludzi jest celowo taki sam w każdym przypadku, aby ktoś, kto sonduje adres, nie dowiedział się, która część jego próby była błędna.
| Kod | Co to oznacza | Co zrobić |
|---|---|---|
invalid_request | Brak nagłówka Authorization albo ma on nieprawidłowy format. | Dodaj nagłówek w formacie Bearer <access_token>. |
invalid_token | Nagłówek ma poprawny format, ale token został odrzucony lub nie jest już ważny. | Poproś wsparcie Wlaunch o nowy token i zaktualizuj konfigurację klienta. |
Narzędzie zwraca błąd zamiast odpowiedzi
Takie błędy przychodzą jako zwykły wynik narzędzia z polem error, a nie jako błąd HTTP:
| Kod | Co to oznacza |
|---|---|
plan_restricted | Twoja licencja nie obejmuje tej funkcji. To nie to samo co brak danych: liczba jest nieznana, a nie zerowa. |
forbidden | Twoje konto Wlaunch nie ma uprawnień do tej firmy lub zasobu. |
not_found | Taki identyfikator nie istnieje albo nie jest dla Ciebie widoczny. |
validation | Asystent przesłał błędny argument. Powinien się poprawić i spróbować ponownie. |
rate_limited | Osiągnięto limit żądań. Zobacz limity powyżej. |
upstream | API Wlaunch jest niedostępne lub nie odpowiedziało na czas. Spróbuj ponownie za chwilę. |
Unieważniony token może działać jeszcze do minuty
Serwer przechowuje w pamięci podręcznej wynik weryfikacji tokena przez 60 sekund. Jeśli token unieważniono, wywołania mogą przechodzić jeszcze przez maksymalnie minutę. Nowo wydany token działa od razu.
Informacje techniczne
- Adres MCP
https://mcp.wlaunch.net/mcp- Transport
Streamable HTTP- Uwierzytelnianie
Bearer <access_token>w nagłówkuAuthorization, jedynym nagłówku, który odczytuje serwer- Token dostępu
- Osobisty, wydawany na prośbę przez wsparcie Wlaunch
- Metadane OAuth discovery
- Brak:
/.well-known/oauth-*zwraca404 - Pamięć podręczna weryfikacji tokena
- 60 sekund
- Dostęp
- Tylko odczyt, każde narzędzie oznaczone
readOnlyHint: true - Narzędzia
- 25
Mniej rutyny, większy przychód
Rezerwacje, płatności, magazyn i wynagrodzenia w jednym systemie
Wypróbuj za darmo