HaloPSA and Servosity in Claude Desktop

Claude Desktop is the most common MSP-owner choice for MSP Skills - a Mac/Windows app with a chat window, no terminal after install. This guide installs the HaloPSA and Servosity MSP Skills as MCP servers in Claude Desktop in about 60 seconds.

Claude Desktop is Anthropic’s original MCP host - first-class native MCP support, no Plus / Pro tier required (Claude Desktop itself is free; you pay only for Claude usage). modelcontextprotocol.io/quickstart/user

What you need

Step 1 - Install MSP Skills binaries

macOS / Linux:

bash <(curl -fsSL https://raw.githubusercontent.com/servosity/msp-skills/main/skills/halopsa/install.sh)
bash <(curl -fsSL https://raw.githubusercontent.com/servosity/msp-skills/main/skills/servosity/install.sh)

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/servosity/msp-skills/main/skills/halopsa/install.ps1 | iex
iwr -useb https://raw.githubusercontent.com/servosity/msp-skills/main/skills/servosity/install.ps1 | iex

Install only the ones you’ll use. Each installer drops the CLI and the MCP server on your PATH.

Step 2 - Edit Claude Desktop’s config

Open Claude Desktop → Settings → Developer → Edit Config. (This opens the JSON in your default editor.) Add the mcpServers block:

{
  "mcpServers": {
    "halopsa": {
      "command": "halopsa-mcp",
      "env": {
        "HALOPSA_TENANT": "<your-tenant>",
        "HALOPSA_CLIENT_ID": "<your-client-id>",
        "HALOPSA_CLIENT_SECRET": "<your-client-secret>"
      }
    },
    "servosity": {
      "command": "servosity-mcp",
      "env": {
        "SERVOSITY_MSP_TOKEN": "<your-partner-token>"
      }
    }
  }
}

Save the file.

Step 3 - Restart Claude Desktop

Quit completely (not just close - File → Quit on Mac, or right-click → Quit on Windows) and reopen. An MCP indicator appears bottom-right of the chat input once the servers connect.

Step 4 - Ask a real question

In Claude Desktop chat:

Claude reads the available MCP tools and runs the right commands.

Troubleshooting

MCP indicator never appears: JSON syntax error in claude_desktop_config.json. Validate with jq . or any JSON linter. Common gotchas: trailing commas, unescaped backslashes on Windows paths.

“halopsa-mcp: command not found”: the installer didn’t put the binary on your PATH. The installer prints the line to add (something like export PATH="$HOME/.local/bin:$PATH"). Add it to ~/.zshrc or ~/.bashrc (macOS/Linux) or your Windows PATH, restart your terminal, then quit and reopen Claude Desktop.

Authentication errors: confirm you can run halopsa-cli doctor or servosity-cli doctor in a terminal first. If the CLI works, the MCP server will too with the same credentials.

Want shell-driven install instead of JSON editing?

If you’ve moved (or want to move) onto Claude Cowork (Anthropic’s desktop agent with shell execution, GA Mar 2026), you can skip the config-file editing entirely - paste one prompt and Cowork runs the installer for you.

What’s next

← Back to main install