Dostęp dla AI · InterfejsyREV. 2026-A
Jak asystenci AI korzystają z tej strony
Poza stronami dla ludzi ta witryna ma wejścia dla programów. Asystent AI może dzięki nim uruchamiać narzędzia z /tools albo pobierać nasze ceny, zamiast szukać liczb na stronach. Poniżej opisujemy, jak się połączyć i gdzie są granice.
- bez rejestracji
- tylko odczyt
- niczego nie zapisuje na stałe
Stan na:
01 / PRZEGLĄD
Trzy wejścia, te same dane co na stronach
Serwer MCP
/mcp
Dla asystentów obsługujących Model Context Protocol. 54 narzędzia, od profilu firmy i cen po kalkulatory z /tools.
Endpoint A2A
/a2a
Dla agentów zgodnych z protokołem A2A 1.0. Uruchamia 50 narzędzi z /tools, z tymi samymi obliczeniami co /mcp.
Markdown
Accept: text/markdown
Gdy program o to poprosi, strona zwraca swój tekst jako Markdown. Przeglądarki nadal dostają HTML.
Wszystkie trzy czytają z tych samych źródeł co strona. Dane firmy, cennik i obliczenia narzędzi nie są nigdzie prowadzone podwójnie: gdy zmieni się stawka godzinowa, po najbliższej publikacji pojawi się ona jednocześnie na stronie /preise i w odpowiedzi serwera MCP.
02 / SERWER MCP
Połączenie z serwerem MCP
- Adres
- https://aureum-tech.com/mcp
- Transport
- Streamable HTTP, JSON-RPC 2.0 przez POST
- Logowanie
- brak
- Dostęp
- tylko odczyt
Klient MCP, który podłącza serwery przez adres i Streamable HTTP, potrzebuje tylko tego adresu. Jak dokładnie nazywa się wpis, opisuje instrukcja Państwa klienta. Wielu klientów oczekuje konfiguracji tego rodzaju:
{
"mcpServers": {
"aureum-website": {
"url": "https://aureum-tech.com/mcp"
}
}
}
Niektórzy klienci wymagają dodatkowo podania transportu, zwykle jako „http” lub „streamable-http”. Klucz ani token nie są potrzebne.
Co dzieje się przy połączeniu
- initialize: Klient zgłasza się bez identyfikatora sesji. Odpowiedź zawiera w nagłówku
Mcp-Session-Id, a ten identyfikator klient dołącza do każdego kolejnego zapytania. - notifications/initialized: Klient potwierdza, że zgłoszenie zostało zakończone.
- tools/list: Serwer podaje wszystkie narzędzia z opisem i schematem danych wejściowych.
- tools/call: Klient wywołuje narzędzie z jego danymi wejściowymi. Wynik przychodzi jako JSON w polu tekstowym odpowiedzi.
Tak wygląda ręczne zgłoszenie, np. do wypróbowania w terminalu:
curl -i https://aureum-tech.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
"protocolVersion":"2025-06-18","capabilities":{},
"clientInfo":{"name":"test","version":"1.0"}}}'
Odpowiedź przychodzi jako strumień zdarzeń (text/event-stream), identyfikator znajduje się w nagłówku mcp-session-id. Wywołanie narzędzia z tym identyfikatorem; potwierdzenie z kroku 2 (notifications/initialized) pominięto tu dla skrótu, klient wysyła je wcześniej:
curl https://aureum-tech.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Mcp-Session-Id: <Kennung aus der ersten Antwort>" \
-H "MCP-Protocol-Version: 2025-06-18" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
"name":"preise_abfragen","arguments":{"zielgruppe":"firma"}}}'
Kto otworzy /mcp w przeglądarce, wysyła GET i dostaje komunikat „Nur POST (JSON-RPC)”. To prawidłowa odpowiedź, a nie awaria. Czy serwer działa, pokazuje /mcp/health.
Jakie są narzędzia
Cztery narzędzia odpowiadają na pytania o nas:
firma_und_kontakt: profil firmy z adresem, telefonem, dostępnością i danymi rejestrowymileistungen_auflisten: wszystkie obszary usług, każdy ze stroną, której dotyczypreise_abfragen: stawki godzinowe, dojazd i dopłaty z tego samego źródła co cennikwebsite_suchen: wyszukiwanie na wszystkich stronach aureum-tech.com
Do tego 50 z 51 narzędzi z /tools (wszystkie oprócz testu e-faktury), każde pod nazwą w rodzaju werkzeug_email_check. Liczą według tej samej logiki co strona w przeglądarce, a każda odpowiedź podaje stronę narzędzia, stan danych i ograniczenia wyniku. Jakich danych wejściowych oczekuje dane narzędzie, opisuje jego strona w sekcji „Dla asystentów AI”.
03 / GRANICE
Granice, żeby usługa działała dla wszystkich
Serwer jest publiczny i nie zna użytkowników. Dlatego koszt jednego zapytania jest ograniczony, a hamulce narzędzi odpytujących cudze serwery obowiązują dla wszystkich wywołań łącznie.
| Granica | Wartość | Co wtedy się dzieje |
|---|---|---|
| Rozmiar zapytania | 900 KB | HTTP 413 |
| Otwarte sesje MCP, wszyscy klienci łącznie | 500 | HTTP 503 z Retry-After: 30 |
| Sesja MCP bez aktywności | 30 minut | Sesja wygasa, klient dostaje 404 i zgłasza się ponownie. |
| Czas odpowiedzi na wywołanie narzędzia z /tools bez zapytań sieciowych, wraz z czasem oczekiwania | 10 sekund | Przerwanie z komunikatem o błędzie narzędzia |
| Test poczty e-mail | 30 testów na minutę, 300 nowych testów DNS na godzinę | Narzędzie prosi o ponowną próbę później. |
| Testy usług zewnętrznych, crawlerów AI i podglądu linku | po 20 testów na minutę, po 150 nowych testów na godzinę | jak przy teście poczty e-mail |
| Kalkulator opłat gas z danymi na żywo | Opłaty odpytywane na nowo najwyżej raz na minutę | Odpowiedź z wartościami z ostatniej minuty; bez danych na żywo – ze stałymi wartościami ze strony i z adnotacją |
Wynik, który jest jeszcze w pamięci podręcznej (pięć minut dla domeny lub adresu), nie liczy się do limitu godzinowego. Jeśli narzędzie samo zgłosi błąd (hamulec, limit czasu, nieprawidłowe dane), pojawia się on po niemiecku w polu fehler odpowiedzi. Dane niezgodne ze schematem /a2a odrzuca z błędem JSON-RPC -32602, a /mcp z odpowiedzią błędu z MCP SDK.
04 / A2A
Wywoływanie narzędzi przez protokół A2A
- Endpoint
- https://aureum-tech.com/a2a
- Protokół
- A2A 1.0 przez JSON-RPC 2.0
- Nagłówek
- A2A-Version: 1.0
- Metoda
- SendMessage
Agenci obsługujący protokół A2A wywołują te same 50 narzędzi przez /a2a. Wiadomość z częścią danych {"werkzeug": "…", "eingabe": {…}} uruchamia narzędzie, a odpowiedź zawiera ten sam wynik co przy /mcp:
curl https://aureum-tech.com/a2a \
-H "Content-Type: application/json" \
-H "A2A-Version: 1.0" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "SendMessage",
"params": {
"message": {
"messageId": "9b2f6c1e-4d1a-4c3b-8e55-0a7d2f3b1c90",
"role": "ROLE_USER",
"parts": [{
"data": {
"werkzeug": "werkzeug_email_check",
"eingabe": { "domain": "ihre-firma.de" }
},
"mediaType": "application/json"
}]
}
}
}'
- Wiadomość tylko z tekstem zwraca listę narzędzi z ich polami wejściowymi. Jeśli tekst zawiera nazwę narzędzia, przychodzą jego pełne dane wraz z przykładowymi pytaniami.
- Agent działa według stałych reguł i nie rozumie swobodnej mowy.
- Nie tworzy zadań (tasks) i niczego nie zapisuje. Każda odpowiedź jest bezpośrednią wiadomością, dlatego
ListTaskszwraca pustą listę. - Nie oferuje streamingu ani powiadomień push, nie przyjmuje plików.
- Gdy brakuje nagłówka
A2A-Version: 1.0, odpowiada błędem -32009: specyfikacja traktuje brak tej informacji jako wersję 0.3.
Cztery narzędzia dotyczące profilu firmy, usług, cen i wyszukiwania są dostępne tylko przez /mcp. Dla /a2a obowiązują ten sam limit rozmiaru zapytania, ten sam limit czasu i te same hamulce. Opis dla programów znajduje się w Agent Card.
05 / MARKDOWN
Strony w Markdown
Kto pobierze stronę z nagłówkiem Accept: text/markdown, dostanie zamiast HTML jej tekst jako Markdown, bez nawigacji i skryptów. Przeglądarki nigdy nie wysyłają tej informacji i widzą stronę jak zwykle. Wersje powstają przy budowie witryny z gotowych stron, więc są tak aktualne jak one.
curl -H "Accept: text/markdown" https://aureum-tech.com/preise
Odpowiedź zawiera Content-Type: text/markdown; charset=utf-8 i Vary: Accept. Wyjątkiem są przegląd poradnika i artykuły z systemu redakcyjnego: jedne i drugie są wypełniane treścią dopiero przy pobraniu, więc tam nadal przychodzi HTML. Tekst tych stron w jednym pliku zawiera /llms-full.txt.
06 / PLIKI OPISOWE
Gdzie programy sprawdzają, co jest dostępne
Te pliki opisują wejścia w formatach, których agenci i programy kontrolne szukają same. Strona główna wskazuje w nagłówku Link swojej odpowiedzi katalog API, opis OpenAPI i tę stronę.
- /.well-known/api-catalogKatalog API według RFC 9727. Podaje dla /mcp i /a2a opis, tę stronę jako dokumentację, a dla /mcp zapytanie o stan.
- /openapi.jsonOpenAPI 3.1: interfejs HTTP endpointu MCP.
- /.well-known/mcp/server-card.jsonMCP Server Card z adresem, transportem i listą narzędzi serwera MCP.
- /.well-known/agent-card.jsonA2A Agent Card: endpoint, wersja protokołu i możliwości agenta A2A.
- /.well-known/agent-skills/index.jsonWykaz Agent Skills. Zawiera dwie instrukcje dla agentów: korzystanie z narzędzi przez MCP oraz przygotowanie zapytania o usługę dla człowieka.
- /llms.txtSkrócona wersja witryny dla modeli językowych, z ważnymi stronami.
- /llms-full.txtTekst stron w jednym pliku.
- /auth.mdInstrukcja logowania dla agentów. Mówi przede wszystkim, że logowania tu nie ma.
- /robots.txtReguły dla crawlerów. Dopuszczeni są wszyscy, znane crawlery AI wymieniono osobno.
07 / OCHRONA DANYCH
Co dzieje się z danymi wejściowymi
Wywołanie przez /mcp lub /a2a wysyła dane wejściowe na nasz serwer, który na ich podstawie liczy i zwraca wynik, nie zapisując na stałe ani danych, ani wyniku. Tylko wyniki testów sieciowych pozostają wraz ze sprawdzaną domeną lub adresem najwyżej sześć minut w pamięci roboczej, bez powiązania z wywołującym. Zapisywane jest, jak przy każdym wejściu na stronę, tylko samo zapytanie bez jego treści, a to, co asystent sam robi z Państwa danymi, określa jego dostawca (szczegóły w polityce prywatności).
08 / DLA PAŃSTWA FIRMY
Taki dostęp dla Państwa własnych systemów
To, co ta strona oferuje dla własnych danych, budujemy także dla firm: serwer MCP, przez który asystent AI sięga do systemu magazynowo-handlowego lub bazy danych, z uprawnieniami ustalonymi wcześniej przez Państwa. Jak działamy, opisuje strona o integracjach MCP.
Zobacz integracje MCP