WebMCP ↗ to eksperymentalne API przeglądarki, za pomocą którego strona udostępnia narzędzia agentowi AI działającemu w tej przeglądarce. Każda strona tej dokumentacji rejestruje jedno narzędzie: search_documentation. Przeszukuje ono ten sam indeks co wyszukiwarka serwisu i zwraca tytuły sekcji, adresy z kotwicami oraz fragmenty tekstu.
Agent wywołuje narzędzie z parametrami w formacie JSON:
{
"query": "faktura korygująca",
"limit": 5
}| Pole | Zasada |
|---|---|
query |
wymagane; niepuste, maksymalnie 500 znaków |
limit |
liczba od 1 do 20; domyślnie 5 |
Każdy wynik zawiera title, heading, url z kotwicą i excerpt (do 1000 znaków).
Zastosowanie WebMCP
Agent w przeglądarce widzi stronę tak jak człowiek, więc bez tego narzędzia musiałby korzystać z wyszukiwarki i analizować HTML. Narzędzie search_documentation od razu zwraca trafne fragmenty i adresy. Do momentu wywołania narzędzia nie są pobierane żadne dodatkowe zasoby.
Ograniczenia
- API jest eksperymentalne (
document.modelContext). W przeglądarkach, które go nie obsługują, narzędzie nie jest rejestrowane i dostępna jest tylko zwykła wyszukiwarka. - WebMCP nie jest serwerem MCP. Agent działający poza przeglądarką, np. w terminalu lub edytorze, korzysta z serwera MCP dokumentacji.
- Narzędzie służy wyłącznie do wyszukiwania i nie wykonuje żądań do API inFakt.
| Kod błędu | Znaczenie |
|---|---|
invalid_input |
nieprawidłowa wartość query lub limit |
index_unavailable |
nie udało się wczytać indeksu wyszukiwania; pomaga odświeżenie strony |
search_failed |
wyszukiwanie się nie powiodło; można spróbować ponownie |