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: mcp-otobo

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

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
Not graded
quality - not tested
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    A comprehensive MCP server for ServiceNow that provides over 60 pre-built tools for ITSM, ITOM, and App Dev operations, enabling AI agents to manage incidents, changes, users, service catalog, and projects through a unified interface.
    6
    MIT

View all related MCP servers

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