Przejdź do treści

Narzędzia AI

WebMCP w przeglądarce: jak agenci AI uzyskują dostęp do narzędzi

Zaktualizowano: Autor: Andrzej Niemiec9 min czytania

WebMCP to nowy standard Cloudflare, który pozwala agentom AI działającym w przeglądarce używać narzędzi zarejestrowanych na twojej stronie. Dowiedz się, jak…

Spis treści
  1. Czym jest WebMCP i jak się różni od tradycyjnego MCP?
  2. Jak włączyć WebMCP dla swojej domeny?
  3. Jakie narzędzia można rejestrować w WebMCP?
  4. Testowanie schematów MCP: MCP Inspector vs. WebMCP
  5. Jak przetestować WebMCP w praktyce?
  6. Ograniczenia WebMCP w fazie preview
  7. Czy WebMCP zastąpi tradycyjne testowanie MCP?
  8. Jakie są praktyczne zastosowania WebMCP?
  9. Najczęstsze pytania
  10. Źródła

Czym jest WebMCP i jak się różni od tradycyjnego MCP?

WebMCP to eksperymentalne API przeglądarki ogłoszone przez Cloudflare 6 sierpnia 2026 roku [1]. W przeciwieństwie do Model Context Protocol (MCP), który działa między agentem a serwerem danych, WebMCP pozwala agentom AI działającym w przeglądarce (np. Claude, ChatGPT) uzyskać dostęp do narzędzi zarejestrowanych bezpośrednio na stronie internetowej [1].

Mechanizm jest prosty: strona rejestruje narzędzia za pomocą document.modelContext.registerTool(), a Cloudflare — po włączeniu WebMCP w panelu — dodaje do odpowiedzi HTML skrypt bridge, który udostępnia te narzędzia agentowi. Kod originu nie wymaga zmian [1].

Jak włączyć WebMCP dla swojej domeny?

Konfiguracja WebMCP odbywa się w panelu Cloudflare bez pisania kodu. Proces wygląda następująco:

  1. Zaloguj się do panelu Cloudflare i przejdź do sekcji Agent Readiness.
  2. Włącz WebMCP przełącznikiem w obszarze WebMCP.
  3. Wybierz pakiety narzędzi, które chcesz udostępnić agentom — na etapie preview dostępne są Content Credentials (odczyt metadanych C2PA obrazów) i Site MCP Server (proxy dla istniejącego endpointu MCP na /mcp) [1].
  4. Zapisz ustawienia. Cloudflare automatycznie wstrzyknie skrypt bridge do odpowiedzi HTML.

Nie trzeba modyfikować kodu aplikacji ani wdrażać nowych wersji. Funkcja działa dla wszystkich odwiedzających stronę w Chrome 146+ [1].

Jakie narzędzia można rejestrować w WebMCP?

WebMCP obsługuje dowolne narzędzie, które strona może zdefiniować za pomocą document.modelContext.registerTool(). Każde narzędzie zawiera:

  • Nazwę — identyfikator dla agenta (np. search_products, submit_form).
  • Opis — wyjaśnienie, co narzędzie robi.
  • inputSchema — schemat JSON opisujący parametry wejściowe.
  • Funkcję obsługi — kod, który wykonuje akcję na stronie.

Pakiet Site MCP Server pozwala na proxy'owanie istniejącego serwera MCP. Jeśli twoja strona ma endpoint MCP na /mcp, WebMCP automatycznie pobiera listę narzędzi (tools/list) i rejestruje je w przeglądarce [1].

Testowanie schematów MCP: MCP Inspector vs. WebMCP

Do testowania schematów MCP dostępne są dwa podejścia:

NarzędzieJak się uruchamiaInterfejsKiedy używać
MCP Inspectornpx @modelcontextprotocol/inspector lokalnieWizualny, przeglądarka na localhost:3000Testowanie lokalnego lub zdalnego serwera MCP; debugowanie schematów przed wdrożeniem
WebMCP + Browser RunWłączenie w panelu CloudflarePrzeglądarka, agent AI w ChatGPT/ClaudeTestowanie narzędzi dostępnych dla agentów; weryfikacja, czy agent potrafi je używać

MCP Inspector to narzędzie open-source uruchamiane lokalnie; pozwala na podłączenie się do dowolnego serwera MCP, wyświetlenie dostępnych narzędzi i ręczne testowanie ich schematów [2]. WebMCP natomiast to część infrastruktury Cloudflare — agent AI w przeglądarce automatycznie odkrywa i używa zarejestrowane narzędzia [1].

Jak przetestować WebMCP w praktyce?

Krok 1: Przygotuj stronę z narzędziem

Dodaj do swojej strony kod rejestrujący narzędzie:

if (document.modelContext) {
  document.modelContext.registerTool({
    name: 'get_weather',
    description: 'Pobiera prognozę pogody dla miasta',
    inputSchema: {
      type: 'object',
      properties: {
        city: { type: 'string', description: 'Nazwa miasta' },
        days: { type: 'number', description: 'Liczba dni prognozy' }
      },
      required: ['city']
    },
    handler: async (input) => {
      const response = await fetch(`/api/weather?city=${input.city}`);
      return await response.json();
    }
  });
}

Krok 2: Włącz WebMCP w Cloudflare

  1. Przejdź do panelu → Agent Readiness → WebMCP.
  2. Włącz funkcję.
  3. Jeśli używasz Site MCP Server, upewnij się, że twoja strona ma endpoint /mcp zwracający listę narzędzi w formacie MCP.

Krok 3: Testuj z agentem AI

Otwórz ChatGPT lub Claude w przeglądarce, wejdź na swoją stronę i poproś agenta, aby użył narzędzia:

Prompt: "Sprawdź pogodę w Warszawie na następne 3 dni, używając dostępnych narzędzi."

Agent powinien automatycznie odkryć narzędzie get_weather i je wywołać [1].

Ograniczenia WebMCP w fazie preview

WebMCP jest eksperymentalnym API i ma kilka ograniczeń:

  1. Brak kryptograficznej weryfikacji — pakiet Content Credentials odczytuje metadane C2PA, ale nie weryfikuje podpisów; wynik zawiera signatureVerified: false [1].
  2. Ograniczona liczba pakietów — na etapie preview dostępne są tylko Content Credentials i Site MCP Server; inne pakiety będą dodawane [1].
  3. Kompatybilność przeglądarki — WebMCP wymaga Chrome 146+; wsparcie dla innych przeglądarek nie jest jeszcze potwierdzone [1].
  4. Brak integracji CI/CD — nie ma oficjalnego pluginu do automatyzacji testów WebMCP w pipeline'ach.

Czy WebMCP zastąpi tradycyjne testowanie MCP?

WebMCP i MCP Inspector pełnią różne role:

  • MCP Inspector — narzędzie dla developerów do debugowania schematów i testowania serwera MCP lokalnie lub zdalnie [2].
  • WebMCP — infrastruktura dla agentów AI w przeglądarce, aby mogli używać narzędzi strony bez dodatkowej konfiguracji [1].

Dla małych zespołów i startupów WebMCP eliminuje potrzebę pisania boilerplate'u do integracji agentów z własnymi narzędziami. Dla dużych projektów, które wymagają pełnej kontroli nad testowaniem i wdrażaniem, tradycyjne podejście (MCP Inspector + CLI) pozostaje niezbędne.

Jakie są praktyczne zastosowania WebMCP?

  1. E-commerce — agent AI może przeglądać katalog produktów, sprawdzać dostępność i pomagać w zakupach bez konieczności budowania dedykowanego API [1].
  2. Obsługa klienta — chatbot może uzyskać dostęp do narzędzi do wyszukiwania zamówień, resetowania haseł i zgłaszania problemów bezpośrednio ze strony [1].
  3. Analiza treści — agent może odczytywać metadane C2PA obrazów i weryfikować ich pochodzenie [1].
  4. Automatyzacja testów — Playwright MCP pozwala agentom na eksplorację aplikacji i pisanie testów E2E bez ręcznego kodowania [3].

Najczęstsze pytania

Czy WebMCP jest bezpłatne?

WebMCP jest funkcją Cloudflare dostępną w fazie preview. Cloudflare nie opublikował oficjalnego cennika dla WebMCP; funkcja jest dostępna dla użytkowników z aktywnym kontem Cloudflare. Browser Run, który jest powiązanym produktem, może podlegać limitom i rozliczeniom — szczegóły należy sprawdzić w panelu Cloudflare [1].

Czy mogę testować WebMCP lokalnie?

WebMCP jest funkcją edge'u Cloudflare i wymaga aktywnego konta oraz domeny obsługiwanej przez Cloudflare. Do lokalnego testowania schematów MCP użyj MCP Inspector (npx @modelcontextprotocol/inspector) [2].

Czy WebMCP działa we wszystkich przeglądarkach?

WebMCP wymaga Chrome 146+. Wsparcie dla Firefox, Safari i innych przeglądarek nie jest jeszcze potwierdzone [1].

Jak bezpiecznie rejestrować narzędzia w WebMCP?

Narzędzia rejestrowane w WebMCP działają w kontekście sesji użytkownika — agent może wykonywać akcje tylko w imieniu zalogowanego użytkownika. Upewnij się, że narzędzia walidują dane wejściowe i sprawdzają uprawnienia użytkownika [1].

Czy WebMCP obsługuje streaming danych?

Na etapie preview WebMCP obsługuje podstawowe narzędzia z inputSchema i handler. Streaming i zaawansowane funkcje mogą być dodane w przyszłych wersjach [1].

Źródła

  1. Give any website a WebMCP interface — Cloudflare Blog
  2. Test a Remote MCP Server · Cloudflare Agents docs — Cloudflare Developers
  3. Browser Run: give your agents a browser — Cloudflare Blog
AN
O autorze
Andrzej Niemiec

Fanatyk nowych technologii i specjalista w zakresie sztucznej inteligencji.

Jak powstają teksty: Polityka AI · O redakcji