ATI.SU MCP для AI-агентов

NEW

Удалённый MCP-сервер публичного API ATI.SU

Подключите сервер ATI.SU MCP к AI-агенту — он сам найдёт нужный метод API, разберёт параметры и схемы, соберёт запрос и, если вы разрешите, выполнит его с вашим токеном.

Подключить

Смотреть инструменты

Скачать SKILL.md

Что умеет ATI.SU MCP

ATI.SU MCP — официальный MCP-сервер для работы с публичным API ATI.SU.

Вместо отдельных MCP-инструментов для каждого метода API сервер предоставляет небольшой набор универсальных инструментов. Агент сначала находит нужный метод, затем изучает его контракт и только после этого выполняет запрос. Благодаря этому контекст модели не перегружается описанием всего API, а агент получает только ту информацию, которая нужна в текущий момент.

Без Bearer-токена доступны discovery-инструменты:

поиск методов API;
просмотр схем;
работа со справочниками.

Bearer-токен требуется только для call_method, который выполняет реальные запросы к API ATI.SU.

Быстрый старт

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-токен требуется только для выполнения call_method. Добавьте его в конфигурацию 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 найди метод API для публикации груза.
Покажи operation_id, обязательные поля и пример JSON body.
call_method пока не вызывай.

После этого агент найдёт подходящий метод, покажет его описание и только затем сможет выполнить запрос.

SKILL.md для AI-агента

SKILL.md — готовая инструкция для AI-агента.

В файле уже описаны:

endpoint сервера;
порядок вызова MCP-инструментов;
правила работы с Bearer-токеном;
ограничения call_method;
готовые промпты.

Скачайте файл и передайте его агенту либо откройте эту страницу в агенте и попросите следовать инструкции из SKILL.md.

После этого можно просто написать: «Через ATI.SU MCP найди нужный метод API».

Если потребуется выполнить реальный запрос, агент сначала попросит Bearer-токен, а затем запросит подтверждение перед вызовом API.

Скачать SKILL.md

Инструменты

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.