ИИ-агенту

Краткая справка для ИИ-агента: адрес MCP-сервера, llms.txt и правила работы с API.

Машинно-ориентированная справка для ИИ-агента, работающего с Typizer по MCP или напрямую по REST API.

MCP-сервер: https://api.typizer.ru/mcp, авторизация — Authorization: Bearer <ключ>. Инструменты: list_typizers, get_typizer, create_typizer, update_typizer, extract, get_run, list_runs, get_balance. Подробности и параметры — справочник MCP; подключение клиентов — «Подключение через MCP».
Без MCP: тот же API напрямую по REST, ключ как Authorization: Bearer tz_live_… — см. «Первый вызов API».
llms.txt и llms-full.txt: машиночитаемая карта и полный текст документации в Markdown на https://docs.typizer.ru/llms.txt и https://docs.typizer.ru/llms-full.txt. У каждой страницы есть markdown-версия по тому же пути с .md.
Идемпотентность: отправляйте Idempotency-Key (extract в MCP принимает idempotency_key) — повтор с теми же аргументами в течение 24 часов не создаёт новый прогон и не тарифицируется повторно. Подробнее — «Обработка ошибок и повторов».
Тарификация: страницы списываются с баланса при создании прогона; упавший прогон не тарифицируется; режим precise считает страницы с множителем. Подробнее — «Тарификация страниц».
Лимиты: размер файла, число страниц и число полей схемы ограничены константами — см. «Лимиты».
Большие файлы: передавайте file_url (публичная ссылка) или file_base64 + filename — без предварительной подписанной ссылки. Подробнее — «Большие файлы».