ИИ-агенты, LLM и MCP

NEW

Документация для людей и ИИ-агентов

Передайте агенту индекс документации или подключите ATI.SU MCP. Агент найдёт нужную страницу и метод API, изучит актуальный контракт и поможет подготовить запрос.

Начать

Подключить MCP

Скачать SKILL.md

Быстрый старт для ИИ-агента

Индекс документации для LLM: /developers/llms.txt

В нём собраны ссылки на ключевые разделы и их чистые Markdown-версии. Начните с индекса, а затем загрузите только страницы, нужные для текущей задачи.

Полезные машиночитаемые ресурсы:

OpenAPI публичного API — точные методы, параметры и схемы;
Markdown-версия этой страницы — текст без элементов интерфейса;
SKILL.md для ATI.SU MCP — готовые правила и сценарии для агента;
карточка MCP-сервера — адрес, транспорт и требования к авторизации.

Скопируйте стартовый промпт и отправьте его агенту:

Используй официальную документацию публичного 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/mcp.json и переподключите MCP:

{
  "mcpServers": {
    "ati-su": {
      "type": "http",
      "url": "https://api.ati.su/gw/panda-mcp/public/v1/mcp",
      "headers": {
        "Authorization": "Bearer <access_token>"
      }
    }
  }
}

claude mcp add --transport http \
  --header "Authorization: Bearer <access_token>" \
  ati-su https://api.ati.su/gw/panda-mcp/public/v1/mcp

Если нужен только поиск методов и схемы, заголовок Authorization можно не передавать.

Если клиент не подключается к удалённому MCP напрямую, используйте mcp-remote:

{
  "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 <access_token>"
      ]
    }
  }
}

2. Получите Bearer-токен

Bearer-токен требуется для чтения закрытых данных и реальных запросов к API. Добавьте его в конфигурацию MCP:

Authorization: Bearer <access_token>

Откройте Мои токены — там перечислены ваши access_token. Если подходящего токена нет, нажмите «Создать временный токен»: будет создан токен приложения api-panda-portal, действующий 7 дней.

Если у вас уже есть client_id, постоянный токен можно создать в Моих токенах или вызвать:

POST https://ati.su/gw/auth/v1/tokens/{client_id}
Cookie: ваша авторизованная сессия ATI.SU

Если client_id ещё нет, сначала пройдите инструкцию по получению access_token.

3. Выполните первый запрос

Начните с проверки доступных возможностей сервера.

Через 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

Инструменты

Актуальный набор всегда запрашивайте через MCP-метод tools/list. Сейчас сервер предоставляет:

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_updatePreview изменения оплаты груза.

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.

Безопасность

Bearer-токен не хранится на MCP-сервере. Он передаётся только в заголовке Authorization и используется для обращения к API ATI.SU. Агент получает только те права, которые есть у вашего токена.

Не отправляйте Bearer-токены в чат с агентом и не публикуйте их в репозиториях.

Если вам нужны только поиск методов, просмотр схем и генерация кода, подключайте MCP без заголовка Authorization.