ШІ-доступ · ІнтерфейсиREV. 2026-A

Як ШІ-асистенти користуються цим сайтом

Окрім сторінок для людей, на цьому сайті є входи для програм. Через них ШІ-асистент може запустити інструменти з /tools або запитати наші ціни, замість того щоб шукати цифри на сторінках. Тут описано, як підключитися і де межі.

  • без реєстрації
  • лише читання
  • нічого не зберігає постійно

Станом на

Три входи, ті самі дані, що й на сторінках

MCP-сервер

/mcp

Для асистентів, які працюють за Model Context Protocol. 54 інструменти: від профілю компанії та цін до калькуляторів із /tools.

Кінцева точка A2A

/a2a

Для агентів за протоколом A2A 1.0. Виконує 50 інструментів із /tools, з тим самим розрахунком, що й /mcp.

Markdown

Accept: text/markdown

Якщо програма просить, сторінка віддає свій текст у форматі Markdown. Браузери, як і раніше, отримують HTML.

ВИКЛИК ІНСТРУМЕНТАШІ-АСИСТЕНТ/mcp АБО /a2aРОЗРАХУНОК ЯКНА /toolsВІДПОВІДЬ ЗДЖЕРЕЛОЧИТАННЯ СТОРІНКИАГЕНТСТОРІНКАТЕКСТ У MARKDOWNВИКЛИК ІНСТРУМЕНТАШІ-АСИСТЕНТ/mcp АБО /a2aРОЗРАХУНОК ЯК НА /toolsВІДПОВІДЬ ІЗ ДЖЕРЕЛОМЧИТАННЯ СТОРІНКИАГЕНТСТОРІНКАТЕКСТ У MARKDOWN
МАЛ. 1 · ДВА ШЛЯХИ ДО ТИХ САМИХ ДАНИХЗОЛОТЕ = ВХІД ДЛЯ ПРОГРАМ

Усі три читають з тих самих джерел, що й сайт. Основні дані, прайс-лист і розрахунок інструментів ніде не ведуться двічі: якщо погодинна ставка змінюється, після наступного оновлення вона одночасно з’являється на сторінці /preise і у відповіді MCP-сервера.

Підключення до MCP-сервера

Адреса
https://aureum-tech.com/mcp
Транспорт
Streamable HTTP, JSON-RPC 2.0 через POST
Автентифікація
немає
Доступ
лише читання

MCP-клієнту, який підключає сервери за адресою через Streamable HTTP, потрібна лише ця адреса. Як саме називається запис, сказано в інструкції до вашого клієнта. Багато клієнтів очікують конфігурацію такого вигляду:

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

Деякі клієнти додатково потребують вказання транспорту, здебільшого «http» або «streamable-http». Ключ чи токен не потрібні.

Що відбувається під час підключення

  1. initialize: клієнт підключається без ідентифікатора сеансу. У заголовку відповіді міститься Mcp-Session-Id, і цей ідентифікатор клієнт надсилає з кожним наступним запитом.
  2. notifications/initialized: клієнт підтверджує, що підключення завершено.
  3. tools/list: сервер перелічує всі інструменти з описом і схемою вхідних даних.
  4. tools/call: клієнт викликає інструмент зі своїми вхідними даними. Результат приходить як JSON у текстовому полі відповіді.

Ось як виглядає підключення вручну, наприклад щоб спробувати в терміналі:

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

Відповідь приходить як потік подій (text/event-stream), ідентифікатор міститься в заголовку mcp-session-id. Виклик інструмента з цим ідентифікатором; підтвердження з кроку 2 (notifications/initialized) тут для стислості пропущено, клієнт надсилає його раніше:

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

Якщо відкрити /mcp у браузері, він надсилає GET і отримує повідомлення «Nur POST (JSON-RPC)». Це правильна відповідь, а не збій. Чи працює сервер, показує /mcp/health.

Які є інструменти

Чотири інструменти відповідають на запитання про нас:

  • firma_und_kontakt: профіль компанії з адресою, телефоном, часом доступності та реєстровими даними
  • leistungen_auflisten: усі напрями послуг, кожен зі сторінкою про нього
  • preise_abfragen: погодинні ставки, виїзд і доплати з того самого джерела, що й прайс-лист
  • website_suchen: пошук по всіх сторінках aureum-tech.com

Додатково доступні 50 із 51 інструмента з /tools (усі, крім перевірки е-рахунку), кожен під назвою на кшталт werkzeug_email_check. Вони рахують за тією самою логікою, що й сторінка в браузері, а кожна відповідь вказує сторінку інструмента, дату даних і межі результату. Які вхідні дані очікує інструмент, написано на його сторінці в розділі «Для ШІ-асистентів».

Межі, щоб сервіс працював для всіх

Сервер публічний і не має облікових записів користувачів. Тому вартість кожного запиту обмежена, а обмеження частоти для інструментів, які звертаються до сторонніх серверів, діють на всі виклики разом.

Межі /mcp і /a2a
МежаЗначенняЩо тоді відбувається
Розмір запиту900 КБHTTP 413
Відкриті сеанси MCP, усі клієнти разом500HTTP 503 з Retry-After: 30
Сеанс MCP без активності30 хвилинСеанс спливає, клієнт отримує 404 і підключається заново.
Час відповіді на кожен виклик інструмента з /tools без мережевого запиту, разом з очікуванням10 секундПереривання з повідомленням про помилку від інструмента
Перевірка e-mail30 перевірок на хвилину, 300 нових перевірок DNS на годинуІнструмент просить повторити спробу пізніше.
Перевірка сторонніх сервісів, ШІ-краулерів і попереднього перегляду посиланьпо 20 перевірок на хвилину, по 150 нових перевірок на годинуяк у перевірці e-mail
Калькулятор плати за газ із даними в реальному часіКомісії запитуються заново щонайбільше раз на хвилинуВідповідь зі значеннями за останню хвилину; без даних у реальному часі — із фіксованим станом сторінки та приміткою

Результат, що ще лежить у кеші (п’ять хвилин для домену чи адреси), до годинного ліміту не входить. Якщо інструмент сам повідомляє про помилку (обмеження частоти, перевищення часу, непридатні вхідні дані), вона наводиться німецькою в полі fehler відповіді. Вхідні дані, що не відповідають схемі, /a2a відхиляє з помилкою JSON-RPC -32602, а /mcp — з відповіддю про помилку від MCP SDK.

Виклик інструментів за протоколом A2A

Кінцева точка
https://aureum-tech.com/a2a
Протокол
A2A 1.0 через JSON-RPC 2.0
Заголовок
A2A-Version: 1.0
Метод
SendMessage

Агенти, які працюють за протоколом A2A, викликають ті самі 50 інструментів через /a2a. Повідомлення з частиною даних {"werkzeug": "…", "eingabe": {…}} виконує інструмент, а відповідь містить той самий результат, що й у /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"
        }]
      }
    }
  }'
  • Повідомлення лише з текстом повертає перелік інструментів з їхніми полями вхідних даних. Якщо в тексті названо інструмент, приходять його повні дані разом із прикладами запитань.
  • Агент працює за чіткими правилами й не розуміє вільної мови.
  • Він не створює завдань (tasks) і нічого не зберігає. Кожна відповідь — пряме повідомлення, тому ListTasks повертає порожній список.
  • Потокової передачі та push-сповіщень він не пропонує, файлів не приймає.
  • Якщо заголовок A2A-Version: 1.0 відсутній, він відповідає помилкою -32009: специфікація трактує відсутнє значення як версію 0.3.

Чотири інструменти щодо профілю компанії, послуг, цін і пошуку доступні лише через /mcp. Для /a2a діють той самий ліміт розміру тіла запиту, той самий ліміт часу й ті самі обмеження частоти. Опис для програм міститься в Agent Card.

Сторінки у форматі Markdown

Хто запитує сторінку із заголовком Accept: text/markdown, отримує замість HTML її текст у форматі Markdown, без навігації та скриптів. Браузери ніколи не надсилають цей заголовок і показують сторінку як завжди. Ці версії створюються під час збирання сайту з готових сторінок, тож вони такі ж актуальні, як і сайт.

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

Відповідь містить Content-Type: text/markdown; charset=utf-8 і Vary: Accept. Винятки — огляд порадника і фахові статті з редакційної системи: вони заповнюються лише під час запиту, тому там і надалі приходить HTML. Текст цих сторінок одним файлом віддає /llms-full.txt.

Де програми дізнаються, що тут є

Ці файли описують входи у форматах, які агенти й програми перевірки шукають самі. Головна сторінка в заголовку Link своєї відповіді посилається на каталог API, опис OpenAPI та цю сторінку.

  • /.well-known/api-catalogКаталог API за RFC 9727. Для /mcp і /a2a він указує опис, цю сторінку як документацію, а для /mcp — запит стану.
  • /openapi.jsonOpenAPI 3.1: HTTP-інтерфейс кінцевої точки MCP.
  • /.well-known/mcp/server-card.jsonMCP Server Card з адресою, транспортом і переліком інструментів MCP-сервера.
  • /.well-known/agent-card.jsonA2A Agent Card: кінцева точка, версія протоколу та можливості A2A-агента.
  • /.well-known/agent-skills/index.jsonКаталог Agent Skills. У ньому дві інструкції для агентів: як користуватися інструментами через MCP і як підготувати для людини запит на послугу.
  • /llms.txtКоротка версія сайту для мовних моделей з найважливішими сторінками.
  • /llms-full.txtТекст сторінок в одному файлі.
  • /auth.mdІнструкція з автентифікації для агентів. Головне в ній: тут немає автентифікації.
  • /robots.txtПравила для краулерів. Доступ дозволено всім, відомі ШІ-краулери перелічені окремо.

Що відбувається з вхідними даними

Виклик через /mcp або /a2a надсилає вхідні дані на наш сервер, який проводить розрахунок і повертає результат, не зберігаючи ні вхідних даних, ні результату постійно. Лише результати мережевих перевірок разом із перевіреним доменом чи адресою залишаються в оперативній пам’яті не довше шести хвилин, без зв’язку з тим, хто викликав. Як і при кожному відкритті сторінки, у журнал записується лише сам запит без його вмісту, а що асистент робить із вашими даними, визначає його постачальник (подробиці в політиці конфіденційності).

Такий доступ до ваших власних систем

Те, що цей сайт пропонує для власних даних, ми робимо й для підприємств: MCP-сервер, через який ШІ-асистент має доступ до товарообліку чи бази даних, з правами, які ви визначаєте наперед. Як ми діємо, описано на сторінці про MCP-інтеграції.

Переглянути MCP-інтеграції
+49 3744 4399760Пн–Пт 8:00–17:00
ЗателефонуватиЗворотний дзвінок

ПЕРЕЛІК СКЛАДНИКІВ · АРКУШ 1/1

З чого складається ця сторінка

Значення виміряно під час збирання сайту, а з JavaScript ваш браузер перемірює їх наживо.

ПОЗ.СКЛАДНИКТИПРОЗМІР
01index.htmlДокумент≈ 29 КБ
02styles.cssТаблиця стилів≈ 20 КБ
03scripts.jsСкрипт≈ 13 КБ
04archivo-variable.woff2Шрифт≈ 58 КБ
05ibm-plex-mono.woff2Шрифт≈ 30 КБ
06favicon.svgГрафіка< 1 КБ

Рекламних чи аналітичних cookie: немає. Без вашої згоди сторінка нічого не завантажує зі сторонніх серверів, крім нашого сервісу доставки Cloudflare: шрифти, скрипти й графіка зберігаються в нас. Так само ми будуємо і вашу IT-інфраструктуру.

ПОЗА РОБОЧИМ ЧАСОМ

Телефонуйте все одно

Зазвичай ми в офісі Пн–Пт 8:00–17:00.

Увечері та у вихідні дзвінки на цей номер теж переадресовуються до нас, і часто хтось відповідає. Але обіцяти цього ми не можемо.

Якщо ніхто не відповів, залиште коротке голосове повідомлення: ім’я, номер і в чому справа. Ми передзвонимо якнайшвидше, не пізніше наступного робочого дня.

Розмова нічого не коштує. Якщо поза робочим часом потрібно, щоб хтось узявся до роботи негайно, діє надбавка з прайс-листа.

Зателефонувати зараз+49 3744 4399760

Вам зручніше написати? Через контактну форму або на [email protected]. Прочитаємо наступного робочого дня.

ДІАГНОСТИКА · AT-K2

Що сталося?

↵ ВИБРАТИESC ЗАКРИТИЗАТЕЛЕФОНУВАТИ: +49 3744 4399760

Власні налаштування

Які сервіси можна завантажувати?

Технічно необхідні

Рішення, яке ви тут ухвалите, а також налаштування колірної схеми та анімації. Ці дані зберігаються як невеликі записи на вашому пристрої й ніколи не надсилаються на сервер. Вони потрібні для роботи сайту, тому їх не можна вимкнути.