Přístup pro AI · RozhraníREV. 2026-A

Jak AI asistenti přistupují k tomuto webu

Vedle stránek pro lidi má tento web vstupy pro programy. AI asistent přes ně může nechat počítat nástroje z /tools nebo zjistit naše ceny, místo aby čísla hledal po stránkách. Zde je popsáno, jak se připojit a kde jsou meze.

  • bez registrace
  • jen pro čtení
  • nic trvale neukládá

Stav k

Tři vstupy, stejná data jako na stránkách

Server MCP

/mcp

Pro asistenty, kteří podporují Model Context Protocol. 54 nástrojů, od firemního profilu a cen až po kalkulačky z /tools.

Endpoint A2A

/a2a

Pro agenty podle protokolu A2A 1.0. Spouští 50 nástrojů z /tools, se stejným výpočtem jako /mcp.

Markdown

Accept: text/markdown

Když o to program požádá, stránka vrátí svůj text jako Markdown. Prohlížeče dál dostávají HTML.

VOLÁNÍ NÁSTROJEAI ASISTENT/mcp NEBO /a2aVÝPOČET JAKONA /toolsODPOVĚĎ SEZDROJČTENÍ STRÁNKYAGENTSTRÁNKATEXT JAKO MARKDOWNVOLÁNÍ NÁSTROJEAI ASISTENT/mcp NEBO /a2aVÝPOČET JAKO NA /toolsODPOVĚĎ SE ZDROJEMČTENÍ STRÁNKYAGENTSTRÁNKATEXT JAKO MARKDOWN
OBR. 1 · DVĚ CESTY KE STEJNÝM DATŮMZLATÁ = VSTUP PRO PROGRAMY

Všechny tři čtou ze stejných zdrojů jako web. Základní údaje, ceník a výpočty nástrojů se nikde nevedou dvakrát: když se změní hodinová sazba, objeví se po nejbližším nasazení zároveň na /preise i v odpovědi serveru MCP.

Připojení serveru MCP

Adresa
https://aureum-tech.com/mcp
Přenos
Streamable HTTP, JSON-RPC 2.0 přes POST
Přihlášení
žádné
Přístup
jen pro čtení

Klient MCP, který připojuje servery přes adresu a Streamable HTTP, potřebuje jen tuto adresu. Jak se položka přesně jmenuje, najdete v návodu svého klienta. Mnozí očekávají konfiguraci tohoto typu:

{
  "mcpServers": {
    "aureum-website": {
      "url": "https://aureum-tech.com/mcp"
    }
  }
}

Někteří klienti chtějí navíc uvést přenos, většinou jako „http“ nebo „streamable-http“. Klíč ani token není potřeba.

Co se při připojení děje

  1. initialize: Klient se přihlásí bez identifikátoru relace. Odpověď nese v hlavičce Mcp-Session-Id a tento identifikátor klient posílá s každým dalším požadavkem.
  2. notifications/initialized: Klient potvrdí, že přihlášení je dokončeno.
  3. tools/list: Server vypíše všechny nástroje s popisem a vstupním schématem.
  4. tools/call: Klient zavolá nástroj se svými vstupy. Výsledek přijde jako JSON v textovém poli odpovědi.

Takto vypadá přihlášení ručně, například pro vyzkoušení v terminálu:

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"}}}'

Odpověď přichází jako proud událostí (text/event-stream), identifikátor je v hlavičce mcp-session-id. Volání nástroje s tímto identifikátorem; potvrzení z kroku 2 (notifications/initialized) je zde pro stručnost vynecháno, klient ho posílá předtím:

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"}}}'

Kdo otevře /mcp v prohlížeči, pošle GET a dostane hlášení „Nur POST (JSON-RPC)“. To je správná odpověď, ne porucha. Zda server běží, ukáže /mcp/health.

Jaké nástroje jsou k dispozici

Čtyři nástroje odpovídají na otázky o nás:

  • firma_und_kontakt: firemní profil s adresou, telefonem, dostupností a rejstříkovými údaji
  • leistungen_auflisten: všechny oblasti služeb, vždy s příslušnou stránkou
  • preise_abfragen: hodinové sazby, doprava a příplatky ze stejného zdroje jako ceník
  • website_suchen: vyhledávání na všech stránkách aureum-tech.com

K tomu přibývá 50 z 51 nástrojů z /tools (všechny kromě kontroly e-fakturace), každý pod názvem typu werkzeug_email_check. Počítají stejnou logikou jako stránka v prohlížeči a každá odpověď uvádí stránku nástroje, stav dat a meze výsledku. Jaké vstupy nástroj očekává, najdete na jeho stránce v oddílu „Pro AI asistenty“.

Meze, aby služba fungovala pro všechny

Server je veřejný a nezná uživatele. Proto jsou náklady na jeden požadavek omezené a brzdy u nástrojů, které se dotazují cizích serverů, platí pro všechna volání dohromady.

Meze /mcp a /a2a
MezHodnotaCo se pak stane
Velikost požadavku900 KBHTTP 413
Otevřené relace MCP, všichni klienti dohromady500HTTP 503 s Retry-After: 30
Relace MCP bez aktivity30 minutRelace zanikne, klient dostane 404 a přihlásí se znovu.
Doba odpovědi na jedno volání nástroje z /tools bez síťového dotazu, včetně čekání10 sekundPřerušení s chybovým hlášením nástroje
Kontrola e-mailu30 kontrol za minutu, 300 nových kontrol DNS za hodinuNástroj požádá, abyste to zkusili později.
Kontrola služeb třetích stran, AI crawlerů a náhledu odkazůpro každou 20 kontrol za minutu a 150 nových kontrol za hodinujako u kontroly e-mailu
Kalkulačka gasu s živými hodnotamiPoplatky se znovu načítají nejvýše jednou za minutuOdpověď s hodnotami z poslední minuty; bez živých hodnot s pevným stavem stránky a upozorněním

Výsledek, který je ještě v mezipaměti (pět minut na doménu nebo adresu), se do hodinového limitu nepočítá. Ohlásí-li nástroj sám chybu (brzda, časový limit, nepoužitelný vstup), najdete ji německy v poli fehler odpovědi. Vstupy, které neodpovídají schématu, odmítne /a2a s chybou JSON-RPC -32602 a /mcp s chybovou odpovědí SDK MCP.

Volání nástrojů přes protokol A2A

Endpoint
https://aureum-tech.com/a2a
Protokol
A2A 1.0 přes JSON-RPC 2.0
Hlavička
A2A-Version: 1.0
Metoda
SendMessage

Agenti, kteří podporují protokol A2A, volají stejných 50 nástrojů přes /a2a. Zpráva s datovou částí {"werkzeug": "…", "eingabe": {…}} spustí nástroj a odpověď obsahuje stejný výsledek jako u /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"
        }]
      }
    }
  }'
  • Zpráva jen s textem vrátí seznam nástrojů s jejich vstupními poli. Pokud text uvádí název nástroje, přijdou jeho úplné údaje včetně ukázkových otázek.
  • Agent pracuje podle pevných pravidel a nerozumí volné řeči.
  • Nevytváří úlohy (tasks) a nic neukládá. Každá odpověď je přímá zpráva, ListTasks proto vrací prázdný seznam.
  • Streaming ani push oznámení nenabízí, soubory nepřijímá.
  • Chybí-li hlavička A2A-Version: 1.0, odpoví chybou -32009: specifikace vykládá chybějící údaj jako verzi 0.3.

Čtyři nástroje k firemnímu profilu, službám, cenám a vyhledávání jsou dostupné jen přes /mcp. Pro /a2a platí stejný limit velikosti těla požadavku, stejný časový limit a stejné brzdy. Popis pro programy je v Agent Card.

Stránky jako Markdown

Kdo stránku načte s hlavičkou Accept: text/markdown, dostane místo HTML její text jako Markdown, bez navigace a skriptů. Prohlížeče tento údaj nikdy neposílají a vidí stránku jako obvykle. Verze vznikají při sestavení webu z hotových stránek, a jsou proto stejně aktuální jako ony.

curl -H "Accept: text/markdown" https://aureum-tech.com/preise

Odpověď nese Content-Type: text/markdown; charset=utf-8 a Vary: Accept. Výjimkou jsou přehled Rádce a odborné články z redakčního systému: obojí se plní až při načtení, tam dál přichází HTML. Text těchto stránek v jednom souboru poskytuje /llms-full.txt.

Kde si programy zjistí, co je k dispozici

Tyto soubory popisují vstupy ve formátech, které agenti a kontrolní programy hledají sami. Úvodní stránka odkazuje v hlavičce Link své odpovědi na katalog API, popis OpenAPI a tuto stránku.

  • /.well-known/api-catalogKatalog API podle RFC 9727. Pro /mcp a /a2a uvádí popis, tuto stránku jako dokumentaci a pro /mcp dotaz na stav.
  • /openapi.jsonOpenAPI 3.1: rozhraní HTTP koncového bodu MCP.
  • /.well-known/mcp/server-card.jsonMCP Server Card s adresou, přenosem a seznamem nástrojů serveru MCP.
  • /.well-known/agent-card.jsonA2A Agent Card: endpoint, verze protokolu a schopnosti agenta A2A.
  • /.well-known/agent-skills/index.jsonAdresář Agent Skills. Obsahuje dva návody pro agenty: jak používat nástroje přes MCP a jak pro člověka připravit poptávku služby.
  • /llms.txtStručná verze webu pro jazykové modely, s důležitými stránkami.
  • /llms-full.txtText stránek v jednom souboru.
  • /auth.mdNávod k přihlášení pro agenty. Říká hlavně to, že se tu nikdo přihlašovat nemusí.
  • /robots.txtPravidla pro crawlery. Povoleny jsou všechny, známé AI crawlery jsou uvedeny jednotlivě.

Co se děje se vstupy

Volání přes /mcp nebo /a2a pošle vstupy na náš server, který s nimi počítá a vrací výsledek, aniž by vstupy nebo výsledek trvale ukládal. Jen výsledky síťových kontrol zůstávají s kontrolovanou doménou nebo adresou nejvýše šest minut v operační paměti, bez vazby na volajícího. Protokoluje se jako u každého načtení stránky jen požadavek bez jeho obsahu a co s vašimi údaji dělá sám asistent, upravuje jeho poskytovatel (podrobnosti v zásadách ochrany osobních údajů).

Stejný přístup i pro vaše systémy

To, co tento web nabízí pro svá vlastní data, stavíme i pro firmy: server MCP, přes který AI asistent přistupuje ke skladovému systému nebo databázi, s právy, která si předem určíte. Jak postupujeme, popisuje stránka o integracích MCP.

Zobrazit integrace MCP
+49 3744 4399760Po–Pá 8:00–17:00
ZavolatZpětné volání

KUSOVNÍK · LIST 1/1

Z čeho se tato stránka skládá

Hodnoty jsou změřené při sestavení stránky. Se zapnutým JavaScriptem je váš prohlížeč přeměří živě.

POZ.DÍLTYPVELIKOST
01index.htmlDokument≈ 29 kB
02styles.cssStyly≈ 20 kB
03scripts.jsSkript≈ 13 kB
04archivo-variable.woff2Písmo≈ 58 kB
05ibm-plex-mono.woff2Písmo≈ 30 kB
06favicon.svgGrafika< 1 kB

Reklamní nebo analytické cookies: žádné. Bez vašeho souhlasu stránka nenačítá nic z cizích serverů, jen z naší doručovací služby Cloudflare. Písma, skripty i grafika jsou uložené u nás. Stejně stavíme i vaše IT.

MIMO PROVOZNÍ DOBU

Klidně zavolejte i tak

V kanceláři jsme běžně od pondělí do pátku, 8:00–17:00.

Číslo je k nám přesměrované i večer a o víkendu a často to někdo vezme. Slíbit to ale nemůžeme.

Když se nedovoláte, nechte nám krátký vzkaz v hlasové schránce: jméno, číslo a o co jde. Zavoláme zpět co nejdřív, nejpozději další pracovní den.

Za hovor nic neplatíte. Když se do toho mimo provozní dobu musí někdo pustit hned, platí příplatek podle ceníku.

Zavolat hned+49 3744 4399760

Raději napíšete? Přes kontaktní formulář nebo na [email protected]. Přečteme si to další pracovní den.

DIAGNOSTIKA · AT-K2

Co potřebujete?

↵ VYBRATESC ZAVŘÍTZAVOLAT: +49 3744 4399760

Vlastní nastavení

Které služby se smějí načítat?

Technicky nezbytné

Vaše rozhodnutí z tohoto okna a nastavení barevného režimu a animací. Tyto údaje zůstávají jako drobné záznamy ve vašem zařízení a nikdy se neposílají na žádný server. Jsou nutné pro provoz stránek, a proto je nelze vypnout.