# Auth.md

Доступ агентов к API издательства «Олимп-Бизнес».

<!-- Заголовок «Auth.md» — это ожидаемая точка входа спецификации: сканеры
     ищут именно её, чтобы отличить файл регистрации агента от произвольной
     страницы документации. Человекочитаемое название идёт следом. -->

Каталог книг открыт для чтения без регистрации. Токен не требуется.

## Что доступно

| Ресурс | Метод | Область |
|---|---|---|
| `https://www.olbuss.ru/api/v1/catalog` | GET | `catalog:read` |
| `https://www.olbuss.ru/api/health` | GET | публично |
| `https://www.olbuss.ru/api/mcp` | POST | `catalog:read` |

## Анонимная идентификация

Если агенту нужно представиться (например, для учёта обращений), можно получить
анонимное удостоверение — привилегий оно не добавляет, область та же `catalog:read`.

```
POST https://www.olbuss.ru/agent/identity/
Content-Type: application/json

{"agent_name": "example-agent"}
```

Ответ содержит `registration_id` и подписанное `identity_assertion`.
Передавайте его заголовком `Authorization: Bearer <identity_assertion>`.

## Подтверждение владельцем

`POST https://www.olbuss.ru/agent/identity/claim/` отвечает `not_offered`: каталог публичен,
отдельного подтверждения агента владельцем не предусмотрено.

## Метаданные

- Сервер авторизации: `https://www.olbuss.ru/.well-known/oauth-authorization-server`
- Защищаемый ресурс: `https://www.olbuss.ru/.well-known/oauth-protected-resource`
- Карточка MCP-сервера: `https://www.olbuss.ru/.well-known/mcp/server-card.json`

## Правила использования

Content-Signal в `robots.txt`: поиск — да, использование в ответах ИИ — да,
обучение моделей — нет. Пожалуйста, указывайте источник со ссылкой на страницу книги.