Service Desk Plus MCP Server - Model Context Protocol integration for AI assistants
概览
A Model Context Protocol (MCP) server that integrates with Service Desk Plus Cloud API, enabling AI assistants to perform CRUD operations on all Service Desk Plus entities. 🎉 - Complete Service Desk Plus MCP Server ✅ (100% Success Rate) ✅ - Full ITSM integration with comprehensive OAuth scopes ✅ - Reply to requesters with ticket conversation integration ✅ - Bulletproof token management with rate limit protection ✅ - All tools validated through comprehensive client testing ✅ - Robust error handling and business rule compliance - 🔧 Fixed Authorization header format from Bearer to Zoho-oauthtoken - 🔧 Added subcategory as mandatory field for request creation - 🔧 Implemented proper list_info structure with search_criteria - 🔧 Added advanced search capabilities with complex criteria - 🔧 Created comprehensive OAuth and search documentation - 🔧 Mock API now perfectly replicates real API behaviors - 🔧 : Email communication tools for requester replies - 🔧 : Private notes and first...
README
以下为原文 README 节选，完整内容请查看原文。
Service Desk Plus MCP Server
A Model Context Protocol (MCP) server that integrates with Service Desk Plus Cloud API, enabling AI assistants to perform CRUD operations on all Service Desk Plus entities.
🚀 Current Status (January 2025)
🎉 PRODUCTION READY - Complete Service Desk Plus MCP Server
✅ ALL 16 TOOLS WORKING PERFECTLY (100% Success Rate)
✅ Enterprise Grade - Full ITSM integration with comprehensive OAuth scopes
✅ Email Communication - Reply to requesters with ticket conversation integration
✅ Zero OAuth Issues - Bulletproof token management with rate limit protection
✅ Complete Testing - All tools validated through comprehensive client testing
✅ Production Ready - Robust error handling and business rule compliance
Recent Improvements
- 🔧 Fixed Authorization header format from Bearer to Zoho-oauthtoken
- 🔧 Added subcategory as mandatory field for request creation
- 🔧 Implemented proper list_info structure with search_criteria
- 🔧 Added advanced search capabilities with complex criteria
- 🔧 Created comprehensive OAuth and search documentation
- 🔧 Mock API now perfectly replicates real API behaviors
- 🔧 NEW: Email communication tools for requester replies
- 🔧 NEW: Private notes and first response functionality
- 🔧 NEW: Full conversation history retrieval
Tool Status
- ✅ list_requests - Working with proper search_criteria
- ✅ get_request - Working
- ✅ search_requests - Enhanced with advanced criteria support
- ✅ get_metadata - Working
- ✅ add_note - Working
- ✅ reply_to_requester - NEW - Email reply functionality working
- ✅ add_private_note - NEW - Private notes working
- ✅ send_first_response - NEW - First response with email working
- ✅ get_request_conversation - NEW - Conversation history working
- ✅ list_technicians - Working with fallback to /users endpoint
- ✅ get_technician - Working
- ✅ find_technician - Working
- ✅ create_request - Fixed with subcategory support
- ✅ update_request - Working (priority updates blocked by API design)
- ✅ close_request - Working with proper closure handling
- ✅ claude_code_command - Working
Working Implementation
- Architecture: Direct MCP protocol over Server-Sent Events (SSE)
- Location:
sdp-mcp-server/src/working-sse-server.cjs - Status: All Service Desk Plus tools operational
- Client: Successfully tested with Claude Code
📋 Available Tools
Request Management
- list_requests - List service desk requests with optional filters
- get_request - Get detailed information about a specific request
- search_requests - Search requests using various criteria
- create_request - Create new service desk requests
- update_request - Update existing requests
- close_request - Close requests with closure information
- add_note - Add notes to existing requests
Email Communication (NEW)
安装
npx mcp-remote http://localhost:3456/sse --allow-http配置
{
"mcpServers": {
"service-desk-plus": {
"command": "npx",
"args": ["mcp-remote", "http://localhost:3456/sse", "--allow-http"]
}
}
}