WebFlux Słownik Agentic Web jest teraz MCP serverem — agent może go zapytać bezpośrednio

przez Łukasz | kwi 23, 2026

Dziś webflux.pl stał się jednym z pierwszych polskich serwisów które wystawiają swoją wiedzę jako MCP server.

Słownik Webflux Agentic Web — pojęcia z definicjami, polskimi nazwami, wariantami i klastrami tematycznymi — jest teraz dostępny nie tylko jako strona internetowa, ale jako narzędzie które agent AI może wywołać bezpośrednio.

Bez scrapowania. Bez parsowania HTML. Bez zgadywania struktury.

Co to znaczy w praktyce

Wyobraź sobie agenta który dostaje zadanie: „wyjaśnij mi różnicę między MCP a WebMCP w kontekście agent-readiness”.

Bez MCP server: agent odwiedza webflux.pl, parsuje HTML, wyciąga treść ze słownika, przetwarza, odpowiada. Kilka requestów, dużo tokenów na HTML który nie wnosi nic do treści.

Z MCP server: agent wywołuje narzędzie search_term z zapytaniem „MCP”, dostaje ustrukturyzowany JSON z definicjami, polskimi nazwami i linkami do pełnych artykułów. Jeden request, zero HTMLa, czyste dane.

To jest właśnie ten kierunek w którym zmierza web — od stron które ludzie czytają, do endpointów które agenci wywołują.

Jak to działa technicznie

Endpoint MCP WebFlux jest dostępny pod:

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

Protokół: MCP 2024-11-05 (JSON-RPC 2.0) — ten sam standard który używa Claude, ChatGPT i Gemini do komunikacji z zewnętrznymi narzędziami.

Cztery narzędzia dostępne dla agentów:

search_term — szukaj pojęcia po nazwie, polskim odpowiedniku lub wariancie:

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_term",
    "arguments": { "query": "MCP" }
  }
}

Odpowiedź:

json
{
  "result": {
    "content": [{
      "type": "text",
      "text": "Znaleziono 2 pojęć:\n\n**WebMCP** (Protokoły i standardy)\n..."
    }]
  }
}

get_term — pełna definicja po slugu:

json
{ "name": "get_term", "arguments": { "slug": "mcp-model-context-protocol" } }

list_clusters — lista wszystkich klastrów tematycznych z liczbą pojęć.

get_cluster — wszystkie pojęcia z danego klastra:

json
{ "name": "get_cluster", "arguments": { "cluster": "Protokoły i standardy" } }

Dlaczego to ważne dla WebFlux

Przez ostatnie tygodnie budowaliśmy infrastrukturę agent-ready — nagłówek rel="service-doc", stronę /dla-agentow, Markdown for Agents, Content Signals w robots.txt.

MCP server to kolejny poziom tej samej filozofii.

Dotychczas przygotowywaliśmy stronę na czytanie przez agentów. Teraz wystawiamy narzędzie dla agentów.

Różnica jest fundamentalna:

  • Agent który czyta stronę — pobiera HTML, parsuje, przetwarza
  • Agent który używa narzędzia — wywołuje funkcję, dostaje dane, działa

WebFlux Słownik Agentic Web jako MCP server oznacza że agent budujący wiedzę o agentic web może teraz bezpośrednio odpytać nasze definicje — tak jak programista odpytuje dokumentację przez API.

Dlaczego słownik jest dobrym kandydatem na MCP

Nie każda treść ma sens jako MCP server. Ma sens gdy:

Dane są ustrukturyzowane — słownik ma jasny schemat: term, definition, slug, cluster, warianty. Agent wie czego się spodziewać.

Zapytania są powtarzalne — „co to jest MCP”, „jakie protokoły handlu agentowego istnieją”, „co należy do klastra Tożsamość i zaufanie” — to są pytania które agenci będą zadawać wielokrotnie.

Treść jest unikatowa — 45 pojęć agentic web po polsku z pełnymi definicjami i kontekstem. Tego nie ma nigdzie indziej.

Wartość rośnie z czasem — słownik będzie się rozrastał. Każde nowe pojęcie automatycznie staje się dostępne przez MCP bez żadnych zmian w serwerze.

Jak dodać WebFlux MCP do swojego agenta

Dla deweloperów którzy budują agentów w Claude, ChatGPT lub własnych systemach — endpoint jest publiczny i nie wymaga autentykacji.

Konfiguracja w Claude Desktop (claude_desktop_config.json):

json
{
  "mcpServers": {
    "webflux-slownik": {
      "url": "https://webflux.pl/wp-json/webflux/v1/mcp",
      "transport": "http"
    }
  }
}

Test przez curl:

bash
# Lista narzędzi
curl -X POST https://webflux.pl/wp-json/webflux/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# 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":"agent-readiness"}}}'

Co dalej

MCP server słownika to początek, nie koniec.

Następne kroki które rozważamy:

Rejestracja w ekosystemie MCP — dodanie serwera do publicznych rejestrów MCP żeby agenci mogli go odkryć automatycznie przez /.well-known/agent-skills/.

Rozszerzenie o artykuły — nie tylko słownik ale też dostęp do pełnych artykułów WebFlux przez MCP. Agent pytający o „jak wdrożyć Markdown for Agents w WordPress” mógłby dostać bezpośrednio treść artykułu zamiast linku.

Wersjonowanie — gdy słownik urośnie do 100+ pojęć, warto będzie dodać filtrowanie po dacie aktualizacji żeby agenty wiedziały co jest nowe.

Słownik jest otwarty

WebFlux Słownik Agentic Web jest dostępny bezpłatnie — zarówno jako strona dla ludzi, jak i jako MCP server dla agentów.

45 pojęć, 7 klastrów tematycznych, pełne definicje z kontekstem, polskie nazwy i warianty.

Jeśli budujesz agenta który operuje w obszarze agentic web, agent-readiness lub handlu agentowego — masz teraz polskie źródło wiedzy które możesz wywołać bezpośrednio.

https://webflux.pl/wp-json/webflux/v1/mcp
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...