Acces AI · InterfețeREV. 2026-A
Cum accesează asistenții AI acest site
Pe lângă paginile pentru oameni, acest site are intrări pentru programe. Un asistent AI poate astfel să ruleze instrumente din /tools sau să ceară prețurile noastre, în loc să caute cifrele prin pagini. Aici găsiți cum vă conectați și care sunt limitele.
- fără înregistrare
- doar citire
- nu salvează nimic permanent
Actualizat:
01 / PRIVIRE DE ANSAMBLU
Trei intrări, aceleași date ca pe pagini
Server MCP
/mcp
Pentru asistenți care folosesc Model Context Protocol. 54 de instrumente, de la profilul firmei și prețuri până la calculatoarele din /tools.
Endpoint A2A
/a2a
Pentru agenți care folosesc protocolul A2A 1.0. Rulează 50 de instrumente din /tools, cu același calcul ca /mcp.
Markdown
Accept: text/markdown
Dacă un program o cere, o pagină își livrează textul ca Markdown. Browserele primesc în continuare HTML.
Toate trei citesc din aceleași surse ca site-ul. Datele firmei, lista de prețuri și calculul instrumentelor nu sunt întreținute în dublu: dacă se schimbă un tarif orar, după următoarea publicare apare simultan pe /preise și în răspunsul serverului MCP.
02 / SERVER MCP
Conectarea serverului MCP
- Adresă
- https://aureum-tech.com/mcp
- Transport
- Streamable HTTP, JSON-RPC 2.0 prin POST
- Autentificare
- niciuna
- Acces
- doar citire
Un client MCP care integrează servere prin adresă, folosind Streamable HTTP, are nevoie doar de această adresă. Cum se numește exact intrarea, găsiți în instrucțiunile clientului dumneavoastră. Mulți așteaptă o configurație de acest fel:
{
"mcpServers": {
"aureum-website": {
"url": "https://aureum-tech.com/mcp"
}
}
}
Unii clienți cer să indicați în plus și transportul, de regulă ca „http” sau „streamable-http”. Nu este nevoie de cheie sau token.
Ce se întâmplă la o conectare
- initialize: Clientul se conectează fără identificator de sesiune. Răspunsul conține în antet
Mcp-Session-Id, iar clientul trimite acest identificator la fiecare cerere următoare. - notifications/initialized: Clientul confirmă că conectarea s-a încheiat.
- tools/list: Serverul enumeră toate instrumentele, cu descriere și schemă de intrare.
- tools/call: Clientul apelează un instrument cu datele sale de intrare. Rezultatul vine ca JSON în câmpul text al răspunsului.
Așa arată conectarea manuală, de exemplu pentru încercări în terminal:
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"}}}'
Răspunsul vine ca flux de evenimente (text/event-stream), iar identificatorul se află în antetul mcp-session-id. Urmează un apel de instrument cu acest identificator; confirmarea din pasul 2 (notifications/initialized) este omisă aici pentru scurtime, un client o trimite înainte:
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"}}}'
Cine deschide /mcp în browser trimite un GET și primește mesajul „Nur POST (JSON-RPC)”. Acesta este răspunsul corect, nu o defecțiune. Dacă serverul funcționează, aflați la /mcp/health.
Ce instrumente există
Patru instrumente răspund la întrebări despre noi:
firma_und_kontakt: profilul firmei cu adresă, telefon, program de contact și date de registruleistungen_auflisten: toate domeniile de servicii, fiecare cu pagina corespunzătoarepreise_abfragen: tarife orare, deplasare și suplimente, din aceeași sursă ca lista de prețuriwebsite_suchen: căutare în toate paginile de pe aureum-tech.com
La acestea se adaugă 50 din cele 51 de instrumente de pe /tools (toate în afară de verificarea facturii electronice), fiecare sub un nume precum werkzeug_email_check. Calculează cu aceeași logică ca pagina din browser, iar fiecare răspuns indică pagina instrumentului, data actualizării și limitele rezultatului. Ce date de intrare așteaptă un instrument, găsiți pe pagina lui, în secțiunea „Pentru asistenți AI”.
03 / LIMITE
Limite, ca serviciul să funcționeze pentru toți
Serverul este public și nu cunoaște utilizatori. De aceea costul per cerere este plafonat, iar limitările de frecvență ale instrumentelor care interoghează servere externe se aplică tuturor apelurilor la un loc.
| Limită | Valoare | Ce se întâmplă atunci |
|---|---|---|
| Dimensiunea unei cereri | 900 KB | HTTP 413 |
| Sesiuni MCP deschise, toți clienții la un loc | 500 | HTTP 503 cu Retry-After: 30 |
| Sesiune MCP fără activitate | 30 de minute | Sesiunea expiră, clientul primește 404 și se conectează din nou. |
| Timp de răspuns per apel al unui instrument din /tools fără interogare în rețea, inclusiv timpul de așteptare | 10 secunde | Se întrerupe cu un mesaj de eroare al instrumentului |
| Verificare e-mail | 30 de verificări pe minut, 300 de verificări DNS noi pe oră | Instrumentul vă roagă să încercați din nou mai târziu. |
| Verificările pentru servicii terțe, crawlere AI și previzualizare de link | câte 20 de verificări pe minut, câte 150 de verificări noi pe oră | ca la verificarea e-mailului |
| Calculatorul de gas cu valori live | Taxele sunt interogate din nou cel mult o dată pe minut | Răspuns cu valorile din ultimul minut; fără valori live, cu valorile fixe ale paginii și o observație |
Un rezultat aflat încă în memoria cache (cinci minute per domeniu sau adresă) nu intră în plafonul orar. Dacă un instrument raportează el însuși o eroare (limitare de frecvență, depășire de timp, date de intrare inutilizabile), aceasta apare în limba germană în câmpul fehler al răspunsului. Datele de intrare care nu se potrivesc schemei sunt respinse de /a2a cu eroarea JSON-RPC -32602, iar de /mcp cu un răspuns de eroare al SDK-ului MCP.
04 / A2A
Apelarea instrumentelor prin protocolul A2A
- Endpoint
- https://aureum-tech.com/a2a
- Protocol
- A2A 1.0 prin JSON-RPC 2.0
- Antet
- A2A-Version: 1.0
- Metodă
- SendMessage
Agenții care folosesc protocolul A2A apelează aceleași 50 de instrumente prin /a2a. Un mesaj cu o parte de date {"werkzeug": "…", "eingabe": {…}} rulează un instrument, iar răspunsul conține același rezultat ca la /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"
}]
}
}
}'
- Un mesaj doar cu text returnează lista instrumentelor cu câmpurile lor de intrare. Dacă textul conține numele unui instrument, primiți informațiile complete despre el, împreună cu exemple de întrebări.
- Agentul lucrează după reguli fixe și nu înțelege limbaj natural.
- Nu creează sarcini (tasks) și nu salvează nimic. Fiecare răspuns este un mesaj direct, de aceea
ListTasksreturnează o listă goală. - Nu oferă streaming sau notificări push și nu primește fișiere.
- Dacă lipsește antetul
A2A-Version: 1.0, răspunde cu eroarea -32009: specificația interpretează lipsa indicației ca versiunea 0.3.
Cele patru instrumente pentru profilul firmei, servicii, prețuri și căutare există doar prin /mcp. Pentru /a2a se aplică aceeași limită de dimensiune a corpului cererii, aceeași limită de timp și aceleași limitări de frecvență. Descrierea pentru programe se află în Agent Card.
05 / MARKDOWN
Paginile ca Markdown
Cine cere o pagină cu antetul Accept: text/markdown primește, în loc de HTML, textul ei ca Markdown, fără navigare și scripturi. Browserele nu trimit niciodată această indicație și văd pagina ca de obicei. Variantele se generează la construirea site-ului din paginile finalizate și sunt deci la fel de actuale ca acestea.
curl -H "Accept: text/markdown" https://aureum-tech.com/preise
Răspunsul poartă Content-Type: text/markdown; charset=utf-8 și Vary: Accept. Fac excepție prezentarea generală a ghidurilor și articolele de specialitate din sistemul editorial: ambele se completează abia la cerere, așa că pentru ele se livrează în continuare HTML. Textul acestor pagini într-un singur fișier îl oferă /llms-full.txt.
06 / FIȘIERE DE DESCRIERE
Unde pot programele să afle ce există
Aceste fișiere descriu intrările în formate pe care agenții și programele de verificare le caută singure. Pagina principală trimite, în antetul Link al răspunsului ei, la catalogul API, la descrierea OpenAPI și la această pagină.
- /.well-known/api-catalogCatalog API conform RFC 9727. Indică pentru /mcp și /a2a descrierea, această pagină ca documentație și, pentru /mcp, interogarea de stare.
- /openapi.jsonOpenAPI 3.1: interfața HTTP a endpointului MCP.
- /.well-known/mcp/server-card.jsonMCP Server Card cu adresa, transportul și lista de instrumente ale serverului MCP.
- /.well-known/agent-card.jsonA2A Agent Card: endpointul, versiunea protocolului și capabilitățile agentului A2A.
- /.well-known/agent-skills/index.jsonRegistrul Agent Skills. Conține două instrucțiuni pentru agenți: folosirea instrumentelor prin MCP și pregătirea unei solicitări de serviciu pentru o persoană.
- /llms.txtVarianta scurtă a site-ului pentru modelele de limbaj, cu paginile importante.
- /llms-full.txtTextul paginilor într-un singur fișier.
- /auth.mdInstrucțiuni de autentificare pentru agenți. Spune mai ales că aici nu există autentificare.
- /robots.txtReguli pentru crawlere. Sunt admise toate; crawlerele AI cunoscute sunt enumerate individual.
07 / PROTECȚIA DATELOR
Ce se întâmplă cu datele introduse
Un apel prin /mcp sau /a2a trimite datele introduse către serverul nostru, care calculează cu ele și returnează rezultatul, fără a salva permanent datele sau rezultatul. Doar rezultatele verificărilor de rețea rămân în memoria de lucru, împreună cu domeniul sau adresa verificată, cel mult șase minute, fără legătură cu cel care a făcut apelul. Se înregistrează, ca la orice accesare de pagină, doar cererea, fără conținutul ei, iar ce face asistentul însuși cu datele dumneavoastră stabilește furnizorul său (detalii în Politica de confidențialitate).
08 / PENTRU FIRMA DUMNEAVOASTRĂ
Un astfel de acces pentru sistemele dumneavoastră
Ce oferă acest site pentru propriile sale date construim și pentru firme: un server MCP prin care un asistent AI accesează programul de gestiune a mărfurilor sau o bază de date, cu drepturi pe care le stabiliți dumneavoastră în prealabil. Cum procedăm, găsiți pe pagina despre integrări MCP.
Vedeți integrările MCP