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
- Czym jest WebMCP i jak się różni od tradycyjnego MCP?
- Jak włączyć WebMCP dla swojej domeny?
- Jakie narzędzia można rejestrować w WebMCP?
- Testowanie schematów MCP: MCP Inspector vs. WebMCP
- Jak przetestować WebMCP w praktyce?
- Ograniczenia WebMCP w fazie preview
- Czy WebMCP zastąpi tradycyjne testowanie MCP?
- Jakie są praktyczne zastosowania WebMCP?
- Najczęstsze pytania
- Ź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:
- Zaloguj się do panelu Cloudflare i przejdź do sekcji Agent Readiness.
- Włącz WebMCP przełącznikiem w obszarze WebMCP.
- 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]. - 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ędzie | Jak się uruchamia | Interfejs | Kiedy używać |
|---|---|---|---|
| MCP Inspector | npx @modelcontextprotocol/inspector lokalnie | Wizualny, przeglądarka na localhost:3000 | Testowanie lokalnego lub zdalnego serwera MCP; debugowanie schematów przed wdrożeniem |
| WebMCP + Browser Run | Włączenie w panelu Cloudflare | Przeglądarka, agent AI w ChatGPT/Claude | Testowanie 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
- Przejdź do panelu → Agent Readiness → WebMCP.
- Włącz funkcję.
- Jeśli używasz Site MCP Server, upewnij się, że twoja strona ma endpoint
/mcpzwracają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ń:
- Brak kryptograficznej weryfikacji — pakiet Content Credentials odczytuje metadane C2PA, ale nie weryfikuje podpisów; wynik zawiera
signatureVerified: false[1]. - Ograniczona liczba pakietów — na etapie preview dostępne są tylko Content Credentials i Site MCP Server; inne pakiety będą dodawane [1].
- Kompatybilność przeglądarki — WebMCP wymaga Chrome 146+; wsparcie dla innych przeglądarek nie jest jeszcze potwierdzone [1].
- 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?
- 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].
- 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].
- Analiza treści — agent może odczytywać metadane C2PA obrazów i weryfikować ich pochodzenie [1].
- 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
Fanatyk nowych technologii i specjalista w zakresie sztucznej inteligencji.
Jak powstają teksty: Polityka AI · O redakcji