Документация/Подключение/Своя панель/ИИ-агент и MCP·9 / 9

ИИ-агент и MCP

Панель можно подключить к Claude Code, Cursor, VS Code и другим ИИ-агентам по MCP: оператор спрашивает словами — «кто истекает на этой неделе», «что с узлом de-fra», «продли тем, у кого метка vip» — а агент ходит в тот же API с вашим токеном. Агент видит ровно то, что разрешает токен.

  1. Сделайте токен

    Командой veli token add agent --rights read на сервере панели. Для начала — «Только чтение»: агент сможет смотреть и ничего не изменит.

  2. Подключите панель

    Один раз: по HTTPS — ничего ставить не нужно, или командой veli на компьютере с Linux. Токен — в файле или в хранилище агента, не в чате.

  3. Спросите

    Агенту доступны готовые сценарии: утренний обход, что с узлом, разбор обращения клиента, чистка неактивных, отчёт после переезда.

Токен для агента — только чтение
veli token add agent --rights read
По HTTPS — панель с доменом сама отвечает агенту, ничего ставить не нужно
claude mcp add --transport http veli-panel https://panel.example.com/Zq7mT2xP4vLc9wRbE5nK/api/mcp --header "Authorization: Bearer $VELI_TOKEN"
Командой veli на своём компьютере с Linux (токен в файле ~/.veli/panel.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 и получаете кабинет под свои задачи.

  1. Токен

    veli token add cabinet --rights clients. Для витрины и отчётов хватит и read. Токен не вставляйте в чат: только в переменные окружения вашего сервера.

  2. Схема

    Скачайте openapi.json и приложите его к разговору с ИИ — или дайте ему адрес схемы.

  3. Подсказка

    Скопируйте текст ниже, впишите свои задачи вместо строки в скобках и отправьте вместе со схемой.

  4. Проверьте

    Спросите у ИИ, как запустить кабинет у себя, и попробуйте на тестовом клиенте. Потом проверьте, что ссылки и токен нигде не попали в журналы.

Токен
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
Подсказка для Claude
Помоги мне собрать кабинет для моего 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 дня, с кнопкой «Продлить»; сводка по узлам.]

Сначала задай вопросы, если чего-то не хватает. Потом предложи план, собери кабинет по шагам и покажи, как запустить его локально и как проверить на тестовом клиенте.