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

Wersja Markdown (po angielsku)

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.

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.

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:

Nagłówek HTTP
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:

Terminal
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:

Terminal
codex mcp add wlaunch \
  --url https://mcp.wlaunch.net/mcp \
  --bearer-token-env-var WLAUNCH_MCP_TOKEN

Albo dodaj go w ~/.codex/config.toml:

~/.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.

  1. Otwórz Customize → Connectors i naciśnij Add custom connector.
  2. Wpisz Wlaunch w polu Name (ta nazwa pojawi się na liście łączników) 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 wykryć Sign in now i zaznaczyć tę opcję samo: nie przyjmuj jej. Serwer nie publikuje metadanych OAuth discovery (każdy adres /.well-known/oauth-* zwraca 404), więc logowanie nie znajdzie serwera autoryzacji i zakończy się błędem. Po wybraniu No sign-in sekcja OAuth client przestaje mieć znaczenie.
  4. W sekcji Request headers naciśnij Add header. Nazwę nagłówka wybiera się z listy: wybierz authorization i wpisz wartość Bearer <access_token>. Zostaw zaznaczone Required. Podaj schemat Bearer w wartości: sam token bez niego zostanie odrzucony. Serwer nie odczytuje innych nazw nagłówków, więc x-api-key i pozostałe zostaną zignorowane.
  5. 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:

Adres serwera
https://mcp.wlaunch.net/mcp

Okno łą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:

Terminal
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?"
}
EOF

require_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ówLimitNarzędzia
general60 wywołań na 5 minutWszystkie pozostałe narzędzia
expensive10 wywołań na 5 minutreports_*, 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:

Wynik narzędzia
{
  "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.

KodCo to oznaczaCo zrobić
invalid_requestBrak nagłówka Authorization albo ma on nieprawidłowy format.Dodaj nagłówek w formacie Bearer <access_token>.
invalid_tokenNagłó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:

KodCo to oznacza
plan_restrictedTwoja licencja nie obejmuje tej funkcji. To nie to samo co brak danych: liczba jest nieznana, a nie zerowa.
forbiddenTwoje konto Wlaunch nie ma uprawnień do tej firmy lub zasobu.
not_foundTaki identyfikator nie istnieje albo nie jest dla Ciebie widoczny.
validationAsystent przesłał błędny argument. Powinien się poprawić i spróbować ponownie.
rate_limitedOsiągnięto limit żądań. Zobacz limity powyżej.
upstreamAPI 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łówku Authorization, 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-* zwraca 404
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