Niech agenci AI znajdą Twój produkt i się z nim połączą

Agenci nie przeglądają dokumentacji, by znaleźć Twoje API. Zaglądają w kilka dobrze znanych miejsc w Twojej domenie. Te testy pokazują, czy agent znający tylko Twoją domenę znajdzie Twoje API, serwer MCP i sposób logowania.

Typ strony

Opublikuj katalog API

Katalog RFC 9727 pod /.well-known/api-catalog wymienia Twoje API i linkuje każde do opisu OpenAPI. Jedno żądanie i agent wie, co oferujesz.

SagBot czyta /.well-known/api-catalog na Twojej stronie i zawarte w nim linki.

Opisz swój serwer MCP

Jeśli prowadzisz serwer MCP, karta serwera pod /.well-known/mcp/server-card.json pozwala klientom MCP znaleźć go i skonfigurować na podstawie samej domeny, bez kopiowania przez użytkownika adresu z dokumentacji.

SagBot czyta ścieżki kart serwera MCP w /.well-known/ na Twojej stronie.

Opublikuj kartę agenta

Jeśli Twój produkt sam jest agentem, karta A2A pod /.well-known/agent-card.json mówi innym agentom, co robi i jak z nim rozmawiać.

SagBot czyta /.well-known/agent-card.json na Twojej stronie.

Spraw, by logowanie dało się wykryć

Metadane serwera autoryzacji pozwalają agentowi znaleźć endpointy logowania i tokenów bez wpisywania ich na sztywno. Udostępnij /.well-known/oauth-authorization-server lub /.well-known/openid-configuration.

SagBot czyta dokumenty metadanych OAuth i OpenID Connect na Twojej stronie.

Wskaż, który serwer wydaje tokeny do Twojego API

Metadane RFC 9728 pod /.well-known/oauth-protected-resource mówią agentowi, którego serwera autoryzacji zapytać o token, zanim wywoła Twoje API. Polegają na nich serwery MCP wymagające logowania.

SagBot czyta /.well-known/oauth-protected-resource na Twojej stronie.

Wyjaśnij, jak agenci dostają dane dostępowe

Plik /auth.md opisuje zwykłym Markdownem, jak agent się rejestruje, jakie istnieją zakresy i skąd brać klucze. Pokazywany jako rada: jest nowy i tani w dodaniu.

SagBot czyta /auth.md na Twojej stronie.

Udostępnij akcje aplikacji jako narzędzia WebMCP

WebMCP pozwala agentowi działającemu w przeglądarce wywoływać akcje Twojej aplikacji jako narzędzia, zamiast klikać po interfejsie. Zarejestruj narzędzia przez document.modelContext.registerTool() albo dodaj toolname i tooldescription do kluczowych formularzy.

SagBot czyta HTML i skrypty Twojej strony pod kątem zarejestrowanych narzędzi WebMCP lub opisanych formularzy. To rada, nie część wyniku.

Sprawdź, które z nich Twój produkt zalicza

Skanuj jako API lub aplikacja, by uwzględnić te testy. Do każdego niezaliczonego dostajesz poprawkę do wklejenia w agenta programistycznego.

Typ strony

Także dla Twojego zespołu