Skip to content

v1.2.9

Choose a tag to compare

@Lungshot Lungshot released this 23 Sep 21:37
· 190 commits to main since this release

NinjaONE MCP Server v1.2.10 - MCPB Bundle Release

πŸ”§ Critical Authentication Fix

  • BREAKING: Fixed OAuth2 authentication flow to use client credentials instead of refresh token
  • No refresh token required - extension now works with only Client ID, Client Secret, and Base URL
  • Resolves authentication failures that required refresh token in previous versions

πŸ“– Complete Installation Documentation

  • Added comprehensive README-MCPB.md with step-by-step installation guide
  • 6 detailed screenshots showing complete Claude Desktop installation process
  • Updated main README.md with clear MCPB installation references
  • Added troubleshooting section and security notes

πŸš€ MCPB Bundle Features

  • Production-ready MCPB package with all dependencies included
  • One-click installation in Claude Desktop and MCP-compatible clients
  • Security-hardened implementation with proper error handling
  • Comprehensive logging with sensitive data redaction

βš™οΈ Configuration Simplified

  • Only 3 settings required:
    • NinjaONE Base URL (regional endpoint)
    • OAuth Client ID
    • OAuth Client Secret
  • Auto-detects regional endpoints
  • Clear error messages for configuration issues

πŸ”’ Security Improvements

  • OAuth2 client credentials flow for enhanced security
  • No token storage - automatic token refresh
  • HTTPS-only API communications
  • Input validation and comprehensive error handling

πŸ“¦ What's Included

  • ninjaone-rmm.mcpb - Complete MCPB bundle for Claude Desktop
  • Manifest with proper environment variable configuration
  • All server code with dependencies bundled
  • Regional endpoint support for US, EU, CA, and Oceania

πŸ› οΈ Installation Instructions

  1. Download ninjaone-rmm.mcpb from this release
  2. Install in Claude Desktop via Extensions β†’ Install from MCPB file
  3. Click "Configure" on the installed extension
  4. Enter your NinjaONE credentials (no refresh token needed!)
  5. Start using NinjaONE commands in Claude conversations

πŸ“‹ Full Feature Set

  • 21+ Query Endpoints: Device health, hardware, software, patches, services
  • Device Management: List, reboot, maintenance mode, LED control
  • Patch Management: OS and software patch scanning and deployment
  • Organization Management: Multi-tenant support with alerts and contacts
  • Service Control: Windows service management and monitoring
  • Custom Fields: Support for both standard and scoped custom fields

πŸ› Bug Fixes

  • Fixed environment variable validation (NINJA_* instead of NINJAONE_*)
  • Corrected version display in server logs
  • Resolved cached extension file conflicts
  • Fixed manifest configuration for proper MCPB installation

πŸ”„ Compatibility

  • Claude Desktop: Full MCPB support with UI configuration
  • Node.js 18+: Required for development/source installation
  • All platforms: Windows, macOS, Linux supported
  • Regional endpoints: US, US2, EU, CA, OC supported

πŸ“š Documentation

  • README-MCPB.md - Complete installation guide with screenshots
  • README.md - Full API documentation and development guide
  • Troubleshooting guide for common installation issues

⚠️ Breaking Changes

  • Removed refresh token requirement (authentication now more secure and simpler)
  • Updated environment variable names for consistency
  • MCPB configuration simplified to 3 required fields

🎯 Recommended For

  • MSPs managing multiple client environments
  • IT administrators needing Claude-integrated RMM access
  • Automation enthusiasts building RMM workflows with AI
  • NinjaONE users wanting conversational device management

Download the ninjaone-rmm.mcpb file below and follow the README-MCPB.md to get started!