HaloPSA MCP

HaloPSA + AI - Claude、ChatGPT、Codex、Cursor、および MCP に対応するあらゆるエージェント向け

非公式です。HaloPSA、HaloITSM、HaloCRM API 向けの、コミュニティが開発した Claude Code スキルおよび MCP サーバーです。Halo Service Solutions Ltd. とは提携しておらず、同社からの承認やスポンサー提供も受けていません。HaloPSA、HaloITSM、HaloCRM は Halo Service Solutions Ltd. の商標です。

_{▶ 30 秒のデモを見る - デモデータはシミュレーションです。表示されているすべてのコマンドは、実際の CLI に存在します。}

お使いの AI に、HaloPSA チケットのトリアージ、SLA 違反の事前防止、クライアントごとの状況把握、クライアント横断分析を追加できます - Claude Code、Claude Desktop、ChatGPT（Plus/Pro+）、Codex、Cursor、Windsurf、Cline、Continue、Gemini、GitHub Copilotに対応しています。無料のオープンソースで、ノートパソコン上で動作します。ローカルの SQLite ミラーにより、ライブの Halo API では一度に返せないクライアント横断の質問にも AI が回答できます - QBR の準備中にレート制限に達することもありません。MSP オーナー向けに開発されています。コードは不要です。

お使いのエージェントで利用できます

MSP オーナーが実際に使用している 5 つのエージェント：

お使いの AI エージェント	HaloPSA スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions から halopsa-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	インストーラーを実行し、halopsa-mcp を HTTPS 経由で公開して、Developer Mode コネクターとして登録します。
Claude Code	以下のインストールプロンプトを貼り付けます。
Codex CLI	以下のインストールプロンプトを貼り付けます。
Claude Cowork	以下のインストールプロンプトを貼り付けます。

ChatGPT では、halopsa-mcp --transport http を実行し、HTTPS の背後で公開してください - ブリッジパッケージは不要です。mcp-install.md を参照してください。

次のツールにも対応しています： Cursor、Windsurf、Cline、Continue.dev、Zed、GitHub Copilot、Gemini CLI - さらに、MCP と事前設定済みのスキル frontmatter の両方を使って Hermes と OpenClaw にも対応しています。ツールごとの詳しい接続方法：docs/which-agent.md。

複数のエージェントを使っていますか？ 1 つのコマンドで、サポート対象の 51 以上のエージェントすべてにインストールできます：npx skills add Servosity/msp-skills@latest（Node.js が必要です。その後、CLI/MCP バイナリ用のスキル別インストーラーを実行してください）。docs/which-agent.md を参照してください。

60 秒でインストール

Claude Desktop を最速で使う - ワンクリック .mcpb

Claude Desktop バンドル： .mcpb は macOS（Intel および Apple Silicon）、Windows x64、Linux x64 で起動します。すべてのツールは、付属の halopsa-cli を呼び出して実行されます。2026-09-18 以降にリリースされたバージョンでは、この CLI がバンドルに同梱されています。それ以前のバンドルには MCP サーバーのみが含まれているため、付属プログラムがない場合は、以下の Path A または Path B のインストーラーを先に実行してください（または HALOPSA_CLI_PATH に既存のバイナリを設定してください）。詳細： #331。

HaloPSA MCP をダウンロード（.mcpb） - ダウンロード後、Claude Desktop > Settings > Extensions を開き、ファイルを選択してください。ワンクリックで完了し、JSON の編集もシェル操作も不要です。（すべての HaloPSA リリースはリリースページで確認できます。）

Claude Code プラグインを使いたい場合は、マーケットプレイスを一度追加してからインストールしてください - ディレクトリ一覧を取得する必要はなく、すぐに使えます：

/plugin marketplace add Servosity/msp-skills
/plugin install halopsa@msp-skills

パス A - AI エージェントにプロンプトを 1 つ貼り付ける（推奨）

Claude Code、Codex CLI、または Claude Cowork に次の内容をコピーしてください。

このエージェントのワークスペースに、Servosity/msp-skills の HaloPSA Skill と MCP サーバーをインストールしてください。このワークスペースが POSIX シェル（macOS、Linux、WSL、または Bash）を使用している場合は、bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/halopsa/install.sh) を実行してください。Windows PowerShell を使用している場合は、iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/halopsa/install.ps1 | iex を実行してください。その後、halopsa-cli auth login で認証してください（テナントの Configuration > Integrations > Halo PSA API で認証情報を確認できます）。続けて halopsa-cli --help を実行して内容を確認してください。

シェルを実行できるエージェントであれば、同じプロンプトを使用できます。

パス B - インストーラーを自分で実行する

Windows（PowerShell）：

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

macOS / Linux：

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

インストーラーは、halopsa-cli（CLI）と halopsa-mcp（MCP サーバー）の両方をユーザーの bin パスに配置します。Claude Code、Codex、Cowork は、このディレクトリ内の SKILL.md を介して Skill を検出します。Skill が実際に操作するのはバイナリです。

確認：

halopsa-cli --version

最新バージョンにアップグレードする

インストーラーは常に最新リリースを取得するため、アップグレードするには再実行してください。

macOS / Linux：

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

Windows（PowerShell）：

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

Claude Desktop の .mcpb ユーザー：最新の .mcpb（このセクションの先頭）をダウンロードし、Settings > Extensions で再選択してください。Claude Code プラグインのユーザー：/plugin update halopsa@msp-skills。

Claude Desktop、Cursor、Windsurf、Cline、Continue、Gemini、または Copilot に追加する

インストーラーの実行後、エージェントごとの接続方法については mcp-install.md および docs/which-agent.md を参照してください。最も簡単なのは、Claude Desktop の Settings > Extensions パネルを使用する方法です。

Hermes にインストールする

Hermes CLI から：

hermes skills install servosity/msp-skills/skills/halopsa --force

Hermes のチャットセッション内で：

/skills install servosity/msp-skills/skills/halopsa --force

Hermes は MCP をネイティブにサポートしているため、halopsa-mcp サーバーを直接使用することもできます。インストール方法と環境変数は同じです。

OpenClaw にインストールする

OpenClaw は GA です。このリポジトリから Skill を直接インストールしてください。

openclaw skills install git:Servosity/msp-skills/skills/halopsa@main

または、OpenClaw エージェントに次の内容を伝えてください（コピーして使用できます）。

このリポジトリ https://github.com/Servosity/msp-skills/tree/main/skills/halopsa から halopsa skill をインストールしてください。metadata.openclaw のフロントマターで、必要な CLI（halopsa-cli）と環境変数が宣言されています。不足しているものがある場合は、openclaw doctor を実行してください。

openclaw も MCP をネイティブにサポートしています（OpenClaw MCP ドキュメントの openclaw mcp set を参照）。そのため、Skill と併せて halopsa-mcp を MCP サーバーとして接続できます。

認証する

HaloPSA は OAuth2 client_credentials を使用します。テナントで Configuration → Integrations → Halo PSA API の下に API アプリケーションを作成し（Authentication Method：Client ID and Secret、Services）、次のコマンドを実行してください。

HALOPSA_TENANT=<yourtenant> halopsa-cli auth login \
  --client-id <id> --client-secret <secret>

CLI はアクセストークンをキャッシュし、有効期限が切れる前に自動更新します。

このスキルでできること

結果を重視し、それぞれの質問に答えるコマンドをひとつずつ示します。

MSP からよく聞かれる質問	コマンド
今後 24 時間以内に SLA 違反になりそうなものは何ですか？	halopsa-cli sla breaching --within 24h
すべてのエージェントとチームのディスパッチ状況はどうなっていますか？	halopsa-cli triage --team Support
現在、負荷が高すぎるのは誰ですか？	halopsa-cli agent workload
このクライアントの全体像を、1 画面で確認するには？	halopsa-cli client card "Acme Corp"
すべての契約で、残りの契約時間はどれくらいですか？	halopsa-cli contracts burn
チケットの対応期限が迫っているクライアントはどこですか？	halopsa-cli tickets age-out
今朝から Halo で何が変わりましたか？	halopsa-cli tickets changed-since 9:00
このデバイスの資産履歴はどうなっていますか？	halopsa-cli asset history <id>
技術者がリンクすべき KB 記事はどれですか？	halopsa-cli kbarticle suggest --ticket 12345
ローカル SQLite ミラーを初めて同期するには	halopsa-cli sync --full

コマンドの全リファレンスはguide.mdを参照してください。AI エージェントの運用ルール（--agent、--dry-run、変更を加える前に確認すべきタイミング）については、AGENTS.mdを参照してください。

ほかとの違い

多くの HaloPSA MCP サーバーや AI 連携では、質問のたびにライブ API 呼び出しへ中継します。チケット 1 件なら問題ありません。しかし、四半期ごとのビジネスレビュー（QBR）で、「前四半期に全 47 クライアントで発生したバックアップ失敗チケットは何件で、契約タイプ別ではどうなっているか？」と尋ねる場面では機能しません。ページ分割された REST 呼び出しが 47 回必要になり、HaloPSA のレート制限（上限は公開されておらず、ホスティング環境によって異なります）に悩まされ、モデルが読み直さなければならない生の JSON でコンテキストウィンドウが埋まってしまいます。

このスキルは、HaloPSA を全文検索機能付きのローカル SQLite ミラーに同期します。集計に関する質問は、ローカルでの SQL 結合 1 回で答えられるため、即座に、オフラインで結果が得られ、AI には生データではなく答えが表示されます。triage、client card、contracts burnのような複合コマンドは、チケット、クライアント、契約、時間、資産を横断して結合します。ステートレスな API ラッパーでは実現できない処理です。

HaloPSA に組み込まれた ChatGPT 連携（返信の書き換えや感情のフラグ付けなど、チケット単位の作業に優れています）を補完します。両者の機能は重複しません。

解消する課題

MSP のオーナーが繰り返し挙げる、2 つの課題があります。

• サービス提供コストの上昇が、契約価値の伸びを上回っています。 ひっ迫の原因は運用面にあります。キューの過負荷、SLA 違反、チケットごとに利益を削る未請求作業です。
• 特定の人への依存。 「最も優秀な技術者が明日退職したら、30 日以内にクライアントは気づくでしょうか？」ほとんどの MSP では答えは「はい」です。状況把握に必要な情報が特定の人の頭の中にあり、PSA ではほかの人が迅速にトリアージできないためです。

このスキルにより、PSA 内のエンティティを横断した全体像を、チームメンバーやそのエージェントがひとこと尋ねるだけで把握できます。triage／sla breachingは、SLA 違反が発生する前にその兆候を示します。client cardは、誰でも必要なときに状況把握用のパネルを表示できます。contracts burnは、未請求作業を早期に検出します。agent workloadは、チーム全体のキューを見える化します。PSA の読み解き方に関する知識を、個人から、チームメンバー（またはそのエージェント）が実行できるスキルへと移します。

よくある質問

ChatGPT で使えますか？

はい、Plus、Pro、Team、Business、Enterprise、Educationの各プランで利用できます（Free プランでは、現時点で Developer Mode を利用できません）。ChatGPT が HTTPS 経由で接続するのはリモート MCP サーバーであり、ローカルの stdio バイナリではありません。HaloPSA MCP サーバーはローカルで動作しますが、HTTP にネイティブ対応しています。halopsa-mcp --transport http --addr :7777で起動し、HTTPS トンネルまたは独自のリバースプロキシの背後に配置してください。ブリッジパッケージは不要です。手順はmcp-install.mdを参照してください。

Codex、Cursor、Windsurf、Cline、Copilot、Geminiでも動作しますか？

はい。いずれもMCPに対応しています。ツールをまたいだインストールコマンドは上のマトリックスに、詳しい説明はdocs/which-agent.mdに記載されています。ツール固有の注意点（CopilotではmcpServersではなくserversを使用すること、ClineでのWindowsにおけるnpxの問題、ChatGPTのプランとブリッジ）も、そちらに記載されています。

コーディングの知識は必要ですか？

いいえ。推奨されるインストール方法は、Claude CodeまたはCodexに1文貼り付けることです。エージェントがSKILL.mdを読み込み、インストールを行います。代替方法として、OSごとに1行のインストーラー（bashまたはPowerShell）もあります。どちらの方法でも、コードを書く必要はありません。HaloPSA APIの認証情報を一度入力するだけです。

HaloPSAのデータは安全ですか？

データはお使いのマシンに保存されます。CLIとMCPサーバーはローカルのバイナリです。SQLiteのミラーはユーザーアカウント配下のディレクトリに置かれます。AI エージェントに見えるのは、CLIが返す内容だけです。通常はクエリ結果であり、大量の生データではありません。認証情報は環境またはエージェントの設定から読み込まれます。このリポジトリに含まれたり、MSP Skillsによってどこかへ送信されたりすることはありません。

HaloPSA APIのレート制限に達しますか？

ほとんどありません。HaloPSAのレート制限は公開されておらず、クラウドホスト型とセルフホスト型のインスタンスによって異なります。このスキルはsync --fullで一度同期した後、差分同期を行います。それ以降のトリアージ、SLA、クライアントカード、クライアント横断分析のクエリは、ライブAPIではなくローカルミラーに対して実行されます。APIパススルー型のツールでは429エラーになる大規模な一括クエリも、ここでは1つのSQL結合として実行できます。

HaloPSAに組み込まれているChatGPT連携とは何が違いますか？

HaloPSAに組み込まれているChatGPT連携は、返信の書き換え、1件のチケットの要約、感情のフラグ付けなど、単一チケットの作業に適しています。MSP Skillsは、クライアント横断分析と、MSPオーナーがくつろぎながら使える機能を担います。数千件のチケットを横断する質問、HaloPSAとServosityを結合する複数システムのクエリ、HaloPSAのUIには表示されないアドホックレポートなどに対応します。この2つは相互に補完するもので、どちらか一方を選ぶ必要はありません。

Windowsで実行できますか？

はい。上記のPowerShellインストーラーがWindows用の方法です。CLIとMCPのバイナリはネイティブのWindowsビルドです。WindowsでClineを使用する場合は、docs/which-agent.mdに記載されている簡単なnpx回避策が必要になることがあります。

費用はかかりますか？

無料です。Apache-2.0ライセンスで提供されています。料金が発生するのは、使用するAI エージェント（Claude、ChatGPT、Codexなど）のみで、その料金は当社ではなくAIプロバイダーから請求されます。

安全性モデル

このスキルは、ユーザーが作成してスコープを設定したOAuthアプリケーションを使用して、ユーザー自身のHaloテナントに認証します。変更を加える前に、検出とドライランを行う設定がデフォルトです。

レベル	例	推奨されるエージェントポリシー
読み取り	triage、sla breaching、client card、contracts burn	許可
書き込み（定型作業）	チケットの更新、メモ、割り当て	--dry-runでプレビューした後、レビュー済みの書き込みを実行
破壊的操作／設定	削除、設定の変更	必ず人間が介在

最も強力な制御手段は、Halo OAuthアプリケーションに付与するスコープです。CLIで実行できるのは、そのアプリケーションに許可された操作だけです。制限の設定方法を含む詳細は、governance.mdをご覧ください。

ステータス

ベータ版です。HaloPSA API の仕様に照らして検証済みで、毎週開催している Build Sessions では、MSP が本番環境のテナントに接続して実際に運用しながら検証を進めています。compoundingteams.com/build-sessions から参加登録できます。

---

標準規格。 オープンな Agent Skills spec（Anthropic、2025 年 12 月；40 以上のエージェント）に準拠しています。MCP と互換性があり、Hermes や OpenClaw を含む、MCP 対応のあらゆるエージェントで動作します。metadata.openclaw のフロントマターはあらかじめ設定されているため、openclaw skills install で直接インストールできます。

MSP コミュニティ向けに Servosity が保守しています。Apache-2.0 ライセンスです。CLI Printing Press で構築されています。ベンダーとの非提携については TRADEMARKS.md をご覧ください。最終更新日：2026-05-28。