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