# AWS opisuje wyszukiwanie WWW w Claude Desktop przez AgentCore Gateway

- Source: MechNext — https://mechnext.eu/pl/article/28-aws-details-web-search-for-claude-desktop-through-agentcore-gateway
- Published: 2026-10-03
- Updated: 2026-10-03
- Category: Industry News
- Language: pl (Markdown in other languages: ?lang=en, ?lang=de, ?lang=sk, ?lang=zh, ?lang=ru)

> Instrukcja AWS z 2 października 2026 r. łączy Claude Desktop z Web Search przez AgentCore Gateway i przedstawia uwierzytelnianie oraz obsługę tokenów.

2 października 2026 r. AWS opublikowało instrukcję połączenia Claude Desktop z Web Search przez Amazon Bedrock AgentCore Gateway. Wpis przedstawia Web Search jako zarządzaną funkcję zgodną z MCP, opartą na indeksie WWW Amazonu. Opis połączenia, ustawień i przebiegu uwierzytelniania pochodzi z tej instrukcji AWS.

### Jak przebiega połączenie

W opisanej konfiguracji AgentCore Gateway pośredniczy w dostępie Claude Desktop do Web Search. Instrukcja przypisuje osobne zadania uwierzytelnieniu użytkownika, wystawieniu tokenu i jego sprawdzeniu. IAM Identity Center uwierzytelnia użytkowników, Cognito wydaje tokeny JWT, a AgentCore Gateway według wpisu weryfikuje je przy każdym żądaniu. Taki podział wyjaśnia, dlaczego konfiguracja obejmuje zarówno usługi tożsamości, jak i bramę oraz konektor aplikacji.

AWS opisuje warstwę federacji opartą na Cognito. Wykorzystuje ona przepływ OAuth 2.0 authorization code grant oraz uwierzytelnianie SAML przez IAM Identity Center. Są to elementy jednej ścieżki przedstawionej w instrukcji: od logowania użytkownika do przekazania tokenu bramie. Przy czytaniu kolejnych kroków warto więc odróżnić sposób uwierzytelnienia osoby od sposobu, w jaki brama otrzymuje token do sprawdzenia.

### Ustawienia wskazane w instrukcji

Instrukcja najpierw poleca utworzyć pulę użytkowników Cognito. Ma ona pełnić funkcję wystawcy tokenów OIDC dla AgentCore Gateway. Następnie opisuje aplikację SAML w IAM Identity Center, federowaną z Cognito, oraz przypisanie użytkownikom lub grupom dostępu do Web Search. Przypisanie dostępu stanowi osobny krok obok utworzenia elementów potrzebnych do federacji.

Kolejny krok to utworzenie AgentCore Gateway z Web Search i autoryzacją żądań przychodzących opartą na JWT. Zgodnie z opisem AWS brama sprawdza tokeny przedstawiane przy żądaniach. W tej konfiguracji Cognito i brama mają różne role: pierwsze wydaje token, druga go weryfikuje. Rozróżnienie tych ról pomaga zrozumieć, jak opisane ustawienia składają się na jedną ścieżkę dostępu.

### Konektor Claude Desktop i użycie narzędzia

Konfiguracja konektora Claude Desktop korzysta ze Streamable HTTP, adresu URL zasobu bramy oraz identyfikatora i sekretu klienta aplikacji Cognito. Te dane wiążą aplikację z bramą i wcześniej opisanym przebiegiem logowania. Wpis podaje je jako konkretne elementy swojego przykładu, dlatego ustawienia konektora należy czytać razem z krokami dotyczącymi Cognito i AgentCore Gateway.

Według AWS Claude Desktop wykrywa WebSearchTool przez wywołanie MCP tools/list. Wykrycie narzędzia i jego uruchomienie to w opisie dwa odrębne momenty. Przy wykonaniu narzędzia wpis przedstawia okno zgody z opcjami Deny, Allow for this task oraz Allow once. Czytelnik może więc osobno prześledzić pojawienie się WebSearchTool na liście i decyzję oferowaną przy jego użyciu.

### Zakres regionalny podany przez AWS

We wpisie jako regiony dostępności AgentCore Web Search wymieniono US East (N. Virginia), Europe (Ireland) i Asia Pacific (Tokyo). Jest to lista podana przez AWS w chwili publikacji wpisu. Nie określa ona dostępności w innych regionach.

Całą instrukcję można odczytać jako ciąg powiązanych czynności: przydzielenie dostępu użytkownikom lub grupom, logowanie w przepływie federacyjnym, wystawienie tokenu przez Cognito, sprawdzenie go przez AgentCore Gateway oraz udostępnienie WebSearchTool w Claude Desktop przez skonfigurowany konektor. Każda czynność ma w przykładzie AWS własną rolę. Szczegóły konfiguracji i listę regionów zawiera [wpis AWS](https://aws.amazon.com/blogs/machine-learning/add-secure-web-search-to-claude-desktop-with-amazon-bedrock-agentcore).