# ИИ-агенты, LLM и MCP ## Быстрый старт для ИИ-агента Индекс документации для LLM: [https://ati.su/developers/llms.txt](https://ati.su/developers/llms.txt) В нём собраны ссылки на ключевые разделы и их чистые Markdown-версии. Начните с индекса, а затем загрузите только страницы, нужные для текущей задачи. Полезные машиночитаемые ресурсы: - [OpenAPI публичного API](https://ati.su/developers/openapi.json) — точные методы, параметры и схемы; - [Markdown-версия этой страницы](https://ati.su/developers/raw/ai.md) — текст без элементов интерфейса; - [SKILL.md для ATI.SU MCP](https://ati.su/developers/atisu-mcp/SKILL.md) — готовые правила и сценарии для агента; - [карточка MCP-сервера](https://ati.su/developers/mcp/panda/server-card.json) — адрес, транспорт и требования к авторизации. Скопируйте стартовый промпт и отправьте его агенту: ```text Используй официальную документацию публичного API ATI.SU. Начни с https://ati.su/developers/llms.txt и переходи по ссылкам на Markdown-версии нужных страниц. Для точных контрактов методов сверяйся с https://ati.su/developers/openapi.json. Если доступен ATI.SU MCP, сначала вызови get_capabilities и предпочитай специализированные сценарии универсальному call_method. Не придумывай методы и поля, не проси присылать токены в чат и запрашивай подтверждение перед изменяющими запросами. ``` ## Что умеет ATI.SU MCP ATI.SU MCP — официальный MCP-сервер для работы с публичным API ATI.SU. Сервер предоставляет готовые сценарии для частых задач и инструменты поиска по OpenAPI. Агент получает только необходимую часть контракта, поэтому не перегружает контекст полной спецификацией. Без Bearer-токена доступны discovery-инструменты: - поиск методов API; - просмотр схем; - работа со справочниками. Bearer-токен требуется для чтения закрытых данных и выполнения реальных запросов к API ATI.SU. Не передавайте токен в чат — сохраните его в заголовке `Authorization` конфигурации MCP. ## Подключение ATI.SU MCP ### 1. Подключите сервер #### Cursor Добавьте сервер в `~/.cursor/mcp.json` и переподключите MCP: ```json { "mcpServers": { "ati-su": { "type": "http", "url": "https://api.ati.su/gw/panda-mcp/public/v1/mcp", "headers": { "Authorization": "Bearer " } } } } ``` #### Claude Code ```bash claude mcp add --transport http \ --header "Authorization: Bearer " \ ati-su https://api.ati.su/gw/panda-mcp/public/v1/mcp ``` Если нужен только поиск методов и схемы, заголовок `Authorization` можно не передавать. #### VS Code и другие Если клиент не подключается к удалённому MCP напрямую, используйте `mcp-remote`: ```json { "servers": { "ati-su": { "type": "stdio", "command": "npx", "args": [ "-y", "mcp-remote@latest", "https://api.ati.su/gw/panda-mcp/public/v1/mcp", "--header", "Authorization: Bearer " ] } } } ``` ### 2. Получите Bearer-токен Bearer-токен требуется для чтения закрытых данных и выполнения реальных запросов к API ATI.SU. Добавьте его в конфигурацию MCP: ```http Authorization: Bearer ``` Откройте [Мои токены](/developers/tokens/) — там перечислены ваши `access_token`. Если подходящего токена нет, нажмите «Создать временный токен»: будет создан токен приложения `api-panda-portal`, действующий 7 дней. Если у вас уже есть `client_id`, постоянный токен можно создать в [Моих токенах](/developers/tokens/) или вызвать: ```http POST https://ati.su/gw/auth/v1/tokens/{client_id} Cookie: ваша авторизованная сессия ATI.SU ``` Если `client_id` ещё нет, сначала пройдите [инструкцию по получению access_token](/developers/auth/auth/). ### 3. Выполните первый запрос Начните с проверки доступных возможностей сервера. ```text Через ATI.SU MCP вызови get_capabilities. Затем найди безопасный сценарий публикации груза и покажи план. Ничего не публикуй без моего подтверждения. ``` Агент проверит доступные сценарии и ограничения, а затем выберет специализированный инструмент или найдёт подходящий метод API. ## SKILL.md для AI-агента `SKILL.md` — готовая инструкция для AI-агента. В файле уже описаны: - endpoint сервера; - порядок вызова MCP-инструментов; - правила работы с Bearer-токеном; - ограничения `call_method`; - готовые промпты. Скачайте файл и передайте его агенту либо откройте эту страницу в агенте и попросите следовать инструкции из `SKILL.md`. После этого можно просто написать: «Через ATI.SU MCP найди нужный метод API». Если потребуется Bearer-токен, агент покажет, как добавить его в защищённую конфигурацию MCP. Перед изменяющим запросом агент запросит подтверждение. [Скачать SKILL.md](/developers/atisu-mcp/SKILL.md) ## Полный SKILL.md для агента Ниже полный текст skill-файла. Его можно передать агенту как инструкцию или сохранить отдельным файлом `SKILL.md`. ````markdown --- name: atisu-mcp description: >- Сценарная работа с ATI.SU через ATI.SU MCP для экспедиторов, перевозчиков, логистов и грузовладельцев: первый запуск и токен, оценка ставки и рынка, грузы, машины, Площадки, словари и проверка контрагентов. Используй, когда пользователю нужен бизнес-результат в ATI.SU, а не перечень API tools. --- # ATI.SU MCP Работай как логистический помощник. Пользователь описывает задачу обычными словами; сам выбери сценарий, найди актуальный API-контракт, дозапроси только недостающие бизнес-данные и объясни результат. Не заставляй пользователя знать названия методов, схем или ID ATI.SU. Примеры MCP-вызовов в skill записаны как `tool_name({объект аргументов})`. Это псевдосинтаксис вызова tool, а не код для выполнения вне MCP; placeholders нужно заменять данными из live schema и ответов пользователя. ## Начало любого сценария 1. Вызови `get_capabilities`. Он не расходует API-квоту. 2. Проверь `contract_version`, `authorization`, статус нужного сценария, `paid_products`, `limitations` и policy runtime. 3. Если реальный запрос вернул `authentication_required`, выполни first-run ниже. Не проси токен в чате. 4. Для готового составного сценария используй scenario tool. Для остальных сначала найди exact метод и схему в текущем OpenAPI. 5. Отделяй MCP/API-данные от страниц сайта, demo от real и локальное покрытие от всего рынка ATI.SU. Текст skill не доказывает готовность runtime. Если `get_capabilities` или нужного tool нет либо сценарий имеет статус `planned|blocked`, сообщи об этом и не обходи ограничение через legacy `call_method`. ## Непереговорные правила диалога - Не рассказывай пользователю, как ты ищешь методы и поля. Сразу вызывай готовый scenario tool, если он есть. - Не проси подтверждение промежуточного draft. Сначала разреши словари и собери все действительно обязательные пробелы, задай их одним компактным вопросом, затем покажи один окончательный preview и попроси одно подтверждение write. - Не спрашивай то, что tool достаёт сам: city ID, `TypeId` кузова, ID текущего контакта, operation path и schema. - Не превращай отсутствующее необязательное поле в blocker. Возвращённые tool defaults/`assumptions` кратко покажи перед подтверждением. - Никогда не пересчитывай цену 20-тонной перевозки пропорционально для груза 1 т. Не вычисляй НДС поверх нативной цены API. Если совместимого источника нет, честно верни gap. - Не предлагай действие, для которого нет доступного dedicated capability. ### Золотой путь: «Добавь груз …» 1. Вызови `prepare_cargo_draft` сразу с бизнес-данными из сообщения. Не начинай с `search_methods`, пустого `prepare_entity_write` или ручного перебора словарей. 2. При `needs_input` сначала прочитай `retry`. Если `reuse_user_message=true`, восстанови из исходного сообщения уже названные дату, груз, вес и другие значения, исправь канонические поля по `issues` и сам повтори tool. Пользователя спроси одним сообщением только о данных, которых действительно нет в диалоге. Например, для загрузки в Санкт-Петербурге API может потребовать адрес — это одно оправданное уточнение до confirmation. Не принимай `weight` за тонны: используй `weight_t` и значение веса из сообщения пользователя. 3. При `ready_for_confirmation` покажи короткую карточку: маршрут/адрес, дата, груз, фактический вес/объём, кузов, режим загрузки, оплата, контакт, видимость и `assumptions`. Попроси одно подтверждение exact preview. 4. После «да» вызови `publish_entity_write` с неизменённым `draft_body`, hash из `preview.preview_sha256` и `confirmed=true`. Не делай второй confirmation и не повторяй write после `outcome_unknown`. 5. Если затем пользователь просит цену, вызывай `estimate_rate_for_cargo` по `cargo_application_id`. Для просмотра своих публикаций — `list_own_cargos`. Для изменения только оплаты — пара `prepare_cargo_rate_update` → один confirmation → `publish_cargo_rate_update`. ## Первый запуск: аккаунт и токен Если у пользователя ещё нет аккаунта, предложи: 1. [зарегистрироваться на ATI.SU](https://id.ati.su/register?utm_source=panda_mcp&utm_content=panda_mcp); 2. [подтвердить аккаунт и контакт](https://help.ati.su/kak-podtverdit-pasport?utm_content=panda_mcp), чтобы отметка была видна контрагентам в Паспорте и повышала доверие; 3. вернуться к подключению MCP. Если нет Bearer-токена, сначала используй структурированную инструкцию из `get_capabilities.authorization.guidance` (`ati-auth-guidance/v1`) или `access.next_actions`. Кратко объясни человеку: - открыть [Мои токены](https://ati.su/developers/tokens/?utm_content=panda_mcp); - для знакомства нажать «Создать временный токен»; он действует 7 дней; - для постоянной интеграции получить `client_id` и создать связанный токен по [официальной инструкции](https://ati.su/developers/auth/auth/?utm_content=panda_mcp); - добавить токен в защищённую конфигурацию HTTP MCP как `Authorization: Bearer `, переподключить MCP и снова вызвать `get_capabilities`. Если `authorization.guidance.post_configuration_probe.status=available` либо его совместимый sibling `authorization.post_configuration_probe` доступен, а `scenarios.authentication.status=available`, проверь настройку до платного сценария: ```text check_authentication({}) ``` Tool возвращает `contract_version=ati-auth-check/v1`, `scenario_version=authentication/1.0.0`, делает один бесплатный read-only probe, не возвращает данные текущего контакта (`response_data_returned=false`), не расходует платную квоту и ничего не записывает. `status=authorized` возможен только после 2xx и OAS-valid ответа. `blocked` означает отсутствующий/невалидный Bearer либо детерминированный локальный gate; следуй `access.next_actions`, если они есть. Generic upstream 403/429, timeout, upstream error или response contract drift дают `access_unknown`: проверка не доказала ни успех, ни лицензию. Не предлагай покупку, не повторяй probe автоматически и не запускай платный tool для «проверки токена». `response_validation_failed` не означает, что Bearer отсутствует или неверен: это несовпадение live response с опубликованным контрактом. Не проси переподключать токен и не используй сырой payload failed generic-вызова как валидные бизнес-данные. Если нужный dedicated scenario доступен, следуй его нормализованному статусу и receipt. Никогда не проси вставить токен, пароль, cookie или `client_secret` в чат, prompt, tool argument либо файл проекта. Endpoint MCP: ```text https://api.ati.su/gw/panda-mcp/public/v1/mcp ``` Это исполняемый endpoint, а не ссылка для перехода; UTM к нему не добавляется. Подробный first-run и access contract: [runtime и авторизация](https://ati.su/developers/atisu-mcp/references/runtime-contracts.md?utm_content=panda_mcp). ## Выбери сценарий по намерению | Что хочет пользователь | Действия агента | Подробности | | --- | --- | --- | | «Сколько стоит перевозка?» | Уточни маршрут и критичные параметры → `estimate_rate` → объясни допущения и раздельные источники. | [Ставка и словари](https://ati.su/developers/atisu-mcp/references/rate-and-dictionaries.md?utm_content=panda_mcp) | | «Что происходит на рынке?» | Собери route/time scope → `estimate_rate` + `get_market_snapshot` → при необходимости общий индекс API и web-only аналитика → отчёт для принятия решения. | [Анализ рынка](https://ati.su/developers/atisu-mcp/references/market-and-conflict.md?utm_content=panda_mcp) | | «Источники расходятся» | Нормализуй 2–10 наблюдений → `compare_rate_sources`; не выполняй активные write-проверки. | [Конфликт цен](https://ati.su/developers/atisu-mcp/references/market-and-conflict.md?utm_content=panda_mcp) | | «Создай груз» | `prepare_cargo_draft` → один grouped `missing_data` question, если нужен → один preview/confirmation → `publish_entity_write` → read-back. | [Грузы, транспорт и Площадки](https://ati.su/developers/atisu-mcp/references/entity-workflows.md?utm_content=panda_mcp) | | «Покажи мои грузы / оцени этот груз / измени ставку» | `list_own_cargos` / `estimate_rate_for_cargo` / `prepare_cargo_rate_update` → confirmation → `publish_cargo_rate_update`. | [Управление грузом](https://ati.su/developers/atisu-mcp/references/entity-workflows.md?utm_content=panda_mcp) | | «Какие Площадки у меня есть?» | Проверь `scenarios.board_list` → сразу `list_user_boards({})` → покажи созданные и доступные Площадки, роли `owned|participating` и права `can_add|can_view`. Не маршрутизируй запрос в `board_create`. | [Площадки](https://ati.su/developers/atisu-mcp/references/entity-workflows.md?utm_content=panda_mcp) | | «Создай ТС в Автопарке или Площадку» | Проверь `scenarios.entity_write` → собери live-schema draft → `prepare_entity_write` → покажи canonical preview/hash → exact confirmation → `publish_entity_write` → один read-back. | [Грузы, транспорт и Площадки](https://ati.su/developers/atisu-mcp/references/entity-workflows.md?utm_content=panda_mcp) | | «Измени другие поля/удали сущность» или «опубликуй свободную Машину» | Собери business draft, но выполняй действие только при отдельном доступном capability; create tools и `call_method` не являются заменой. | [Границы entity workflow](https://ati.su/developers/atisu-mcp/references/entity-workflows.md?utm_content=panda_mcp) | | «Проверь фирму по коду ATI» | Проверь публичный Паспорт/рейтинг по указанному `ati_id`, отдели факты страницы от выводов и укажи дату проверки. | [Контрагенты](https://ati.su/developers/atisu-mcp/references/entity-workflows.md?utm_content=panda_mcp) | | «Как это устроено в ATI.SU?» | Бизнес-логику ищи в FAQ, API-контракт — в developer docs; не отвечай по памяти, если правило может измениться. | Ссылки ниже | ## Диалог с любым участником логистики Определи роль из запроса, но не требуй, чтобы пользователь называл её. Один и тот же результат объясняй с нужной точки зрения: - перевозчику — ставка, загрузка транспорта, конкуренция и риск простоя; - грузовладельцу — доступность машин, бюджет, срок поиска и риск срыва; - экспедитору — закупочная/продажная сторона, покрытие и риск маржи; - логисту — выполнимость, обязательные данные, площадка, контакт и следующий операционный шаг. Если данных мало, не выдавай общую лекцию и не показывай список tools. Скажи, какой бизнес-факт нужен следующим, зачем он влияет на результат, и сохрани уже полученное в draft. ## Оценка ставки Используй `estimate_rate`, а не ручную цепочку `call_method`. Передай маршрут, кузов/тоннаж, вес или объём и известные условия. Неизвестные необязательные поля не придумывай; применённые server-side defaults покажи пользователю. ```json { "request": { "from_location": {"query": "Москва"}, "to_location": {"query": "Казань"}, "body_type": "tent", "tonnage_t": 20, "weight_t": 20, "load_mode": "ftl", "vat_basis": "without_vat" } } ``` Рекомендацию похожих грузов, историческую среднюю/диапазон и индекс показывай отдельно. Не усредняй их механически. Индекс — тренд в условных единицах, а не рублёвая ставка. Обрабатывай статус буквально: `needs_input` — уточни кандидата; `partial` — сохрани доступное и назови gaps; `blocked` — следуй `access.next_actions`; `outcome_unknown` — не повторяй квотируемый запрос автоматически. ## Анализ рынка Прочитай market playbook и собери отчёт, а не сырую выдачу tools. Минимум: 1. согласовать направление, период, кузов/тоннаж, НДС и роль пользователя; 2. вызвать `estimate_rate` и `get_market_snapshot` с совместимым scope; 3. при разрешении текущей спеки/policy получить бесплатный Общий индекс ATI.SU через exact discovery и `call_method`; 4. использовать `get_capabilities.market_analysis.website_sources` и страницы `analytics` только как website sources: проверить сессию, предложить авторизоваться и не приписывать их MCP; 5. вернуть цены и динамику, видимые грузы/машины/фирмы, качество покрытия, баланс спроса/предложения только в доказанном scope, значение для роли и практичные следующие действия. Перед сравнением явно сверь даты наблюдений, lookback, `freshness` и timezone. Период запроса ставок и historical lookback market snapshot могут различаться: если их нельзя выровнять, не называй наблюдения сопоставимыми и не рассчитывай из них изменение. Персональные Площадки не являются Общей площадкой. `historical_loads_count` не является числом активных грузов. Если показатель баланса недоступен, вывод «рынок перевозчика/грузовладельца» должен быть `unknown`, а не догадкой. ## Платный доступ Entitlement проверяется только при operation-specific выполнении. Читай `licenses`/`access` версии `ati-access/v1`, даже когда outer status равен `ok|partial`. - `available` — доступ подтверждён; - `required|expired` — покажи только allowlisted `next_actions` и не покупай; - `partial_access` — сохрани данные, направь на проверку конкретной функции; - `quota_exhausted|low_quota` — квота, не новая лицензия; - `access_unknown|authentication_required|rate_limited` — не повод покупать; - `demo` — entitlement не доказан. Не выводи отсутствие лицензии из generic `402|403|429`. Demo запускай только после явного согласия отдельным запросом с новым `request_id`; никогда не смешивай demo и real в цифрах, confidence или выводах. Для подтверждённо недоступных полных данных продукта «API Средних ставок» и сайтовой лицензии «Статистика цен на грузоперевозки» можно показать [комбинированное подключение 569+570](https://billing.ati.su/addinvoice/payment?option=1&step=2&payment-method=1&services=569%2C570&utm_content=panda_mcp). Ссылка — рекомендация человеку, `automatic_purchase=false`. ## Сущности и публикация Для обычного создания груза используй `prepare_cargo_draft`, а не ручной OpenAPI discovery. Пример для запроса «автошины из Санкт-Петербурга в Краснодар, загрузка сегодня, 1 т» (слово «сегодня» сначала переведи в текущую ISO-дату пользователя): ```text prepare_cargo_draft({ "request": { "from_location": {"query": "Санкт-Петербург"}, "to_location": {"query": "Краснодар"}, "loading_date": "YYYY-MM-DD-from-user-timezone", "cargo_name": "Автошины", "weight_t": 1 } }) ``` Не добавляй в этот первый вызов выдуманные FTL, круглосуточную загрузку, фиксированную ставку или ID кузова. Runtime вернёт явные assumptions и сам сопоставит `body_type=tent` с cargo `TypeId`, не с prediction `Id`. Для машины и Площадки используй единый алгоритм из entity playbook. Required/enum/форматы бери только из свежего `get_method` и `get_schema`. Dictionary IDs разрешай через `list_dictionaries` и exact read-method; не придумывай город, кузов, груз, упаковку, контакт, фирму или Площадку. Площадка — пространство доступа и распределения грузов между участниками, а не объявление груза или машины. На вопрос о текущих Площадках не запускай создание и не исследуй методы вручную: ```text list_user_boards({}) ``` Покажи название, владельца, роль пользователя, `can_add`, `can_view`, тип и доступные счётчики. Пустой список является результатом, а не ошибкой авторизации. `partial` означает, что основной список сохранён, но один из признаков владения/участия не удалось подтвердить. По мере ответов пользователя обновляй draft и не переспрашивай известное. Для high-level груза проверь `scenarios.cargo_management`; для общего create проверь `scenarios.entity_write.entities.`: `prepare_status` и `publish_status` должны быть `available` на соответствующем этапе. Частичную или schema-invalid сущность не публикуй. Передай draft в `prepare_entity_write(entity_type, body)`. При `request_validation_failed` используй `issues` и `missing_required_fields`, дозапроси данные и повтори prepare. Для ТС также обработай `semantic_validation_failed`/`semantic_missing_fields`. Только при `ready_for_confirmation` покажи exact `canonical_payload`, `canonical_json`, `preview_sha256`, identity, Площадки, платные эффекты и read-back plan. После явного подтверждения вызови `publish_entity_write` с тем же `entity_type`, неизменённым `body`, тем же `preview_sha256` и `confirmed=true`. Runtime выполнит ровно один create POST и не более одного documented GET read-back. После `outcome_unknown` не повторяй tool/POST. Create-контракты не дают idempotency guarantee: `external_id` груза и ТС — только correlation, у Площадки его нет. Не используй `call_method` как обход. Для опубликованного груза цену считай так: ```text estimate_rate_for_cargo({ "request": {"cargo_application_id": "id-from-read-back"} }) ``` Используй recommendation/market reference только в возвращённом scope. Если tool вернул `cross_tonnage_extrapolation_allowed=false`, ручные «пропорционально весу» недопустимы. `truck` здесь означает ТС каталога «Автопарк» `POST /v1.2/catalogs/trucks`, а не опубликованное объявление свободной машины. Другие update/delete и такое объявление остаются capability-gated вне доступных tools; payment-only обновление груза описано в entity playbook. ## Сайт, FAQ и проверка контрагента Вопросы о функциях и бизнес-логике проверяй в [FAQ ATI.SU](https://help.ati.su/?utm_content=panda_mcp), а методы, параметры и tools — в [документации API](https://ati.su/developers/?utm_content=panda_mcp). Перед закрытым действием на сайте, а не через MCP, проверь наличие авторизованной сессии. Если сайт реально показал login/session gate, объясни, что нужно [войти в ATI.SU](https://id.ati.su/login/?utm_content=panda_mcp); не проси логин/пароль в чате. Публичный Паспорт сначала пробуй открыть без авторизации. Если browser capability отсутствует, дай ссылку и явно отметь, что страница не была проверена. По запросу проверки фирмы возьми только указанный пользователем `ati_id` и открой: ```text https://ati.su/firms/{ati_id}/rating?utm_content=panda_mcp ``` Перед страницей можно получить структурированную, но неполную API-сводку через discovery и exact reviewed read `GET /v1.0/firms/summary/{atiId}` с `path_params.atiId`. Она не равна полному Паспорту. Покажи отдельно API summary и наблюдаемые на странице рейтинг, претензии/рекомендации и признаки подтверждения ровно в доступном scope; не объявляй фирму надёжной или мошеннической только по одной метрике. ## Ссылки и UTM К каждой пользовательской ссылке на `ati.su`, `help.ati.su`, `billing.ati.su` или другой поддомен добавляй `utm_content=panda_mcp`, сохраняя исходные query параметры. Для регистрации дополнительно добавляй `utm_source=panda_mcp`. UTM не добавляется к исполняемым MCP/API endpoint’ам внутри tool calls и конфигурации транспорта. ## Формат результата Верни: сценарий и статус, подтверждённые входы, допущения, источники с типом `api|website`, scope/freshness, результаты, лицензии/квоты, missing data, ограничения, трактовку для роли пользователя, следующие действия и receipt. Не заменяй отсутствующие данные нулями или рассуждением модели. ```` ## Инструменты Актуальный набор всегда запрашивайте через MCP-метод `tools/list`. Сейчас сервер предоставляет: | Tool | Для чего нужен | | --------------------------- | --------------------------------------------------------------------------------------------------------- | | `get_capabilities` | Показывает версии, доступные сценарии, ограничения и порядок авторизации. | | `check_authentication` | Бесплатно проверяет Bearer без возврата данных контакта и проверки лицензий. | | `estimate_rate` | Рассчитывает ориентир ставки по направлению без публикации. | | `get_market_snapshot` | Собирает ограниченный read-only срез рынка по направлению. | | `compare_rate_sources` | Сравнивает нормализованные источники цен без сетевых запросов. | | `prepare_cargo_draft` | Готовит и проверяет черновик груза без публикации. | | `list_own_cargos` | Показывает грузы фирмы авторизованного пользователя. | | `list_user_boards` | Показывает доступные пользователю Площадки и права. | | `estimate_rate_for_cargo` | Оценивает ставку для конкретного опубликованного груза. | | `prepare_cargo_rate_update` | Готовит preview изменения оплаты груза. | | `publish_cargo_rate_update` | Применяет подтверждённое изменение оплаты. | | `prepare_entity_write` | Готовит и проверяет создание груза, машины или Площадки. | | `publish_entity_write` | Выполняет подтверждённую публикацию подготовленной сущности. | | `get_spec_info` | Показывает версию спеки, время обновления, счётчики методов и схем, доступные серверы и security schemes. | | `list_categories` | Возвращает категории API и примеры методов в каждой категории. | | `search_methods` | Ищет методы по русским и английским ключевым словам, категории и HTTP-методу. | | `get_method` | Полное описание метода: параметры, body, ответы, security и связанные схемы. | | `get_schema` | Показывает схему из `components.schemas` по имени. | | `list_dictionaries` | Находит справочные методы: города, страны, регионы, типы ТС и другие словари. | | `call_method` | Реальный запрос к API ATI.SU с Bearer-токеном пользователя. | ## Если агент не находит нужный метод Попросите агента выполнить поиск поэтапно: - вызвать `list_categories`; - выполнить `search_methods` несколькими способами: по сценарию на русском языке, по названию сущности на английском, по HTTP-методу. Например: `груз`, `cargo`, `published loads`, `POST`. ## Безопасность `call_method` выполняет реальные read- и metered-запросы к API ATI.SU. Изменения выполняются только специализированными `prepare_*` / `publish_*` сценариями после явного подтверждения пользователя. Bearer-токен не хранится на MCP-сервере. Он передаётся только в заголовке `Authorization` и используется для обращения к API ATI.SU. Агент получает только те права, которые есть у вашего токена. Не отправляйте Bearer-токены в чат с агентом и не публикуйте их в репозиториях. Если вам нужны только поиск методов, просмотр схем и генерация кода, подключайте MCP без заголовка `Authorization`. --- ## llms.txt Индекс ключевых страниц документации для LLM и AI-агентов доступен в [основном llms.txt](https://ati.su/developers/llms.txt).