Документация/Подключение/Своя панель/ИИ-агент и MCP·9 / 9
ИИ-агент и MCP
Панель можно подключить к Claude Code, Cursor, VS Code и другим ИИ-агентам по MCP: оператор спрашивает словами — «кто истекает на этой неделе», «что с узлом de-fra», «продли тем, у кого метка vip» — а агент ходит в тот же API с вашим токеном. Агент видит ровно то, что разрешает токен.
Сделайте токен
Командой veli token add agent --rights read на сервере панели. Для начала — «Только чтение»: агент сможет смотреть и ничего не изменит.
Подключите панель
Один раз: по HTTPS — ничего ставить не нужно, или командой veli на компьютере с Linux. Токен — в файле или в хранилище агента, не в чате.
Спросите
Агенту доступны готовые сценарии: утренний обход, что с узлом, разбор обращения клиента, чистка неактивных, отчёт после переезда.
veli token add agent --rights readclaude mcp add --transport http veli-panel https://panel.example.com/Zq7mT2xP4vLc9wRbE5nK/api/mcp --header "Authorization: Bearer $VELI_TOKEN"claude mcp add veli-panel -- veli panel mcp --url https://panel.example.com/Zq7mT2xP4vLc9wRbE5nK/api --token-file ~/.veli/panel.token- Только чтение
- Клиенты, узлы, группы, события, трафик, корзина. Ссылки клиента в ответах нет.
- Клиенты
- Ещё: завести, продлить, изменить поля и метки, отключить и включить, показать ссылку клиента, поменять многих сразу — сначала предпросмотр, затем число.
- Всё
- Ещё: удалить клиента, новая ссылка, вернуть из корзины, удалить из корзины — и только с повтором имени. Командой — с флагом --destructive.
- Изменять агент может только с токеном «Клиенты» или «Всё» и только если вы включили флаг --write. По HTTPS набор инструментов определяет сам токен.
- Ссылка клиента — секрет: в обычных ответах её нет, её отдаёт только client_link, и по HTTPS это строка в журнале с названием токена. По команде такой строки нет: где нужен след, подключайте по HTTPS.
- Имя, заметка и контакт клиента — текст клиента. Агент получает их как данные и не выполняет написанное в них.
Подсказка для ИИ
Готовый текст, который вы вставляете в Claude или другого ИИ-помощника вместе со схемой API и получаете кабинет под свои задачи.
Токен
veli token add cabinet --rights clients. Для витрины и отчётов хватит и read. Токен не вставляйте в чат: только в переменные окружения вашего сервера.
Схема
Скачайте openapi.json и приложите его к разговору с ИИ — или дайте ему адрес схемы.
Подсказка
Скопируйте текст ниже, впишите свои задачи вместо строки в скобках и отправьте вместе со схемой.
Проверьте
Спросите у ИИ, как запустить кабинет у себя, и попробуйте на тестовом клиенте. Потом проверьте, что ссылки и токен нигде не попали в журналы.
veli token add cabinet --rights clients --days 90
VELI=https://panel.example.com/Zq7mT2xP4vLc9wRbE5nK/api
VELI_TOKEN=veli_…
curl -s "$VELI/openapi.json" \
-H "Authorization: Bearer $VELI_TOKEN" -o veli-openapi.jsonПомоги мне собрать кабинет для моего VPN-сервиса на готовом API панели Veli. У панели нет своего интерфейса в браузере: вся работа идёт через HTTP API. Что у тебя есть: - Схема API: файл openapi.json (приложен). Берите вызовы и поля только из неё, ничего не выдумывай. - Адрес API: https://panel.example.com/<секретный путь>/api (подставь мой). - Токен лежит в переменной окружения VELI_TOKEN и передаётся в заголовке Authorization: Bearer. Не пиши токен в код, в журналы и на страницы сайта. Правила: 1. Любой вызов, который что-то меняет, делай с заголовком Idempotency-Key (номер заказа): система может прислать уведомление дважды, а клиент должен появиться один раз. 2. Ссылка подписки клиента — секрет: показывай её только самому клиенту и не пиши в журналы. 3. Предел — 300 запросов в минуту на токен. На 429 подожди столько секунд, сколько сказано в Retry-After. 4. Токен нельзя отдавать в браузер клиента: кабинет ходит в API с моего сервера, а не со страницы. 5. События (клиент добавлен, срок скоро кончится, трафик на исходе, узел замолчал) приходят вебхуком. Проверяй подпись HMAC-SHA256 из заголовка veli-signature, отвечай сразу, а работу делай после. 6. Клиента связывай с моей системой через поле external (номер заказа или ID пользователя у вас). Мои задачи: [ОПИШИТЕ ЗДЕСЬ: например — форма «Заказать» создаёт клиента на 30 дней и показывает ссылку и QR-код; страница «Мои подписки» по номеру заказа; список тех, кто истекает за 3 дня, с кнопкой «Продлить»; сводка по узлам.] Сначала задай вопросы, если чего-то не хватает. Потом предложи план, собери кабинет по шагам и покажи, как запустить его локально и как проверить на тестовом клиенте.