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
01 / PŘEHLED
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.
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.
02 / SERVER 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
- initialize: Klient se přihlásí bez identifikátoru relace. Odpověď nese v hlavičce
Mcp-Session-Ida tento identifikátor klient posílá s každým dalším požadavkem. - notifications/initialized: Klient potvrdí, že přihlášení je dokončeno.
- tools/list: Server vypíše všechny nástroje s popisem a vstupním schématem.
- 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 údajileistungen_auflisten: všechny oblasti služeb, vždy s příslušnou stránkoupreise_abfragen: hodinové sazby, doprava a příplatky ze stejného zdroje jako ceníkwebsite_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“.
03 / MEZE
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.
| Mez | Hodnota | Co se pak stane |
|---|---|---|
| Velikost požadavku | 900 KB | HTTP 413 |
| Otevřené relace MCP, všichni klienti dohromady | 500 | HTTP 503 s Retry-After: 30 |
| Relace MCP bez aktivity | 30 minut | Relace 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 sekund | Přerušení s chybovým hlášením nástroje |
| Kontrola e-mailu | 30 kontrol za minutu, 300 nových kontrol DNS za hodinu | Ná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 hodinu | jako u kontroly e-mailu |
| Kalkulačka gasu s živými hodnotami | Poplatky se znovu načítají nejvýše jednou za minutu | Odpověď 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.
04 / A2A
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,
ListTasksproto 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.
05 / MARKDOWN
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.
06 / POPISNÉ SOUBORY
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ě.
07 / OCHRANA OSOBNÍCH ÚDAJŮ
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ů).
08 / PRO VAŠI FIRMU
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