Подключение ИИ-агента

Это официальная инструкция ScanSuite по подключению ИИ-агента для разработки (Claude Code, OpenAI Codex, GitHub Copilot, Cursor и других) к серверу ScanSuite Teams. Она опубликована по адресу https://scansuite.ru/documentation/agent-setup.md, чтобы агент мог проверить её источник, прежде чем ей следовать. Страница обращается к агенту; человек может прочитать её, чтобы точно знать, что агент сделает.

Настрой ScanSuite: загрузи https://scansuite.ru/documentation/agent-setup.md и выполни инструкции

Правила для агента

• Все команды ниже выполняй сам. На шаге, который может выполнить только человек (в Markdown-версии он начинается со слов Этот шаг выполняет человек:), сделай всё вокруг него, попроси у пользователя только то, что может дать лишь он, и дождись его подтверждения.
• Никогда не запускай команды, которые ждут интерактивного ввода.
• Никогда не читай, не выводи и не копируй API-токен. Он лежит в файле, который записывает человек; навык читает его оттуда. Никогда не проси пользователя вставить токен в переписку.
• Любую команду здесь можно безопасно выполнить повторно на машине, где настройка уже прошла.
• Сообщай только то, что проверил (см. Отчёт о результате).

1. Сервер и команда

Нужны два значения. Возьми их из сообщения пользователя (там могут быть оба), из переменных окружения или спроси пользователя.

Проверь, что сервер отвечает:

curl -fsS "$SCANSUITE_URL/ci/version"

Ожидается короткий JSON-документ с версией клиента, которую публикует сервер. Если команда не прошла, остановись и сообщи, что сервер недоступен с этой машины (неверный адрес, не подключён VPN или закрытый сертификат: про SCANSUITE_CA_BUNDLE см. CI/CD и автоматизация).

2. Что нужно заранее

Если нет bash, curl или python3, остановись и сообщи об этом. В Windows выполняй всё в WSL или Git Bash.

3. Установка навыка ScanSuite

Навык опубликован в открытом репозитории github.com/cepxeo/scansuite-ci. Используй раздел для своего агента.

Claude Code

claude plugin marketplace add cepxeo/scansuite-ci
claude plugin install scansuite@scansuite-ci

Проверка:

claude plugin list | grep -A2 "scansuite@scansuite-ci"

Плагин должен быть в списке как включённый (enabled). Если он есть, но выключен, выполни claude plugin enable scansuite@scansuite-ci.

OpenAI Codex, GitHub Copilot, Cursor и другие агенты

Навык — это папка с файлом SKILL.md. Скопируй папку туда, откуда твой агент загружает навыки:

rm -rf /tmp/scansuite-ci && git clone --depth 1 https://github.com/cepxeo/scansuite-ci /tmp/scansuite-ci
mkdir -p <SKILLS_DIR> && rm -rf <SKILLS_DIR>/scansuite
cp -r /tmp/scansuite-ci/plugins/scansuite/skills/scansuite <SKILLS_DIR>/scansuite

Проверка: test -f <SKILLS_DIR>/scansuite/SKILL.md && echo ok выводит ok. Некоторые агенты загружают новые навыки только после перезапуска; если твой из таких, укажи это в отчёте.

4. Подключение к серверу

Навык читает API-токен из ~/.scansuite-token (или из файла, указанного в SCANSUITE_TOKEN_FILE). Сначала проверь, есть ли он уже, не читая его:

test -r ~/.scansuite-token && ls -l ~/.scansuite-token | cut -c1-10

Если выводится -rw-------, переходи к шагу 5. Если файла нет, токен создаёт человек:

Если файл есть, но его могут читать другие пользователи (права не -rw-------), выполни chmod 600 ~/.scansuite-token.

5. Сквозная проверка

Из папки навыка, с заданными SCANSUITE_URL и SCANSUITE_TEAM:

bash scripts/preflight.sh
bash scripts/api.sh GET /products

Preflight выводит версии клиента и сервера, роль, права и срок действия токена, а также все сканеры; те, которые команда запустить не может, помечены NOT AVAILABLE с причиной. Вторая команда выводит продукты команды. Пустой список — это успех: подключение работает, просто у команды ещё нет продуктов.

Без пользователя

В CI, в задании по расписанию или при запуске агента без интерфейса шаги для человека выполнить некому. Тогда:

1. Бери токен из хранилища секретов CI-системы, а не из файла, который пишешь сам. Укажи в SCANSUITE_TOKEN_FILE секрет, который CI-система подключает как файл (например, переменную GitLab типа File), или запускай клиент напрямую с заданной SCANSUITE_TOKEN. Никогда не выводи токен. Если не задано ни то ни другое, остановись и сообщи, что токена нет.
2. Установи навык, как в шаге 3 (/reload-plugins пропусти: плагин загружается при запуске агента).
3. Выполни шаг 5 и запиши итоговую таблицу в журнал задания.

Для конвейеров без агента используй клиент напрямую: см. CI/CD и автоматизация.

Отчёт о результате

Сообщи то, что проверил, и ничего больше:

┌─ Настройка агента ScanSuite ───────────────────────────────────┐
│  ✓ Навык ScanSuite      установлен, загружается в этом агенте  │
│  ✓ Сервер               https://scansuite.example.com доступен │
│  ⚠ Токен                нужен человек: создать токен (шаг 4)   │
│  ✗ Сквозная проверка    ещё не выполнена                       │
└────────────────────────────────────────────────────────────────┘

✓ — проверено, ⚠ — ждёт человека, ✗ — не удалось или не выполнялось. После таблицы для каждой строки, отличной от ✓, назови следующее действие.

Что попросить дальше

Когда все строки отмечены ✓, предложи пользователю одну из этих просьб:

Полное объяснение для людей, в том числе о том, что навык спрашивает перед вмешивающимися или дорогими сканированиями, — в разделе Работа с ИИ-агентами.