Skip to main content
Glama

mcp-itop

MCP-сервер для iTop ITSM — аналитика, заявки, комментарии, база знаний, CI.

Предоставляет AI-ассистентам (opencode, Claude Desktop, Cursor) 19 инструментов для работы с iTop: SLA-аналитика, нагрузка агентов, качество услуг, жизненный цикл заявок, поиск по БЗ, impact-анализ CI.

Возможности

Аналитика

Инструмент

Описание

itop_sla_report

SLA-отчёт по услуге за период (TTO/TTR passed/breached/N/A, медиана решения)

itop_agent_workload

Загрузка агентов: закрытые/открытые заявки, time_spent, backlog

itop_idle_agents

Поиск заявок, где агент бездействует >N часов без действий

itop_service_quality

Поиск похожих заявок, назначенных на разные услуги

itop_caller_quality

Качество выбора услуг пользователями

itop_agent_correction_rate

Агенты, которые исправляют / не исправляют услуги

itop_ticket_summary

Дашборд: создано/решено/открыто/SLA breaches

Комментарии

Инструмент

Описание

itop_add_comment

Добавить публичный или приватный комментарий к заявке

itop_get_log

Прочитать историю комментариев (public_log, private_log)

База знаний

Инструмент

Описание

itop_search_kb

Поиск статей БЗ (поддерживает KBEntry и FAQ)

itop_get_kb_article

Полный текст статьи

itop_list_kb_categories

Список рубрик БЗ

CRUD + Жизненный цикл

Инструмент

Описание

itop_get

Поиск объектов (OQL / ID / JSON-критерии)

itop_create

Создание объекта

itop_update

Обновление полей объекта

itop_delete

Удаление с simulate-режимом

itop_apply_stimulus

Жизненный цикл: ev_assign, ev_resolve, ev_close, ev_reopen

itop_get_related

Impact-анализ CI (impacts/depends on)

itop_describe_class

Разведка полей класса по существующему объекту

Related MCP server: kaseya-bms-mcp

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

1. Установка

pip install mcp[fastmcp] httpx python-dotenv

2. Настройка (глобальный конфиг)

mkdir -p ~/.config/mcp-itop
cat > ~/.config/mcp-itop/.env << 'CONFIG'
ITOP_URL=https://your-itop.example.com
# Токен или логин+пароль:
ITOP_TOKEN=ваш_токен_здесь
# ITOP_USER=admin
# ITOP_PASSWORD=secret
ITOP_VERSION=1.3
ITOP_VERIFY_SSL=true
ITOP_TIMEOUT=30
CONFIG

3. Запуск

python server.py

Интеграция

opencode (глобальный конфиг)

Добавить в ~/.config/opencode/opencode.json:

"itop": {
  "type": "local",
  "command": ["python", "/путь/до/mcp-itop/server.py"],
  "enabled": true
}

opencode (на проект)

Добавить в opencode.json проекта:

{
  "mcpServers": {
    "itop": {
      "command": "python",
      "args": ["/путь/до/mcp-itop/server.py"],
      "env": {
        "ITOP_URL": "https://your-itop.example.com",
        "ITOP_TOKEN": "ваш_токен"
      }
    }
  }
}

Claude Desktop

Добавить в claude_desktop_config.json:

{
  "mcpServers": {
    "itop": {
      "command": "python",
      "args": ["/путь/до/mcp-itop/server.py"]
    }
  }
}

Примеры запросов

Покажи SLA по услуге "Техподдержка" за этот месяц
Кто из агентов перегружен?
Какие заявки висят без движения больше 2 часов?
Найди похожие заявки с разными услугами
Кто из пользователей часто выбирает не ту услугу?
Добавь комментарий к заявке RQ-123
Создай новую заявку: Не работает принтер
Назначь RQ-456 на Иванова
Найди CI, связанные с сервером srv-web-01
Поищи в БЗ по VPN

Совместимость

Протестировано на:

  • iTop 3.2.1-1-16749 (PHP 8.1.2, MariaDB 10.6)

  • Поддерживает русскую локаль (да/нет для SLA) и английскую (true/false)

  • Автоопределение модуля БЗ: KBEntry → FAQ

Требования

  • Python ≥ 3.10

  • mcp[fastmcp]

  • httpx

  • python-dotenv

Тесты

python -m pytest tests/ -v

Архитектура

AI-клиент → MCP (stdio) → server.py → iTop REST API

Приоритет конфигурации:

  1. ~/.config/mcp-itop/.env (глобальный, наивысший приоритет)

  2. .env (локальный в папке проекта)

  3. Переменные окружения

Лицензия

MIT

F
license - not found
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/gest0r1/mcp-itop'

If you have feedback or need assistance with the MCP directory API, please join our Discord server