WebMCP

Alexandra Klepper

François Beaufort

Kasper Kulikowski

Data publikacji: 18 maja 2026 r., ostatnia aktualizacja: 7 października 2026 r.

WebMCP to proponowany standard internetowy, który pomaga tworzyć i udostępniać ustrukturyzowane narzędzia dla agentów AI. WebMCP udostępnia kod JavaScript i dodaje adnotacje do elementów formularzy HTML, dzięki czemu agenty dokładnie wiedzą, jak korzystać z funkcji strony, aby zapewnić użytkownikom wygodę. Może to znacznie poprawić wydajność i niezawodność wykonywania działań przez agenta.

Agenty AI to nowsza technologia. Mogą pomóc użytkownikom w wykonywaniu bardzo złożonych i technicznych zadań. WebMCP zapewnia większą dokładność wykonywania zadań przez agenty i można go dodać jako progresywne ulepszanie.

Wyjaśnienie	Sieć	Rozszerzenia	Stan Chrome	Intencja
GitHub	Wersja próbna origin		Wyświetl	Zamiar przeprowadzenia eksperymentu

Dlaczego WebMCP?

WebMCP udostępnia reguły interakcji, które wypełniają lukę między aplikacjami internetowymi a agentami, zwiększając wydajność, niezawodność i skuteczność wykonywania zadań. Zamiast agenta sprawdzającego element, np. przycisk lub pole, aby zrozumieć jego przeznaczenie, witryna deklaruje przeznaczenie elementu, dzięki czemu jest on używany zgodnie z zamierzeniami.

Jest to bardziej niezawodne niż wykonanie, które może obejmować wiele kroków i pozostawia każdy krok do interpretacji przez agenta.

Witryny mogą udostępniać informacje o konkretnym celu, np. wyszukiwaniu lub zakupie, przez zdefiniowanie tool. Narzędzia działają na stronie w widoczny sposób, dzięki czemu użytkownicy mają pewność, że zadania są wykonywane zgodnie z oczekiwaniami. Pozwala to też zachować nienaruszoną markę i wybory projektowe skoncentrowane na człowieku.

WebMCP obsługuje:

• Wykrywanie: standardowy sposób rejestrowania narzędzi przez strony za pomocą agentów, takich jak checkout lub filter_results.
• Schematy JSON: precyzyjne definicje danych wejściowych i oczekiwanych danych wyjściowych, które pozwalają ograniczyć halucynacje i nieporozumienia.
• Stan: wspólne rozumienie bieżącego kontekstu strony, dzięki czemu agent wie, jakie zasoby są dostępne do działania w czasie rzeczywistym.

Naszym celem jest tworzenie interfejsów API, które może wdrożyć każda przeglądarka z funkcjami agentowymi, aby ułatwić użytkownikom wykonywanie zadań. Możesz śledzić ten proces na GitHub.

Przypadki użycia

WebMCP można wykorzystać na wiele sposobów. Na przykład:

• Pomóż klientom uzyskać pomoc. Jeśli dostarczasz klientom oprogramowanie, możesz mieć skomplikowany proces obsługi klienta, który pozwala odpowiadać na wiele różnych pytań. Możesz użyć WebMCP, aby pomóc agentowi szybciej przejść do odpowiedniego formularza i wypełnić pola informacjami podanymi przez użytkownika.
• Ulepszanie rezerwacji podróży. Pomóż agentom rezerwować złożone podróże obejmujące wiele miast i pasażerów w mniejszej liczbie kroków.

Niektóre działania, np. dokonanie zakupu, mogą być poufne. Możesz dołączyć polecenie, które wymaga interakcji użytkownika z oknem potwierdzenia.

W praktyce narzędzia mogą wykonywać te zadania:

• Wypełnianie ustrukturyzowanych formularzy: utwórz narzędzie submit_application, które pomoże agentom prawidłowo mapować dane zebrane podczas rozmowy z użytkownikiem na pola formularza. Możesz na przykład rozróżnić, czy pole wymaga podania pełnego imienia i nazwiska czy osobno imienia i nazwiska.
• Interakcje agenta pomocy w interfejsach przeznaczonych dla ludzi: niektóre pola są przeznaczone dla użytkowników, ale mogą nie być zrozumiałe dla agentów. Możesz utworzyć narzędzie date_pick, które umożliwia złożony wybór daty i godziny podczas rezerwacji lub rezerwacji wydarzenia.
• Szybsze debugowanie aplikacji: możesz utworzyć narzędzie run_diagnostics na stronie ustawień dla deweloperów, aby agent mógł uruchamiać poprawki, które w innym przypadku są ukryte w zagnieżdżonych menu.

Brakuje Twojego przypadku użycia? A może masz pomysł, którym chcesz się podzielić w ramach WebMCP? Zadawaj pytania i bierz udział w dyskusjach na GitHubie.

Rozpocznij

Dołącz do testowania origin WebMCP od Chrome 149. Dowiedz się więcej o pierwszych krokach z testowaniem origin.

Lokalny WebMCP

WebMCP jest dostępny jako flaga Chrome do lokalnego programowania:

1. Otwórz Chrome i przejdź na stronę chrome://flags/#enable-webmcp-testing.
2. Ustaw flagę na Enabled (Włączone).
3. Uruchom ponownie Chrome, aby zastosować zmiany.

Korzystanie z interfejsów WebMCP API

Do skonfigurowania narzędzi witryny możesz użyć 2 interfejsów API:

• Imperatywny interfejs API: definiuj różne typy narzędzi za pomocą standardowego kodu JavaScript, np. dane wejściowe formularza, narzędzia do nawigacji, zarządzanie stanem lub inne funkcje.
• Deklaratywny interfejs API: dodaj adnotacje do standardowych formularzy HTML, aby utworzyć narzędzie WebMCP.

Za pomocą Narzędzi deweloperskich w Chrome możesz debugować narzędzia WebMCP i sprawdzać, jak przeglądarka analizuje schemat JSON.

Ograniczenia

WebMCP ma ułatwiać agentom i ludziom wykonywanie złożonych zadań, ale ma pewne ograniczenia:

• Przeglądanie bez interfejsu graficznego: chociaż narzędzia WebMCP można uruchamiać w środowiskach bez interfejsu graficznego, ten interfejs API jest przeznaczony głównie do lokalnych przepływów pracy w przeglądarce z udziałem człowieka.
• Narzut w przypadku złożonych interfejsów: jeśli Twoja witryna jest bardzo złożona, prawdopodobnie musisz przeprowadzić refaktoryzację lub dodać kod JavaScript, aby obsługiwać stan aplikacji i interfejsu.
• Wykrywalność narzędzi: klienty i przeglądarki muszą bezpośrednio odwiedzić witrynę, aby dowiedzieć się, czy zawiera ona narzędzia, które można wywołać.

zasady dotyczące uprawnień,

Oba interfejsy API są ograniczone przez toolszasady dotyczące uprawnień. Domyślna wartość zasady to self, co umożliwia rejestrację narzędzi w kontekstach najwyższego poziomu i tego samego źródła, a wyłącza ją w przypadku elementów iframe z innych źródeł.

Aby zezwolić na korzystanie z narzędzi WebMCP w elemencie iframe współdzielenia, dodaj do niego atrybut allow="tools".

Prezentacja

Przykłady wersji demonstracyjnych obejmujących implementacje imperatywne i deklaratywne są dostępne tutaj:

• WebMCP zaMaker korzysta z interfejsu WebMCP Imperative API.
• Wersja demonstracyjna dotycząca podróży (React) korzysta z interfejsu WebMCP Imperative API.
• Wersja demonstracyjna Le Petit Bistro korzysta z interfejsu WebMCP Declarative API.

Możesz też przejrzeć i przeanalizować kod źródłowy wersji demonstracyjnej na GitHub.

Imitowanie agenta w celu przetestowania narzędzi

Opracowaliśmy 2 rozszerzenia do Chrome, które pomogą Ci zobaczyć, jak działają narzędzia WebMCP w naszych wersjach demonstracyjnych i Twoich aplikacjach.

Zainstaluj przykładowe rozszerzenie agentowe do Chrome, aby sprawdzać, monitorować i wykonywać narzędzia WebMCP za pomocą promptów w języku naturalnym. To rozszerzenie zawsze ufa adnotacjom WebMCP, które mogą ostrzegać agenta o działaniach związanych z poufnymi danymi. Pokazuje to, jak narzędzie może działać inaczej z adnotacjami.

Domyślnie to rozszerzenie używa małego serwera Node z pakietem AI SDK. Klucze interfejsu API są wymagane i pozostają na serwerze lokalnym. Prompty są domyślnie wysyłane do modelu gemini-3.6-flash, ale możesz zmienić model i dostawcę interfejsu API w pliku .env rozszerzenia. Są tam pola dla OpenAI, Google i Anthropic, ale możesz też dostosować rozszerzenie, aby używało modelu innego dostawcy.

Możesz też użyć modelu po stronie klienta z interfejsem Prompt API. Nie wymaga to kluczy interfejsu API, a dane pozostają na urządzeniu. Aby to zrobić, włącz chrome://flags/#prompt-api-tool-use.

Zainstaluj rozszerzenie Model Context Tool Inspector, aby eksperymentować z agentem i zobaczyć, jak działają narzędzia WebMCP w wersjach demonstracyjnych lub we własnych aplikacjach. Użyj promptów w języku naturalnym, aby sprawdzić, czy agent wchodzi w interakcje z narzędziami WebMCP zgodnie z oczekiwaniami.

Aby używać Gemini do wywoływania narzędzi, musisz mieć klucz interfejsu API, który podajesz w interfejsie rozszerzenia. Twoje prompty są domyślnie wysyłane do modelu gemini-3.6-flash. Możesz wybrać inny model Gemini do eksperymentowania lub dostosować kod rozszerzenia, aby używać modelu innego dostawcy.

Zaangażuj się i prześlij opinię

WebMCP jest przedmiotem aktywnej dyskusji i może ulec zmianie w przyszłości. Jeśli wypróbujesz te interfejsy API i będziesz mieć jakieś uwagi, chętnie je poznamy.

• Dołącz do testowania origin WebMCP i śledź implementację w Chrome na stronie Chrome Status.
• Przeczytaj wyjaśnienie dotyczące WebMCP, zadawaj pytania i bierz udział w dyskusji.
• Zapoznaj się ze sprawdzonymi metodami dotyczącymi WebMCP.
• Zapoznaj się ze wskazówkami dotyczącymi bezpieczeństwa narzędzia WebMCP i sprawdzonymi metodami.
• Jeśli masz uwagi dotyczące implementacji Chrome, zgłoś błąd Chromium.