Как работает NexTool MCP for GLPI
От регистрации на портале до первого вопроса к ИИ: как сервис связывает вашего ассистента с вашим GLPI, что можно попросить и как защищены ваши данные.
Не связано с Teclib'. GLPI является зарегистрированным товарным знаком Teclib'.
Обзор
NexTool MCP находится посередине: получает запрос от ассистента, проверяет на портале NexTool, кто вы, и вызывает API вашего GLPI с учётными данными, которые вы зарегистрировали.
Вы общаетесь
Вы просите на естественном языке. Ассистент выбирает нужный инструмент GLPI (их более 160) и показывает, что собирается сделать.
Коннектор проверяет
При каждом запросе NexTool MCP проверяет на портале, действителен ли ключ или вход, какое подключение использовать, лимит тарифа и не работает ли подключение только на чтение.
GLPI отвечает
Вызов поступает в API GLPI от имени пользователя токена. Чего он не может делать в GLPI, того не сделает и ИИ.
Пошаговая инструкция для размещённой версии Открытая бета
Открыто для всех на время беты и бесплатно. Пять шагов: от регистрации до первого вопроса.
- 1
Создайте учётную запись на портале NexTool
Это бесплатно и использует учётную запись портала, отдельная регистрация не нужна. Уже есть аккаунт? Просто войдите.
- 2
Откройте «Мой аккаунт → NexTool MCP»
Страница NexTool MCP на портале объединяет ваши подключения к GLPI, API-ключи, авторизованные приложения и ваш тариф.
- 3
Создайте подключение к вашему GLPI
Задайте название (напр.: Продуктивная среда), укажите HTTPS-адрес GLPI и выберите API:
- REST API v1 (GLPI 10 и 11): пользовательский токен и, если этого требует API-клиент GLPI, App-Token.
- API v2 (GLPI 11, OAuth): адрес API v2, client ID и secret OAuth-клиента GLPI, а также пользователь и пароль.
- Оба: заполните оба с учётными данными одного и того же человека в GLPI. Если v1 и v2 аутентифицируют разных пользователей, проверка блокирует подключение.
Отметьте группы инструментов, которые может использовать ИИ (группа «Основной» отмечена по умолчанию) и, при желании, включите только чтение.
Учётные данные шифруются в момент сохранения ключом, который открывает только коннектор: ни портал, ни команда NexTool не могут их прочитать.
- 4
Проверьте подключение
При сохранении портал сразу выполняет проверку и показывает версию GLPI, а также пользователя и профиль, которых аутентифицировал каждый API. Если возникла ошибка, сообщение указывает причину:
Что отображается Что это значит Что делать GLPI недоступен из интернета Адрес указывает на частную или заблокированную сеть (внутренний IP, localhost). Опубликуйте GLPI по публичному адресу с HTTPS или используйте версию с открытым исходным кодом внутри вашей сети. GLPI недоступен Сбой DNS, истекло время ожидания или соединение отклонено. Проверьте адрес, DNS и межсетевой экран. Недействительный сертификат HTTPS-сертификат просрочен, самоподписан или не соответствует адресу. Установите действительный сертификат (например, Let's Encrypt). Перенаправление GLPI перенаправляет на другой адрес (с http на https, на другой домен, на страницу входа). Укажите конечный адрес, каким он отображается в браузере после перенаправления. Не отвечает как API GLPI Адрес отвечает, но не как API GLPI (прокси, страница входа, неверный путь). Используйте корень GLPI, без /front и /apirest.php в конце. API отключён REST API отключён в GLPI. В разделе «Настройка → Общие → API» включите REST API и вход по токену. IP не разрешён API-клиент GLPI принимает только некоторые IP, и IP коннектора среди них нет. Сообщение портала показывает IP коннектора: разрешите его в API-клиенте («Настройка → Общие → API»). Учётные данные отклонены GLPI отклонил App-Token, пользовательский токен или OAuth. Сгенерируйте токен заново и проверьте, что App-Token принадлежит нужному API-клиенту. Разные пользователи в двух API v1 и v2 аутентифицировали в GLPI разных людей. Используйте учётные данные одного и того же пользователя в обоих API. Пользователь с профилем Super-Admin не блокирует проверку, но портал показывает серьёзное предупреждение: лучше использовать отдельного пользователя с минимальным профилем.
- 5
Подключите вашего ассистента
У каждого подключения есть свой URL коннектора, он отображается в списке на портале с кнопкой копирования:
https://mcp.nextoolsolutions.com/mcp/principalprincipal— идентификатор первого подключения аккаунта; остальные используют выбранный вами идентификатор. Адрес без идентификатора (/mcp) тоже работает и использует первое проверенное подключение.
- 1
В разделе Настройки → Коннекторы нажмите Добавить пользовательский коннектор.
- 2
Задайте название (напр.: GLPI Продуктивная среда) и вставьте URL подключения:
https://mcp.nextoolsolutions.com/mcp/principal - 3
Нажмите Подключить: откроется страница входа на портал NexTool. Войдите в свою учётную запись.
- 4
На экране авторизации проверьте приложение, адрес возврата и подключение к GLPI, которое будет использовано, и нажмите Разрешить.
Один коннектор на один GLPI: для другого подключения добавьте ещё один коннектор с его URL. Чтобы закрыть доступ, отзовите его в разделе «Мой аккаунт → NexTool MCP → Авторизованные приложения».
- 1
В ChatGPT в разделе Настройки → Приложения и коннекторы включите режим разработчика (в разделе «Дополнительно»).
- 2
Создайте коннектор с URL подключения и аутентификацией OAuth:
https://mcp.nextoolsolutions.com/mcp/principal - 3
Войдите с учётной записью портала NexTool и разрешите доступ.
Доступность режима разработчика зависит от вашего тарифа ChatGPT.
- 1
Добавьте сервер с URL подключения:
claude mcp add --transport http nextool https://mcp.nextoolsolutions.com/mcp/principal - 2
Внутри Claude Code выполните
/mcpи выберите аутентификацию: в браузере откроется вход в портал./mcp - 3
Предпочитаете ключ? Создайте его в Моя учётная запись → NexTool MCP на портале и передайте в заголовке:
claude mcp add --transport http nextool https://mcp.nextoolsolutions.com/mcp/principal \ --header "Authorization: Bearer nxm_..."
Для других подключений используйте другое имя сервера (напр.: nextool-homologacao) с их URL.
Cursor и VS Code используют API-ключ: сгенерируйте его в разделе Мой аккаунт → NexTool MCP → Ключи доступа и замените nxm_... на свой.
Cursor: ~/.cursor/mcp.json (или .cursor/mcp.json в проекте)
VS Code: .vscode/mcp.json в проекте
Ключ nxm_ отображается только один раз, при создании. Храните его как пароль и отзовите на портале, если он утечёт.
Готово: попробуйте покажи мои открытые заявки. Если в аккаунте ещё нет проверенного подключения, ассистент получает только инструмент nextool_setup, который объясняет, чего не хватает.
Подключения и несколько экземпляров
Подключение — это один GLPI. Тем, кто работает с продуктивной и тестовой средой или с несколькими клиентами, нужно создать отдельное подключение для каждого.
Один URL на подключение
У каждого подключения есть идентификатор, который образует URL коннектора. После создания он не меняется, потому что это адрес, который использует ассистент.
Только чтение для каждого подключения
Включается и отключается в списке, без повторной проверки. Когда режим включён, любой инструмент, который создаёт, изменяет или удаляет, отклоняется до обращения к GLPI. Рекомендуется для продуктивной среды.
Авторизация для каждого коннектора
Вход, авторизованный в одном коннекторе, действует только для его URL: коннектор тестовой среды не получит доступ к продуктивной.
Группы инструментов
Каждое подключение выбирает свои группы. Чем меньше инструментов, тем быстрее и точнее работает ассистент.
Бесплатный и Pro
| В размещённой версии | Бесплатный | Pro |
|---|---|---|
| Подключения (по одному GLPI) | 1 | до 10 |
| Запросов в минуту | 60 | 300 |
| Только чтение для каждого подключения | Да | Да |
| Как получить | Любая учётная запись портала NexTool, бесплатно на время беты | Лицензия NexTool MCP Pro вашей среды NexTool |
Если аккаунт вернётся на бесплатный тариф, подключения сверх лимита (самые новые) приостанавливаются без потери данных, пока вы не удалите другие или не вернётесь на Pro.
Что можно попросить
Говорите так, как говорили бы с коллегой из Service Desk. Ассистент выбирает инструмент; вы видите, какой именно, а для тех, что изменяют данные, подтверждаете заранее.
Основной
coreЗапросы по заявкам, проблемам, изменениям, активам, базе знаний, документам и пользователям, а также операции с заявками, которые ничего не удаляют. Отмечена по умолчанию.
Примеры запросов
- Покажи мои открытые заявки.
- Кратко изложи историю заявки 123.
- Добавь в заявку 123 комментарий о том, что оборудование прибудет завтра.
Заявки
ticketsПолный жизненный цикл заявки: создание, обновление, назначение, комментарии, решение, задачи и согласования.
Примеры запросов
- Создай заявку для Жоау: в принтере на 3-м этаже закончился тонер.
- Назначь заявку 456 на группу «Инфраструктура».
- Запроси согласование Марии по заявке 789.
Проблемы и изменения
itilПроблемы и изменения ITIL с хронологией, задачами и решениями.
Примеры запросов
- Какие изменения запланированы на эту неделю?
- Создай проблему для сбоев VPN, о которых сообщили сегодня.
- Покажи хронологию изменения 42.
Активы и инвентаризация
assetsКомпьютеры, мониторы, принтеры и другие активы, с резервированиями и местоположениями.
Примеры запросов
- Какие компьютеры закреплены за пользователем Карлосом?
- Найди актив с серийным номером ABC123.
- Какие предметы зарезервированы на завтра?
База знаний
kbПоиск и чтение статей и категорий; создание и редактирование, если это позволяет профиль.
Примеры запросов
- Найди в базе знаний информацию о VPN.
- Преврати решение заявки 321 в статью.
- Покажи список категорий базы.
Документы
documentsДокументы и их связи с заявками и активами. Чтение уже входит в группу «Основной».
Примеры запросов
- Какие вложения есть в заявке 123?
- Покажи документы, связанные с ноутбуком NB-045.
Пользователи и группы
usersЗапросы по пользователям и группам, чтобы называть по имени тех, кто обращается и кто обслуживает.
Примеры запросов
- Кто пользователь с e-mail [email protected]?
- Кто входит в группу Service Desk N2?
Поиск
searchУниверсальный поиск GLPI с фильтрами и подсчётами. Уже входит в группы «Основной» и «Заявки».
Примеры запросов
- Сколько заявок категории «Сеть» открыто в этом месяце?
- Покажи заявки, находящиеся в ожидании более 7 дней.
Администрирование
adminОрганизации, бизнес-правила, шаблоны комментариев, вебхуки и учёт пользователей и групп. Включайте, только если это необходимо.
Примеры запросов
- Покажи правила назначения заявок.
- Какие вебхуки сегодня завершились ошибкой?
API v2 (GLPI 11)
v2Инструменты API v2 GLPI 11 с OAuth: команда заявки, хронология, база знаний, документы и правила.
Примеры запросов
- Покажи команду заявки 123.
- Скачай документ 55.
Что такое «мои заявки»
Это заявки пользователя GLPI, чьи учётные данные указаны в подключении, где он выступает инициатором, назначенным специалистом или наблюдателем. По умолчанию возвращаются только открытые, от новых к старым. Можно запросить только те, что открыли вы, только назначенные вам или включить закрытые. Этот запрос использует REST API v1.
ИИ соблюдает права GLPI
Любое действие выполняется от имени пользователя токена, с его профилем и организациями: что он не может видеть или изменять в GLPI, не может и ИИ. Названия статусов и приоритетов приходят на языке этого пользователя в GLPI.
Код каждой группы — это имя пресета в локальной версии (GLPI_TOOLSETS). На портале «Документы» и «Поиск» не отображаются как отдельная группа: их запросы уже входят в группу «Основной».
Безопасность и конфиденциальность
Как сервис защищает ваш GLPI и ваши данные.
Аннотации и подтверждение
Каждый инструмент объявляет себя «только чтение» или деструктивным. ИИ-клиенты используют это, чтобы запросить ваше подтверждение перед изменением данных.
Удаление заблокировано
В размещённой версии ни один инструмент удаления не доступен ни на одном тарифе. Удаление по-прежнему выполняете вы сами, в GLPI.
Шифрование учётных данных
Запечатываются в момент сохранения ключом, который открывает только коннектор. Портал хранит зашифрованный конверт и не может его открыть; ключи nxm_ хранятся только в виде хеша.
Переписка не сохраняется
Коннектор не хранит вопросы, ответы и содержимое GLPI. Аудит фиксирует только метаданные: аккаунт, подключение, инструмент и время, но не аргументы.
Нет доступа к внутренним сетям
Коннектор обращается только к публичным адресам: отклоняет частные IP, localhost и внутренние облачные адреса, проверяет IP при каждом подключении и не следует перенаправлению на другой хост.
Лимиты использования
Действует лимит запросов в минуту на ключ или вход (60 на бесплатном тарифе, 300 на Pro) и отдельный лимит на целевой GLPI, чтобы ассистент, попавший в цикл, не перегружал ваш GLPI.
Отдельный пользователь, минимальный профиль
Не используйте Super-Admin: у ИИ был бы полный доступ. Создайте пользователя только для ИИ с необходимыми профилем и организациями и используйте его токен.
Отзываемый доступ
Отзовите ключ или авторизованное приложение в разделе «Мой аккаунт → NexTool MCP»: доступ прекратится в течение минуты.
Ограничения и большие ответы
В большом GLPI тысячи заявок. Чтобы ответ поместился в диалог, коннектор отдаёт его частями.
Постраничные списки
По умолчанию 25 элементов на страницу, до 100 за вызов.
Предел размера
Каждый ответ не превышает 50 тысяч символов. Более длинный список обрезается в конце, и ответ сообщает об этом.
Длинные тексты сокращаются
В списках тексты длиннее 300 символов обрезаются; при открытии элемента приходит полный текст. История заявки не обрезается.
Следующая страница
Каждый частичный ответ подсказывает, как получить остальное. Достаточно попросить: покажи следующую страницу или покажи следующие 50.
Совет: фильтруйте прямо в запросе (статус, период, категория, специалист). Ожидающие заявки категории «Сеть», открытые в этом месяце обрабатываются быстрее и расходуют меньше контекста, чем все заявки.
Превышен лимит запросов? Ассистент получает уведомление подождать несколько секунд и повторить попытку.
Локальная версия с открытым исходным кодом
Те же инструменты, работающие на вашем компьютере или сервере, с лицензией MIT.
Когда использовать
- GLPI существует только во внутренней сети, без доступа из интернета.
- Вы хотите, чтобы всё оставалось внутри вашей сети, без передачи внешнему сервису.
- Вам нужно то, чего нет в размещённой версии, например инструменты удаления (с обязательной письменной причиной).
Установка
Опубликовано в npm (@nextoolsolutions/mcp-glpi) и в официальном реестре MCP как com.nextoolsolutions/glpi. npx загружает и запускает последнюю версию, без клонирования и компиляции. В руководстве по установке есть примеры для Claude Desktop, Cursor и VS Code.
Основные переменные
| Переменная | Эффект |
|---|---|
GLPI_URL | Адрес GLPI (REST API v1) |
GLPI_USER_TOKEN | API-токен пользователя |
GLPI_APP_TOKEN | App-Token API-клиента (необязательно) |
GLPI_V2_* | API v2 GLPI 11 с OAuth (необязательно) |
GLPI_TOOLSETS | Пресеты инструментов, через запятую |
GLPI_READ_ONLY=true | Блокирует любую запись до того, как она дойдёт до GLPI. Рекомендуется для начала. |
GLPI_ALLOW_DELETE=true | Включает инструменты удаления, по умолчанию выключенные. Каждое удаление требует письменной причины. |
Чтобы начать без рисков, используйте GLPI_READ_ONLY=true: любая запись блокируется до обращения к GLPI.
Устранение неполадок
Самые частые случаи, от симптома до решения. Об ошибках проверки подключения см. таблицу в шаге 4.
| Симптом | Вероятная причина | Что делать |
|---|---|---|
| Ассистент сообщает, что ни один GLPI не подключён | В аккаунте нет проверенного подключения, или URL коннектора использует несуществующий идентификатор. | На портале проверяйте подключение, пока оно не станет «Проверено», и сверьте URL коннектора. |
| На экране авторизации нет кнопки «Разрешить» | Подключения с этим URL не существует, оно не проверено или превышает лимит тарифа. | Воспользуйтесь ссылкой на самом экране, чтобы создать или проверить подключение, и вернитесь, чтобы завершить. |
| Ошибка 401 (не авторизован) в клиенте | Неверный или отозванный ключ nxm_, либо вход истёк или отозван. | Сгенерируйте другой ключ или заново подключите коннектор (в Claude Code — /mcp). |
| ИИ ничего не может изменить | Подключение в режиме «только чтение», группа инструментов не отмечена или у профиля GLPI нет нужного права. | Отключите «только чтение», отметьте группу или измените профиль пользователя в GLPI. |
| Нет ожидаемого инструмента | Его группа не отмечена в подключении, или его API (v1 или v2) не настроен. | Измените подключение и отметьте группу или заполните данные API; изменение вступает в силу в течение минуты. |
| «Мои заявки» пусты или принадлежат другому человеку | Список относится к пользователю токена, а не к тому, кто общается с ИИ. | Используйте токен своего пользователя или запросите заявки конкретного человека по имени. |
| Предупреждение о лимите запросов | Ассистент сделал слишком много вызовов за минуту. | Подождите несколько секунд и запрашивайте более отфильтрованные списки. На Pro лимит выше. |
| Подключение отображается как «Сверх лимита тарифа» | Аккаунт вернулся на бесплатный тариф, имея больше одного подключения. | Удалите подключения или вернитесь на Pro; ничего не было удалено. |
| Я попросил дважды, а создана только одна запись | Защита от дублирования: то же создание с теми же данными в течение 2 минут возвращает первый результат. | Так и должно быть. Если вам действительно нужна ещё одна запись, измените какие-либо данные в запросе. |
Часто задаваемые вопросы
Нужно ли что-то устанавливать, чтобы пользоваться размещённой версией?
Нет. Достаточно учётной записи на портале NexTool, подключения к GLPI и URL коннектора в вашем ассистенте. В Claude Code, Cursor и VS Code — только настройка MCP-сервера.
Можно ли подключить больше одного GLPI?
Да, на тарифе Pro: до 10 подключений, по одному на GLPI, у каждого свой URL коннектора. На бесплатном — одно подключение.
Может ли NexTool видеть мои заявки?
Вызовы вашего GLPI проходят через коннектор, который не хранит вопросы, ответы и содержимое GLPI. Аудит фиксирует только метаданные использования, а учётные данные зашифрованы ключом, который открывает только коннектор.
Что произойдёт, если я отзову ключ или приложение?
Доступ прекратится в течение минуты. Чтобы снова пользоваться, сгенерируйте другой ключ или заново авторизуйте коннектор.
Работает ли с GLPI 10?
Да, через REST API v1. API v2 и инструменты glpi_v2 требуют GLPI 11.
В чём разница между API v1 и API v2?
v1 — классический REST API GLPI 10 и 11 с пользовательским токеном. v2 — новый API GLPI 11 с OAuth. Можно использовать один или оба в одном подключении, всегда с одним и тем же пользователем GLPI.
Готовы подключить свой GLPI?
Создайте бесплатную учётную запись и подключите свой GLPI за несколько минут или начните с версии с открытым исходным кодом.
Не связано с Teclib'. GLPI является зарегистрированным товарным знаком Teclib'.