ServiceDesk Plus MCP Server

ServiceDesk Plus MCP Server

MCP (Model Context Protocol) server để tích hợp với ServiceDesk Plus On-Premise với hỗ trợ đầy đủ CMDB.

🎯 Tính năng

Ticket Management

• ✅ Quản lý tickets (tạo, cập nhật, xem danh sách, xóa)
• ✅ Tìm kiếm và lọc tickets
• ✅ Quản lý comments và attachments
• ✅ Workflow automation

CMDB (Configuration Management Database)

• ✅ Configuration Items (CIs) - Quản lý servers, network devices, software
• ✅ Asset Management - Quản lý hardware, software, locations
• ✅ Software License Management - Tracking licenses, compliance
• ✅ Contract Management - Vendor contracts, SLA tracking
• ✅ Purchase Order Management - Procurement automation
• ✅ Vendor Management - Vendor relationships, contacts

Admin Management

• ✅ Site Management - Quản lý sites, locations, branches
• ✅ User Group Management - Quản lý groups, permissions, roles
• ✅ User & Technician Management - CRUD operations, role assignment
• ✅ Permission Management - Role-based permissions, access control
• ✅ Department Management - Organizational structure
• ✅ Location Management - Physical locations, rooms, floors
• ✅ System Settings - Email, notifications, system configuration

User Management

• ✅ Quản lý users và technicians
• ✅ Role-based access control
• ✅ User provisioning

Advanced Features

• ✅ Authentication với ServiceDesk Plus API
• ✅ Real-time data synchronization
• ✅ Comprehensive error handling
• ✅ Async/await for high performance
• ✅ Pagination và filtering
• ✅ Search capabilities

📦 Cài đặt

1. Cài đặt dependencies:

2. Tạo file .env với thông tin cấu hình:

3. Chạy MCP server:

⚙️ Cấu hình MCP Client

Với Claude Desktop

Thêm vào file cấu hình MCP (~/.config/claude/desktop-config.json):

Với Cursor

Thêm vào file cấu hình MCP:

🛠️ API Endpoints

Ticket Management (15 tools)

• list_tickets - Lấy danh sách tickets với bộ lọc
• get_ticket - Lấy thông tin chi tiết ticket
• create_ticket - Tạo ticket mới
• update_ticket - Cập nhật ticket
• delete_ticket - Xóa ticket
• search_tickets - Tìm kiếm tickets
• add_ticket_comment - Thêm comment
• get_ticket_comments - Lấy comments

CMDB - Configuration Items (7 tools)

• list_configuration_items - Lấy danh sách CIs
• get_configuration_item - Lấy chi tiết CI
• create_configuration_item - Tạo CI mới
• update_configuration_item - Cập nhật CI
• delete_configuration_item - Xóa CI
• get_ci_types - Lấy loại CIs
• get_ci_relationships - Lấy relationships

Asset Management (10 tools)

• list_assets - Lấy danh sách assets
• get_asset - Lấy chi tiết asset
• create_asset - Tạo asset mới
• update_asset - Cập nhật asset
• delete_asset - Xóa asset
• get_asset_types - Lấy loại assets
• get_asset_categories - Lấy danh mục assets
• get_asset_locations - Lấy vị trí assets
• get_asset_models - Lấy model assets
• get_asset_vendors - Lấy vendor assets

Software License Management (6 tools)

• list_software_licenses - Lấy danh sách licenses
• get_software_license - Lấy chi tiết license
• create_software_license - Tạo license mới
• update_software_license - Cập nhật license
• get_software_products - Lấy software products
• get_license_types - Lấy loại licenses

Contract Management (6 tools)

• list_contracts - Lấy danh sách contracts
• get_contract - Lấy chi tiết contract
• create_contract - Tạo contract mới
• update_contract - Cập nhật contract
• get_contract_types - Lấy loại contracts
• get_contract_vendors - Lấy vendor contracts

Purchase Order Management (5 tools)

• list_purchase_orders - Lấy danh sách POs
• get_purchase_order - Lấy chi tiết PO
• create_purchase_order - Tạo PO mới
• update_purchase_order - Cập nhật PO
• get_po_statuses - Lấy trạng thái POs

Vendor Management (5 tools)

• list_vendors - Lấy danh sách vendors
• get_vendor - Lấy chi tiết vendor
• create_vendor - Tạo vendor mới
• update_vendor - Cập nhật vendor
• get_vendor_types - Lấy loại vendors

Admin Management - Sites (6 tools)

• list_sites - Lấy danh sách sites
• get_site - Lấy chi tiết site
• create_site - Tạo site mới
• update_site - Cập nhật site
• delete_site - Xóa site
• get_site_types - Lấy loại sites

Admin Management - User Groups (8 tools)

• list_user_groups - Lấy danh sách user groups
• get_user_group - Lấy chi tiết user group
• create_user_group - Tạo user group mới
• update_user_group - Cập nhật user group
• delete_user_group - Xóa user group
• get_group_types - Lấy loại groups
• get_group_permissions - Lấy permissions của group
• update_group_permissions - Cập nhật permissions cho group

Admin Management - Users & Technicians (12 tools)

• list_admin_users - Lấy danh sách admin users
• get_admin_user - Lấy chi tiết admin user
• create_admin_user - Tạo admin user mới
• update_admin_user - Cập nhật admin user
• delete_admin_user - Xóa admin user
• list_admin_technicians - Lấy danh sách admin technicians
• get_admin_technician - Lấy chi tiết admin technician
• create_admin_technician - Tạo admin technician mới
• update_admin_technician - Cập nhật admin technician
• delete_admin_technician - Xóa admin technician
• get_user_roles - Lấy user roles
• get_technician_roles - Lấy technician roles

Admin Management - Permissions (5 tools)

• get_permissions - Lấy danh sách permissions
• get_role_permissions - Lấy permissions của role
• update_role_permissions - Cập nhật permissions cho role
• get_user_permissions - Lấy permissions của user
• update_user_permissions - Cập nhật permissions cho user

Admin Management - Departments (6 tools)

• list_departments - Lấy danh sách departments
• get_department - Lấy chi tiết department
• create_department - Tạo department mới
• update_department - Cập nhật department
• delete_department - Xóa department
• get_department_types - Lấy loại departments

Admin Management - Locations (6 tools)

• list_locations - Lấy danh sách locations
• get_location - Lấy chi tiết location
• create_location - Tạo location mới
• update_location - Cập nhật location
• delete_location - Xóa location
• get_location_types - Lấy loại locations

Admin Management - System Settings (6 tools)

• get_system_settings - Lấy system settings
• update_system_settings - Cập nhật system settings
• get_email_settings - Lấy email settings
• update_email_settings - Cập nhật email settings
• get_notification_settings - Lấy notification settings
• update_notification_settings - Cập nhật notification settings

User Management (3 tools)

• list_users - Lấy danh sách users
• get_user - Lấy thông tin user
• list_technicians - Lấy danh sách technicians

Reference Data (3 tools)

• get_categories - Lấy danh mục tickets
• get_priorities - Lấy mức độ ưu tiên
• get_statuses - Lấy trạng thái tickets

🎯 Ví dụ Sử Dụng

Quản lý Infrastructure:

Quản lý Software:

Quản lý Contracts:

Quản lý Procurement:

Quản lý Admin:

📊 Tính năng Nổi Bật

• 🔄 Async/await - Hiệu suất cao với async operations
• 🛡️ Error handling - Xử lý lỗi toàn diện
• 🔐 Authentication - Hỗ trợ Basic Auth và API Key
• 📄 Pagination - Quản lý dữ liệu lớn hiệu quả
• 🔍 Filtering - Bộ lọc linh hoạt cho tất cả endpoints
• 📝 Validation - Kiểm tra dữ liệu đầu vào
• 📊 Logging - Ghi log chi tiết cho debugging
• ⚙️ Configuration - Quản lý cấu hình linh hoạt

🚀 Lợi Ích

1. Centralized Management - Quản lý tập trung toàn bộ IT infrastructure
2. Compliance Tracking - Theo dõi compliance với licenses và contracts
3. Asset Lifecycle - Quản lý toàn bộ lifecycle của assets
4. Vendor Management - Quản lý hiệu quả các vendor relationships
5. Procurement Automation - Tự động hóa quy trình mua sắm
6. Reporting & Analytics - Báo cáo và phân tích dữ liệu CMDB
7. AI Integration - Tích hợp AI để tự động hóa các tác vụ

📚 Tài liệu Chi tiết

• 📖 Hướng dẫn sử dụng chi tiết
• 🏗️ Tính năng CMDB
• 🧪 Test Connection

🔧 Troubleshooting

Chạy script test để kiểm tra kết nối:

Kiểm tra logs để debug:

Version: 2.0.0
Total Tools: 100+ tools
CMDB Support: ✅ Full Support
Admin Management: ✅ Full Support
License: MIT