# MSP360 MCP — Node.js (Claude Desktop)

Native **Node.js / TypeScript** MCP server for [Claude Desktop](https://claude.com/download) `.mcpb` extensions. Full parity with the main MSP360 MCP server: **69 tools**, MCP Apps, and conditional MBS/RMM registration.

**Vendor:** [MSP360](https://www.msp360.com/) — Managed Backup and RMM platform this server integrates with.

## Main project (Docker + Python)

This repository is the **Claude Desktop / Node.js** distribution. The canonical project — Python server, Docker image for **Cursor**, tests, and `.mcpb` packaging scripts — lives here:

**[github.com/tonyzorin/msp360-mcp](https://github.com/tonyzorin/msp360-mcp)**

| Runtime | Host | Repo path |
|---------|------|-----------|
| **Node.js** (this repo) | Claude Desktop `.mcpb` | `msp360-mcp-node` — no Docker |
| **Python + Docker** | Cursor, HTTP, STDIO | [`msp360-mcp`](https://github.com/tonyzorin/msp360-mcp) — `tonyzorin/msp360-mcp:2.2.2` |

Install the packaged extension from the main repo: [`mcpb/msp360-mcp.mcpb`](https://github.com/tonyzorin/msp360-mcp/raw/main/mcpb/msp360-mcp.mcpb) (v2.3.0).

Submission checklist: [Connectors Directory guide](https://github.com/tonyzorin/msp360-mcp/blob/main/docs/connectors-submission.md) in the main repo.

## Prerequisites

- Node.js **18+** (Claude Desktop ships Node on macOS/Windows)
- MSP360 API credentials:
  - **MBS:** `MSP360_API_LOGIN` + `MSP360_API_PASSWORD`
  - **RMM (optional):** `MSP360_RMM_API_TOKEN`

Either credential set alone is valid; only matching tools register.

## Quick start

```bash
npm ci
npm run build
MSP360_API_LOGIN=... MSP360_API_PASSWORD=... MSP360_RMM_API_TOKEN=... npm start
```

In a new MCP session, call `mcp_server_info` to confirm version and configured APIs.

## Test

```bash
npm test
```

Expect **69 tools** when both MBS and RMM env vars are set, each with Connectors Directory annotations (`title`, `readOnlyHint` / `destructiveHint`).

## Build Claude Desktop bundle

Packaging scripts and `manifest.json` are in the main repo:

```bash
git clone https://github.com/tonyzorin/msp360-mcp.git
cd msp360-mcp
./scripts/rebuild_mcpb.sh
```

That copies this server's build output into `mcpb/` and produces `mcpb/msp360-mcp.mcpb`.

Version source of truth: `src/version.ts` (currently **2.3.0**).

## License

MIT — see [LICENSE](LICENSE).