AgentHubAgentHub

HaloPSA MCP Setup & Guide

MCP ServerMCP RegistryOfficial

io.github.Servosity/halopsa-mcp · v0.2.18

HaloPSA ticket triage, SLA-breach pre-emption, and cross-client analytics for any MCP agent.

Copy the install config on this page first, then verify docs and permissions upstream.

Overview

HaloPSA ticket triage, SLA-breach pre-emption, and cross-client analytics for any MCP agent. HaloPSA MCP is a MCP Server listed from MCP Registry. Transports: stdio. This page includes an overview, setup tutorial, install commands, and use cases for Trae, Tongyi Lingma, Cursor, Claude Code, and VS Code.

Use cases

AgentHub Verified AvailabilityTested & Ready

Automated pipeline validated install commands, protocol & client compatibility

Verified At2026-10-04
Install Snippets TestedCLI & JSON config syntax verified
Protocol Handshake ReadyComplies with JSON-RPC 2.0 specifications
Origin Registry ActiveSourced from official-mcp-registry
Verified ClientsClaude Code、Claude Desktop、Cursor 等
Security Tier: A+ 级 · 官方认证推荐 (A+)·Maintained by official/verified teams, audited for standard MCP protocol compliance.
No auto-generated install guide — see the source repository README.

Troubleshooting & Common ErrorsFAQ

Common connection errors and verified fixes for HaloPSA MCP

Getting 'connection closed' or exit code 1 in Cursor / Claude Code for HaloPSA MCP?

Usually caused by missing runtime paths or IDE environment inheritance. Fix steps: 1. Verify Node.js 18+ (npx) or Python 3.10+ (uvx) is installed; 2. Run 'which npx' or 'which uvx' in terminal, and replace 'command' with absolute path; 3. Reload or restart the client window after modifying config.

Fix Snippet
# Check binary path in terminal:
which npx
node -v
Getting 'spawn npx ENOENT' or 'command not found'?

The editor background process does not inherit your full terminal PATH. Solution: Globally install the package, or set the absolute binary path (e.g. C:\Program Files\nodejs\npx.cmd on Windows, or /usr/local/bin/npx on macOS).

Missing required environment variable or authentication failure?

HaloPSA MCP requires environment variables (HALOPSA_CLIENT_ID、HALOPSA_CLIENT_SECRET、HALOPSA_OAUTH_SCOPE、HALOPSA_TENANT). Ensure you have added valid keys under the 'env' object in your config file without trailing whitespace.

Fix Snippet
// .cursor/mcp.json 或 claude_desktop_config.json
{
  "env": {
    "HALOPSA_CLIENT_ID": "your_actual_key_here"
  }
}

Tool Mock Playground

Sandbox

HaloPSA MCP Tool Interface Simulation · Preview tool schema & outputs without local runtime

Sandbox Ready
fn: halopsa_mcpExecute the core tool interface of HaloPSA MCP
Request ArgumentsJSON Schema
{
  "target": "HaloPSA MCP",
  "action": "execute",
  "options": {
    "mode": "standard",
    "timeoutMs": 5000
  }
}
💡Parameters generated dynamically by Agent runtime
Agent Tool Output

Click 'Run Mock' above

to preview the raw response returned to the LLM

Env: AgentHub Virtual SandboxJSON-RPC 2.0

Decision Guide: Why & When to Use

Assess suitability before installing to save trial-and-error time

Best Suited For
  • PR review
  • Changelog generation
  • Cross-repo issue search
When NOT to Use
  • Replacing human security audit
  • Unauthorized repo access
Recommended Workflow Pairing:View Scenario →

HaloPSA MCP + Scenario Prompt → Complete Agent Automation

MCP hands-on: install to visible results

Follow the full lab (expected UI/output + contrast checks). After installing this item, verify with the tutorial prompts.

Open tutorial →

Related resources

Often paired with

Keep exploring AgentHub

Most people compare similar tools or check scenario guides before installing—start here.

Listing badge: put AgentHub on your site

Copy either snippet into your project homepage, docs, or GitHub README. The badge is a hotlinked SVG — nothing to host — and it links back to this page so visitors can find the install steps.

PreviewListed on AgentHub: HaloPSA MCP
HTML
<a href="https://myagenthub.cn/p/io.github.Servosity/halopsa-mcp" title="Listed on AgentHub: HaloPSA MCP" target="_blank" rel="noopener">
  <img src="https://myagenthub.cn/badge/io.github.Servosity/halopsa-mcp?lang=en" alt="Listed on AgentHub: HaloPSA MCP" height="20" style="border:0"/>
</a>
Markdown (GitHub README)
[![Listed on AgentHub: HaloPSA MCP](https://myagenthub.cn/badge/io.github.Servosity/halopsa-mcp?lang=en)](https://myagenthub.cn/p/io.github.Servosity/halopsa-mcp)

Badges are generated on the fly from /badge/<package-id>, so name and listing changes propagate automatically. Keep the link target unchanged — it is what counts as the referral.

Unified Manifest

{
  "id": "io.github.Servosity/halopsa-mcp",
  "type": "mcp-server",
  "version": "0.2.18",
  "displayName": "HaloPSA MCP",
  "description": "HaloPSA ticket triage, SLA-breach pre-emption, and cross-client analytics for any MCP agent.",
  "repository": {
    "url": "https://github.com/servosity/msp-skills",
    "source": "github",
    "subfolder": "skills/halopsa"
  },
  "distribution": {
    "packages": [
      {
        "registryType": "mcpb",
        "identifier": "https://github.com/Servosity/msp-skills/releases/download/halopsa-v0.2.18/halopsa-mcp.mcpb",
        "version": "0.2.18",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "HALOPSA_BASE_URL",
            "description": "Full API base URL. Leave blank: the CLI builds it from HALOPSA_TENANT and HALOPSA_DOMAIN. Set it only to point at a different host."
          },
          {
            "name": "HALOPSA_CLIENT_ID",
            "description": "OAuth2 client_credentials ID from Configuration → Integrations → Halo PSA API.",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "HALOPSA_CLIENT_SECRET",
            "description": "OAuth2 client_credentials secret.",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "HALOPSA_DOMAIN",
            "description": "Domain template variable. Defaults to halopsa.com."
          },
          {
            "name": "HALOPSA_OAUTH_SCOPE",
            "description": "Sets HALOPSA_OAUTH_SCOPE for the HaloPSA MCP server. Required by the generated client for credential refresh or hand-written auth flow.",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "HALOPSA_SCOPE",
            "description": "Optional. OAuth2 scope (defaults to \"all\"); set to a narrower scope when your API application requires it"
          },
          {
            "name": "HALOPSA_TENANT",
            "description": "Your HaloPSA tenant identifier.",
            "isRequired": true
          },
          {
            "name": "HALOPSA_TOKEN",
            "description": "Optional. Pre-issued Bearer access token. Overrides the client_credentials flow when set.",
            "isSecret": true
          },
          {
            "name": "HALOPSA_TOKEN_URL",
            "description": "Token endpoint the client-credentials exchange posts to. Leave blank: the CLI derives it from the base URL."
          },
          {
            "name": "HALOPSA_NO_CONFIG_WRITE",
            "description": "Set to 1 to keep credentials off disk. The token cache becomes a no-op, so the connector mints a fresh token each run instead of writing one to config.toml. Leave blank for the default cached behaviour."
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.Servosity/halopsa-mcp",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.Servosity%2Fhalopsa-mcp/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}