ШІ-доступ · ІнтерфейсиREV. 2026-A
Як ШІ-асистенти користуються цим сайтом
Окрім сторінок для людей, на цьому сайті є входи для програм. Через них ШІ-асистент може запустити інструменти з /tools або запитати наші ціни, замість того щоб шукати цифри на сторінках. Тут описано, як підключитися і де межі.
- без реєстрації
- лише читання
- нічого не зберігає постійно
Станом на
01 / ОГЛЯД
Три входи, ті самі дані, що й на сторінках
MCP-сервер
/mcp
Для асистентів, які працюють за Model Context Protocol. 54 інструменти: від профілю компанії та цін до калькуляторів із /tools.
Кінцева точка A2A
/a2a
Для агентів за протоколом A2A 1.0. Виконує 50 інструментів із /tools, з тим самим розрахунком, що й /mcp.
Markdown
Accept: text/markdown
Якщо програма просить, сторінка віддає свій текст у форматі Markdown. Браузери, як і раніше, отримують HTML.
Усі три читають з тих самих джерел, що й сайт. Основні дані, прайс-лист і розрахунок інструментів ніде не ведуться двічі: якщо погодинна ставка змінюється, після наступного оновлення вона одночасно з’являється на сторінці /preise і у відповіді MCP-сервера.
02 / 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». Ключ чи токен не потрібні.
Що відбувається під час підключення
- initialize: клієнт підключається без ідентифікатора сеансу. У заголовку відповіді міститься
Mcp-Session-Id, і цей ідентифікатор клієнт надсилає з кожним наступним запитом. - notifications/initialized: клієнт підтверджує, що підключення завершено.
- tools/list: сервер перелічує всі інструменти з описом і схемою вхідних даних.
- 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. Вони рахують за тією самою логікою, що й сторінка в браузері, а кожна відповідь вказує сторінку інструмента, дату даних і межі результату. Які вхідні дані очікує інструмент, написано на його сторінці в розділі «Для ШІ-асистентів».
03 / МЕЖІ
Межі, щоб сервіс працював для всіх
Сервер публічний і не має облікових записів користувачів. Тому вартість кожного запиту обмежена, а обмеження частоти для інструментів, які звертаються до сторонніх серверів, діють на всі виклики разом.
| Межа | Значення | Що тоді відбувається |
|---|---|---|
| Розмір запиту | 900 КБ | HTTP 413 |
| Відкриті сеанси MCP, усі клієнти разом | 500 | HTTP 503 з Retry-After: 30 |
| Сеанс MCP без активності | 30 хвилин | Сеанс спливає, клієнт отримує 404 і підключається заново. |
| Час відповіді на кожен виклик інструмента з /tools без мережевого запиту, разом з очікуванням | 10 секунд | Переривання з повідомленням про помилку від інструмента |
| Перевірка e-mail | 30 перевірок на хвилину, 300 нових перевірок DNS на годину | Інструмент просить повторити спробу пізніше. |
| Перевірка сторонніх сервісів, ШІ-краулерів і попереднього перегляду посилань | по 20 перевірок на хвилину, по 150 нових перевірок на годину | як у перевірці e-mail |
| Калькулятор плати за газ із даними в реальному часі | Комісії запитуються заново щонайбільше раз на хвилину | Відповідь зі значеннями за останню хвилину; без даних у реальному часі — із фіксованим станом сторінки та приміткою |
Результат, що ще лежить у кеші (п’ять хвилин для домену чи адреси), до годинного ліміту не входить. Якщо інструмент сам повідомляє про помилку (обмеження частоти, перевищення часу, непридатні вхідні дані), вона наводиться німецькою в полі fehler відповіді. Вхідні дані, що не відповідають схемі, /a2a відхиляє з помилкою JSON-RPC -32602, а /mcp — з відповіддю про помилку від MCP SDK.
04 / A2A
Виклик інструментів за протоколом 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.
05 / MARKDOWN
Сторінки у форматі 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.
06 / ФАЙЛИ ОПИСУ
Де програми дізнаються, що тут є
Ці файли описують входи у форматах, які агенти й програми перевірки шукають самі. Головна сторінка в заголовку 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Правила для краулерів. Доступ дозволено всім, відомі ШІ-краулери перелічені окремо.
07 / ЗАХИСТ ДАНИХ
Що відбувається з вхідними даними
Виклик через /mcp або /a2a надсилає вхідні дані на наш сервер, який проводить розрахунок і повертає результат, не зберігаючи ні вхідних даних, ні результату постійно. Лише результати мережевих перевірок разом із перевіреним доменом чи адресою залишаються в оперативній пам’яті не довше шести хвилин, без зв’язку з тим, хто викликав. Як і при кожному відкритті сторінки, у журнал записується лише сам запит без його вмісту, а що асистент робить із вашими даними, визначає його постачальник (подробиці в політиці конфіденційності).
08 / ДЛЯ ВАШОГО ПІДПРИЄМСТВА
Такий доступ до ваших власних систем
Те, що цей сайт пропонує для власних даних, ми робимо й для підприємств: MCP-сервер, через який ШІ-асистент має доступ до товарообліку чи бази даних, з правами, які ви визначаєте наперед. Як ми діємо, описано на сторінці про MCP-інтеграції.
Переглянути MCP-інтеграції