Доступ для ИИ · ИнтерфейсыРЕД. 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 (все, кроме проверки электронных счетов, E-Rechnung), каждый под именем вроде 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-интеграции