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:

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.

WYWOŁANIE NARZĘDZIAASYSTENT AI/mcp LUB /a2aOBLICZENIA JAKNA /toolsODPOWIEDŹ ZEŹRÓDŁOODCZYT STRONYAGENTSTRONATEKST JAKO MARKDOWNWYWOŁANIE NARZĘDZIAASYSTENT AI/mcp LUB /a2aOBLICZENIA JAK NA /toolsODPOWIEDŹ ZE ŹRÓDŁEMODCZYT STRONYAGENTSTRONATEKST JAKO MARKDOWN
RYS. 1 · DWIE DROGI DO TYCH SAMYCH DANYCHZŁOTO = WEJŚCIE DLA PROGRAMÓW

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.

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

  1. 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.
  2. notifications/initialized: Klient potwierdza, że zgłoszenie zostało zakończone.
  3. tools/list: Serwer podaje wszystkie narzędzia z opisem i schematem danych wejściowych.
  4. 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 rejestrowymi
  • leistungen_auflisten: wszystkie obszary usług, każdy ze stroną, której dotyczy
  • preise_abfragen: stawki godzinowe, dojazd i dopłaty z tego samego źródła co cennik
  • website_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”.

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.

Granice /mcp i /a2a
GranicaWartośćCo wtedy się dzieje
Rozmiar zapytania900 KBHTTP 413
Otwarte sesje MCP, wszyscy klienci łącznie500HTTP 503 z Retry-After: 30
Sesja MCP bez aktywności30 minutSesja wygasa, klient dostaje 404 i zgłasza się ponownie.
Czas odpowiedzi na wywołanie narzędzia z /tools bez zapytań sieciowych, wraz z czasem oczekiwania10 sekundPrzerwanie z komunikatem o błędzie narzędzia
Test poczty e-mail30 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 linkupo 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 żywoOpł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.

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 ListTasks zwraca 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.

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.

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.

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).

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
+49 3744 4399760pon.–pt. 8–17
ZadzwońOddzwonimy

WYKAZ CZĘŚCI · ARKUSZ 1/1

Z czego składa się ta strona

Wartości zmierzone podczas budowania strony – z JavaScriptem Państwa przeglądarka mierzy je na bieżąco.

POZ.ELEMENTTYPROZMIAR
01index.htmlDokument≈ 29 kB
02styles.cssArkusz stylów≈ 20 kB
03scripts.jsSkrypt≈ 13 kB
04archivo-variable.woff2Czcionka≈ 58 kB
05ibm-plex-mono.woff2Czcionka≈ 30 kB
06favicon.svgGrafika< 1 kB

Pliki cookie reklamowe ani analityczne: brak. Bez Państwa zgody strona nie pobiera niczego z obcych serwerów poza naszą usługą dostarczania treści Cloudflare – czcionki, skrypty i grafiki są u nas. Tak samo budujemy Państwa IT.

POZA GODZINAMI PRACY

Mimo to proszę śmiało dzwonić

Zwykle jesteśmy w biurze pon.–pt. 8–17.

Wieczorem i w weekend numer też jest do nas przekierowany i często ktoś odbiera. Obiecać tego nie możemy.

Jeśli nikt nie odbierze, proszę zostawić krótką wiadomość na poczcie głosowej: imię i nazwisko, numer i czego dotyczy sprawa. Oddzwonimy jak najszybciej, najpóźniej następnego dnia roboczego.

Sama rozmowa nic nie kosztuje. Jeśli poza godzinami pracy ktoś musi zająć się sprawą od razu, obowiązuje dopłata z cennika.

Zadzwoń teraz+49 3744 4399760

Wolą Państwo napisać? Przez formularz kontaktowy albo na [email protected]. Przeczytamy to następnego dnia roboczego.

DIAGNOZA · AT-K2

W czym możemy pomóc?

↵ WYBIERZESC ZAMKNIJTELEFON: +49 3744 4399760

Ustawienia indywidualne

Które usługi mogą się ładować?

Niezbędne technicznie

Podjęta tutaj decyzja oraz ustawienia schematu kolorów i animacji. Te dane zostają jako małe wpisy na Państwa urządzeniu i nigdy nie są wysyłane na serwer. Są potrzebne do działania strony, dlatego nie można ich wyłączyć.