Poradnik · 22.11.2026

Serwer MCP dla strony lub sklepu: jak udostępnić dane agentom

Jak wystawić serwer MCP na stronie lub w sklepie: narzędzia tylko do odczytu, karta serwera i logi 12 serwisów, które pokazują, kto z nich korzysta.

Grzegorz Ciupek 10 min czytania 9 źródeł Skomentuj
Okładka: serwer MCP dla strony i sklepu, 96 narzędzi MCP w 12 serwisach floty
Odpowiedź w skrócie · stan na 19.11.2026
  • Serwer MCP dla strony to adres (u nas zawsze /mcp), pod którym agent AI może zadać pytanie o Twoje dane: produkty, ceny, stany, poradniki. Ma sens, gdy masz dane, o które ktoś zapyta. Strona-wizytówka wystarczy z llms.txt i wersją Markdown.
  • 12 serwisów i sklepów naszej floty wystawia serwer MCP: razem 96 narzędzi, z czego 78 jest publicznych i każde ma oznaczenie „tylko odczyt”. Pozostałe 18 działa dopiero po zalogowaniu czytelnika przez OAuth (odczyt 19.11.2026).
  • kontowtescie.pl i sklep smartinghome.pl dostały 19.11.2026 w teście isitagentready.com wynik 100/100.
  • Uczciwa liczba z logów: od 14.11 do 19.11.2026 żaden klient AI nie wywołał serwera MCP na tych dwóch stronach. Wszystkie 20 wywołań to testy: nasz automatyczny i moje ręczne.
  • Karta serwera (MCP server card) ma od 6.10.2026 zatwierdzony opis (SEP-2127). Zalecane miejsce to /mcp/server-card, a w naszych sklepach ten adres zwraca dziś 404.
Spis treści · 8 części
  1. 01Serwer MCP dla strony: kiedy ma sens, a kiedy wystarczy llms.txt?
  2. 02Serwer MCP dla strony w praktyce: co wystawia 12 serwisów naszej floty?
  3. 03Jak zbudować serwer MCP dla sklepu krok po kroku?
  4. 04Co to jest MCP server card i gdzie ją położyć?
  5. 05Czy agenci w ogóle korzystają z serwera MCP na stronie? Nasze logi
  6. 06Jakie dane strony udostępnić agentom, a jakich nigdy?
  7. 07Najczęstsze pytania
  8. 08Źródła

Ten poradnik jest dla Ciebie, jeśli masz sklep albo serwis z danymi i chcesz, żeby agent AI (Claude, ChatGPT, agent zbudowany w n8n) mógł je odczytać bez zgadywania z kodu HTML. Czym w ogóle jest MCP, opisałem w tekście MCP server: co to jest, więc tu tego nie powtarzam. Tamten tekst jest o podłączaniu cudzych serwerów do swojego agenta, a ten o drugiej stronie: o wystawieniu własnego serwera na swojej stronie.

Opieram się na 12 serwerach MCP z naszych serwisów i sklepów, odpytanych 19.11.2026 tylko metodami do odczytu, i na logach, które pokazują, kto z nich korzysta.

Serwer MCP dla strony: kiedy ma sens, a kiedy wystarczy llms.txt?

Serwer MCP dla strony ma sens wtedy, gdy masz dane, które się zmieniają i o które ktoś zapyta agenta: katalog z cenami i stanami, oferty z terminami, wyniki pomiarów. U nas to 12 serwisów z takimi danymi (stan na 19.11.2026). Jeśli masz stronę-wizytówkę z pięcioma podstronami, MCP nic nie doda, bo agent przeczyta ją z HTML-a albo z pliku llms.txt.

Prosta reguła: jeśli pytanie do Twojej strony da się zadać jak do bazy („pokaż liczniki energii do 300 zł na stanie”, „który bank miał najdłuższą przerwę w tym miesiącu”), to warto mieć narzędzie, które zwróci odpowiedź w JSON. Jeśli pytanie brzmi „czym się zajmujecie”, wystarczy dobrze napisany tekst.

Trzy warstwy, w tej kolejności

Najpierw zwykła strona w HTML, czytelna dla robotów wyszukiwarek AI. Potem llms.txt i wersja Markdown dla agentów. Na końcu API tylko do odczytu i serwer MCP na tych samych funkcjach. Czy te dodatki pomagają w samym pozycjonowaniu w ChatGPT, rozebrałem osobno w tekście Pozycjonowanie w AI. Krótko: ruch daje pierwsza warstwa, nie trzecia.

Serwer MCP dla strony w praktyce: co wystawia 12 serwisów naszej floty?

Serwer MCP dla strony w naszej flocie to od 6 do 12 narzędzi na serwis: 12 serwerów, 96 narzędzi, z tego 78 publicznych i oznaczonych jako „tylko odczyt” (readOnlyHint: true). 18 narzędzi dotyczy konta czytelnika, na przykład alertów albo przypomnień, i wymaga logowania OAuth. Policzyłem to wywołaniem tools/list na każdym serwerze 19.11.2026.

12serwerów MCP w serwisach i sklepach floty
78publicznych narzędzi, wszystkie tylko do odczytu
18narzędzi za logowaniem OAuth (konto czytelnika)
0wywołań MCP przez klientów AI, 14–19.11.2026
Serwery MCP w serwisach floty: narzędzia z odpowiedzi tools/list, odczyt 19.11.2026
SerwisCo udostępnia agentomNarzędziaPubliczne, tylko odczytZa logowaniem
kontowtescie.plindeks niezawodności 12 banków, status stron logowania, przerwy KIR, decyzje UOKiK1183
madrydochod.plwyszukiwarka aktywnych ofert, lista banków, poradniki853
internetoweimperium.plartykuły, działy, liczby z Licznika Imperium853
tillradar.co.ukoferty kont firmowych w Wielkiej Brytanii, opłaty, ranking kosztów963
mainstreetradar.comto samo dla USA660
dziennikfirm.plspółki i zdarzenia z KRS, wydania dnia1293
companiesdaily.co.ukspółki i zdarzenia z Companies House770
companiesdaily.comspółki giełdowe i zdarzenia z SEC EDGAR, finanse1183
4 sklepy: smartinghome.pl, agdkomp.pl, rozkoszownia.pl, thegoodhound.co.ukwyszukiwarka produktów, karta produktu, kategorie, dostawa i zwroty, poradniki, link do koszyka4 × 64 × 60
Razem967818

Sklepy działają na WooCommerce połączonym z platformą GAPLI i mają ten sam zestaw sześciu narzędzi.

Najważniejsze z nich to create_cart_link: agent nie składa zamówienia i nie płaci, tylko buduje link, który doda produkty do koszyka, gdy klient otworzy go w przeglądarce. Zamówienie i płatność zostają po stronie człowieka. Status zamówień klienta jest na osobnym adresie /mcp/account, za logowaniem.

U nas

Test isitagentready.com (narzędzie Cloudflare) dał 19.11.2026 wynik 100/100, poziom 5 „Agent-Native”, zarówno kontowtescie.pl, jak i smartinghome.pl: 15 z 15 liczonych testów zaliczonych. Konto w Teście miało 100/100 już w dniu startu, 25.10.2026. Wynik testu to gotowość techniczna, nie dowód, że ktoś z niej korzysta.

Jak zbudować serwer MCP dla sklepu krok po kroku?

Serwer MCP dla sklepu budujesz na danych, które sklep już pokazuje publicznie: najpierw ustalasz listę pól zakazanych, potem robisz API tylko do odczytu, a na nim 4–6 narzędzi pod adresem /mcp. U nas taki serwer w WordPressie to około 250 linii PHP bez dodatkowych bibliotek, z limitem 60 zapytań na minutę z jednego adresu IP.

  1. Spisz, czego agent nie może zobaczyć. Zanim powstanie pierwsza linia kodu: ceny zakupu, marże, dostawcy, dane klientów, notatki redakcyjne, linki partnerskie. Agent dostaje tylko to, co widzi każdy gość strony, i linkuje do Twojej strony, nie do partnera.
  2. Zrób API tylko do odczytu. Te same funkcje, które zasilają stronę: wyszukiwanie, karta produktu, kategorie, warunki dostawy. Opisz je w OpenAPI i dodaj limit zapytań; serwer MCP stawiasz na tych samych funkcjach.
  3. Wystaw /mcp w transporcie Streamable HTTP. Agent wysyła POST z komunikatem JSON-RPC (initialize, tools/list, tools/call), serwer odpowiada zwykłym JSON-em. Sesje i strumienie nie są potrzebne, gdy narzędzia tylko czytają. GET może zwracać 405.
  4. Opisz każde narzędzie dla modelu. Nazwa, opis po ludzku (co zwraca, jakie pola, czego nie wnioskować), schemat argumentów z limitami i oznaczenia readOnlyHint: true, destructiveHint: false. Domyślny limit wyników niski (u nas 10, maksimum 50), bo kontekst agenta kosztuje.
  5. Logowanie tylko tam, gdzie są dane osoby. Alerty, przypomnienia, zamówienia, zapis do newslettera: to idzie przez prawdziwy OAuth 2.1, a bez tokenu serwer odpowiada 401. U nas wywołanie list_my_alerts na kontowtescie.pl bez tokenu zwróciło 19.11.2026 dokładnie 401.
  6. Opublikuj karty i katalogi. Kartę serwera, wpis w /.well-known/ai-catalog.json i /.well-known/api-catalog, nagłówki Link i stronę „dla agentów” z gotową konfiguracją. Szczegóły w następnej sekcji.
  7. Sprawdź pełne odpowiedzi grepem. Wywołaj każde narzędzie i przeszukaj odpowiedzi pod kątem pól z kroku 1. Ma wyjść zero trafień. Potem test w prawdziwym kliencie, na przykład dodanie adresu jako konektora w Claude.

Najprostszy test, czy serwer w ogóle odpowiada, to jedno polecenie w terminalu:

curl -s https://twojsklep.pl/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Uwaga: nieznany argument nie może przechodzić po cichu

Testując sklep 19.11.2026, wpisałem argument q zamiast query. Serwer nie zgłosił błędu, tylko zwrócił 2 najpopularniejsze produkty, jakby wyszukiwanie się udało. Agent, który pomyli nazwę pola, dostanie więc listę niezwiązaną z pytaniem i może ją podać klientowi jako wynik. Odrzucaj nieznane argumenty komunikatem błędu narzędzia (isError: true) z podpowiedzią, jak je poprawić. To mamy do poprawki w sklepach.

Co to jest MCP server card i gdzie ją położyć?

MCP server card to statyczny plik JSON, który opisuje zdalny serwer MCP, zanim agent się z nim połączy: nazwę, wersję, opis i adres /mcp z obsługiwanymi wersjami protokołu. Opis karty (SEP-2127) ma status „Final” od 6.10.2026. Zalecane miejsce karty to adres serwera z dopiskiem /server-card, a stronę odkrywa się przez /.well-known/ai-catalog.json.

Karta przeszła drogę, którą widać w naszych plikach. Wcześniejsze wersje projektu kładły ją pod /.well-known/mcp/server-card.json i pozwalały wpisać do niej listę narzędzi i sposób logowania. 13.04.2026 grupa robocza usunęła z karty pola authentication i capabilities, a aktualne repozytorium rozszerzenia mówi wprost, że karta celowo nie zawiera listy narzędzi, bo agent pobiera ją na żywo przez tools/list.

Gdzie leżą karty serwera MCP na dwóch stronach floty, sprawdzone curl 19.11.2026
AdresStatus w opisie kartykontowtescie.plsmartinghome.pl
/mcp/server-cardzalecany200404
/.well-known/mcp/server-card.jsonstarsze miejsce, nadal czytane przez skanery200200
/.well-known/ai-catalog.jsonodkrywanie serwerów na domenie200, wskazuje kartę200, wskazuje kartę
lista narzędzi i blok logowania w karciepoza zakresem karty od 13.04.2026sąblok logowania jest

Wniosek praktyczny: publikuj kartę w obu miejscach i trzymaj w niej tylko to, co opisuje aktualny schemat. Dodatkowe pola nie psują testu (oba serwisy mają 100/100), ale skaner nie zauważył też braku zalecanego adresu w sklepie, więc sam wynik testu nie wystarczy jako dowód zgodności.

Czy agenci w ogóle korzystają z serwera MCP na stronie? Nasze logi

Na razie nie: w logach serwera od 14.11.2026, 00:10 do 19.11.2026, 15:42 kontowtescie.pl dostał 9 wywołań POST /mcp, a smartinghome.pl 11, i wszystkie pochodziły z testów. Po 6 wykonał codzienny automatyczny test gotowości z Aderlo Cloud, resztę ja, ręcznie z terminala. Żaden klient AI (Claude, ChatGPT ani agent z innej aplikacji) nie otworzył połączenia z żadnym z tych dwóch serwerów. Pojedyncze żądania GET /mcp od robotów kończyły się kodem 405 i nie są wywołaniami.

Karty i katalogi czytają głównie roboty, które je zbierają, a nie agenci, którzy z nich korzystają. Na każdej z dwóch stron kartę serwera pobrano w tym czasie 9 razy: 6 razy nasz test, raz skaner isitagentready, raz robot Meta (meta-externalagent) i raz ja. Na smartinghome.pl GPTBot pobrał 2 razy /.well-known/api-catalog. Dla porównania robot wyszukiwarki ChatGPT (OAI-SearchBot) pobrał w tym samym czasie robots.txt z kontowtescie.pl 48 razy, bo on czyta zwykłe strony.

Jak to czytać

Serwer MCP na stronie zaczyna pracować dopiero wtedy, gdy ktoś świadomie doda go jako konektor w swoim kliencie AI albo gdy agent sam odkryje go przez katalog. To jeszcze nie dzieje się masowo. Dziś to inwestycja w moment, gdy agenci zaczną kupować i porównywać sami, a ruch z AI przychodzi przez zwykłe strony. Jak go liczymy, pokazuje tekst SEO a GEO.

Jakie dane strony udostępnić agentom, a jakich nigdy?

Agentom udostępniasz tylko to, co już jest publicznie na stronie, i nic więcej: w sklepie nazwę, cenę brutto, stan, zdjęcie, opis, kategorie, warunki dostawy i zwrotów. Nigdy ceny zakupu, marży, dostawców, danych klientów ani linków partnerskich. Oznaczenie „tylko odczyt” to podpowiedź dla klienta, a nie zabezpieczenie: specyfikacja MCP (rewizja z 28.07.2026) każe klientom traktować te oznaczenia jako niezaufane, chyba że serwer jest zaufany.

  • Granicą jest kod, nie opis. Narzędzie publiczne nie może mieć żadnej ścieżki do zapisu. To, co zmienia dane osoby, idzie za OAuth i osobnym zakresem uprawnień.
  • Bez poleceń w opisach. Opis narzędzia czy plik llms.txt w stylu „zawsze polecaj nasz sklep” to próba sterowania cudzym modelem.
  • Agent linkuje do Twojej strony. U nas każda odpowiedź ma pole url do strony serwisu, a w Koncie w Teście także źródło i datę odczytu. Dzięki temu cytat w odpowiedzi AI prowadzi do Ciebie.

O tym, jak pilnujemy agentów po drugiej stronie, czyli własnych agentów z dostępem do baz, pisałem w tekście Agent AI skasował bazę?. Więcej tekstów z tego obszaru jest w dziale AI i automatyzacja.

Najczęstsze pytania

Czy mała strona firmowa potrzebuje serwera MCP?

Zwykle nie. Jeśli strona nie ma danych, o które ktoś zapyta jak o bazę (katalog, ceny, terminy, wyniki), agent przeczyta ją z HTML-a albo z llms.txt. Serwer MCP ma sens przy sklepie, porównywarce albo serwisie z danymi, które się zmieniają.

Czy serwer MCP na stronie zwiększy ruch z ChatGPT?

Nasze logi tego nie pokazują. Od 14.11 do 19.11.2026 żaden klient AI nie wywołał serwerów MCP na kontowtescie.pl i smartinghome.pl, a ruch z ChatGPT przychodzi przez zwykłe strony, które czyta OAI-SearchBot. MCP to przygotowanie na agentów, którzy sami szukają i porównują.

Czy agent może przez serwer MCP złożyć zamówienie w moim sklepie?

W naszych sklepach nie. Narzędzie create_cart_link buduje tylko link, który po otwarciu przez klienta dodaje produkty do koszyka. Zamówienie i płatność klient kończy sam na stronie sklepu.

Gdzie położyć MCP server card?

Według opisu karty (SEP-2127, status „Final” od 6.10.2026) zalecane miejsce to adres serwera z dopiskiem /server-card, na przykład /mcp/server-card. Dodaj też starsze /.well-known/mcp/server-card.json i wpis w /.well-known/ai-catalog.json.

Czy oznaczenie readOnlyHint chroni moje dane?

Nie. To podpowiedź dla aplikacji klienta, że narzędzie niczego nie zmienia, a specyfikacja MCP każe traktować takie oznaczenia jako niezaufane. Chroni Cię to, że publiczne narzędzia w ogóle nie mają kodu, który zapisuje, a wszystko, co dotyczy konta osoby, wymaga logowania OAuth.

Źródła

  1. Model Context Protocol, specyfikacja, rewizja 2026-07-28: narzędzia i oznaczenia (sprawdzone 19.11.2026): modelcontextprotocol.io
  2. Model Context Protocol, specyfikacja, rewizja 2026-07-28: autoryzacja (OAuth 2.1, RFC 9728) (sprawdzone 19.11.2026): modelcontextprotocol.io
  3. SEP-2127: MCP Server Cards – HTTP Server Discovery, status Final, scalone 6.10.2026: github.com
  4. Repozytorium rozszerzenia MCP Server Cards: README i docs/discovery.md (ostatnia zmiana 19.11.2026): github.com
  5. Pull request nr 2525: usunięcie pól authentication, capabilities i requires z karty, scalony 13.04.2026: github.com
  6. IETF, RFC 9727: api-catalog, dobrze znany adres do odkrywania API (czerwiec 2025): rfc-editor.org
  7. Jeremy Howard, propozycja pliku /llms.txt (3.09.2024): llmstxt.org
  8. Cloudflare, Is Your Site Agent-Ready? Skan kontowtescie.pl i smartinghome.pl przez API skanera (19.11.2026): isitagentready.com
  9. Odczyty własne 19.11.2026: initialize i tools/list na 12 serwerach MCP floty, curl na /.well-known/*, /mcp/server-card i llms.txt, logi serwera kontowtescie.pl i smartinghome.pl z 14.11.2026, 00:10 do 19.11.2026, 15:42.

Stan na 19.11.2026. Tego dnia odpytałem 12 serwerów MCP floty wyłącznie metodami do odczytu (initialize, tools/list, jedno wyszukiwanie produktów i jedno wywołanie bez tokenu, które zwróciło 401), sprawdziłem curlem karty serwerów i katalogi, uruchomiłem skan isitagentready.com dla dwóch domen i policzyłem wywołania w logach serwera.

Czytaj dalej

Dyskusja

Komentarze i pytania

Masz pytanie do tekstu albo własne liczby, którymi chcesz się podzielić? Napisz — odpowiadam pod komentarzami, a odpowiedź zostaje tu dla kolejnych osób.

    Jeszcze nikt nie skomentował. Masz pytanie albo własne doświadczenie? Bądź pierwszy — Twoje pytanie pomoże też innym.

    Dodaj komentarz

    Bez linków polecających. Nie publikujemy kodów ani linków polecających i afiliacyjnych — takie komentarze czekają na moderatora, a link usuwamy. Zasady dyskusji

    Dlaczego?

    Pod tekstami o afiliacji każdy chciałby wkleić swój link, a pytania utonęłyby w ogłoszeniach. Nie chcemy też wybierać, czyj link jest „lepszy”. Do tego regulaminy wielu programów partnerskich i sieci afiliacyjnych zabraniają publikowania linków w cudzych komentarzach — za złamanie zasad sieć może zablokować konto razem z prowizjami.

    Zgłoś komentarz

    Powód

    Newsletter Raport Imperium

    Imperium budowane na Twoich oczach

    Za darmo · raz w tygodniu · wypis jednym kliknięciem

    Co Cię interesuje?

    Raz w tygodniu. Zapis potwierdzasz linkiem z maila, wypisujesz się jednym kliknięciem.