Jak podłączyć WebFlux Słownik Agentic Web do Claude Desktop przez MCP

przez Łukasz | kwi 24, 2026

W poprzednim artykule opisałem jak wystawiliśmy Słownik Agentic Web WebFlux jako MCP server. Teraz praktycznie — jak go podłączyć do Claude Desktop i sprawdzić czy działa.

Co potrzebujesz

  • Claude Desktop (Mac lub Windows)
  • Plan Pro lub wyższy — Connectors nie są dostępne na planie Free
  • 3 minuty

Krok 1 — Otwórz ustawienia Connectors

W Claude Desktop kliknij SettingsConnectorsAdd connector.

Pojawi się formularz z polami na URL i opcjonalne dane autentykacji.

Krok 2 — Wklej URL endpointu

https://webflux.pl/wp-json/webflux/v1/mcp

Autentykacja: brak — endpoint jest publiczny.

Kliknij Add i zatwierdź uprawnienia gdy Claude zapyta.

Krok 3 — Przetestuj

Otwórz nową rozmowę w Claude Desktop i zapytaj:

„Jakie protokoły handlu agentowego opisuje słownik WebFlux? Użyj dostępnych narzędzi.”

Claude powinien wywołać narzędzie get_cluster z parametrem Protokoły i standardy i zwrócić listę pojęć z definicjami.

Zobaczysz ikonkę narzędzia przy odpowiedzi — to znaczy że MCP działa.

Cztery narzędzia które masz po podłączeniu

search_term — szukaj pojęcia po nazwie lub wariancie:

„Co to jest agent hijacking?”

get_term — pełna definicja po slugu:

„Pobierz pełną definicję pojęcia mcp-model-context-protocol”

list_clusters — lista wszystkich klastrów tematycznych:

„Jakie klastry tematyczne ma słownik WebFlux?”

get_cluster — wszystkie pojęcia z klastra:

„Pokaż mi wszystkie pojęcia z klastra Tożsamość i zaufanie”

Co nie działa

ChatGPT Plus — custom MCP serverów nie można dodać na planie osobistym. Wymaga Business lub Enterprise.

Claude Free — Connectors są dostępne tylko na planach płatnych.

Dla deweloperów — test przez curl

Jeśli chcesz sprawdzić endpoint bez żadnego narzędzia:

bash
# Co umie ten serwer?
curl https://webflux.pl/wp-json/webflux/v1/mcp

# Szukaj pojęcia
curl -X POST https://webflux.pl/wp-json/webflux/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_term","arguments":{"query":"MCP"}}}'

Słownik cały czas rośnie, tak jak rozwija się tematyka agentic web. Każde nowe pojęcie pojawia się automatycznie w MCP server — bez żadnych zmian w konfiguracji po Twojej stronie.

Agent kończy, ale zadania nie wykonał

Agent kończy, ale zadania nie wykonał

Objawy Agent odpowiada: „Przygotowałem i wysłałem potwierdzenie do klienta." Potwierdzenie nie zostało wysłane. Albo: „Zaktualizowałem wszystkie rekordy" — zaktualizował trzy z dwunastu. Albo: „Nie znalazłem żadnych zamówień" — bo narzędzie zwróciło błąd, którego nikt...

Agent zrobił coś, o co nikt nie prosił

Agent zrobił coś, o co nikt nie prosił

Objawy Operacja, której nikt nie zlecił. Dane wysłane pod adres, którego nie ma w żadnej konfiguracji. Rekord zmieniony poza zakresem zadania. Odpowiedź, z której wynika, że agent dostał instrukcje od kogoś innego niż ty. Cecha wspólna: technicznie wszystko zadziałało...

Agent zrobił to samo dwa razy

Agent zrobił to samo dwa razy

Objawy Ten syndrom różni się od pozostałych jedną rzeczą: objaw widzi klient, nie ty. Trzy identyczne wiadomości w skrzynce. Dwa zamówienia zamiast jednego. Podwójne obciążenie. Duplikaty rekordów, które ktoś zauważa tydzień później. W twoim dzienniku wszystko wygląda...

Agent gubi wątek w długim zadaniu

Agent gubi wątek w długim zadaniu

Objawy Pierwsze kroki idą wzorowo. Po kilkunastu agent zaczyna się rozjeżdżać. Przestaje przestrzegać reguły z promptu systemowego, której trzymał się na początku. Zmienia format odpowiedzi w połowie zadania. Wraca do czegoś, co już ustalił, i ustala to inaczej....

Agent podaje dane, których nie ma

Agent podaje dane, których nie ma

Objawy Numer zamówienia w idealnym formacie, którego nie ma w bazie. Kwota, której w dokumencie nie ma. Nazwa pola API, które nigdy nie istniało. Cytat z regulaminu, brzmiący dokładnie jak reszta regulaminu i w nim nieobecny. Cecha wspólna wszystkich tych przypadków:...

Działał wczoraj, dziś nie działa

Działał wczoraj, dziś nie działa

Objawy Nic się nie wywala. Nie ma wyjątków, nie ma timeoutów, dziennik wygląda tak samo jak zawsze. Po prostu odpowiedzi są gorsze. Postacie, w jakich to się objawia: Jakość. Agent zaczyna pomijać kroki, które wcześniej wykonywał, albo odpowiada ogólniej. Format....

Agent wybiera złe narzędzie

Agent wybiera złe narzędzie

Objawy Agent odpowiada nie na to pytanie. Pobiera listę zamówień, gdy pytano o jedno konkretne. Odpowiada z pamięci, choć miał sprawdzić w bazie. Albo sięga po właściwe narzędzie i wpisuje w argumenty coś, czego nie da się użyć. Sygnał, który odróżnia ten syndrom od...

Agent kręci się w kółko

Agent kręci się w kółko

Objawy Agent wykonuje kolejne obroty pętli, nie zbliżając się do zakończenia zadania. W dzienniku widać jedną z trzech postaci. Powtórzenie. To samo narzędzie, te same argumenty, raz za razem — czasem dziesiątki razy pod rząd. Oscylacja. Agent wywołuje na przemian dwa...