HaloPSA — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер HaloPSA для Claude Code подключает сервис деск HaloPSA через REST API. Управляет заявками, клиентами и счетами прямо в сессии агента.
Apache-2.0 ★ 5 обновлён 2026-11-16
claude mcp add --env HALOPSA_CLIENT_ID=<HALOPSA_CLIENT_ID> --env HALOPSA_CLIENT_SECRET=<HALOPSA_CLIENT_SECRET> --env HALOPSA_TENANT=<HALOPSA_TENANT> --env HALOPSA_BASE_URL=<HALOPSA_BASE_URL> --env MCP_TRANSPORT=<MCP_TRANSPORT> --transport stdio halopsa -- docker run -i --rm -e HALOPSA_CLIENT_ID -e HALOPSA_CLIENT_SECRET -e HALOPSA_TENANT -e HALOPSA_BASE_URL -e MCP_TRANSPORT ghcr.io/wyre-ai/halopsa-mcp:v1.8.4Что делает HaloPSA
Инструмент связывает агента с платформой HaloPSA для учёта заявок, контрагентов, оборудования и выставленных счетов. Вместо выгрузки десятков методов сразу сервер применяет иерархическую схему: сначала доступна навигация halopsa_navigate, а инструменты конкретного раздела подгружаются только после выбора нужной области.
В тикетах можно обновлять статусы, просматривать списки и фиксировать затраченное время через параметр time_minutes (сервер сам переводит минуты в десятичные доли часа). Для запуска требуются HALOPSA_CLIENT_ID, HALOPSA_CLIENT_SECRET и адрес тенанта HALOPSA_TENANT либо HALOPSA_BASE_URL. При установке пакета через npm обязателен токен GitHub с правом read:packages, поскольку зависимость опубликована в GitHub Packages.
Какие задачи решает
- создавать и обновлять тикеты службы поддержки в HaloPSA
- списывать время работы по заявке через параметр
time_minutes - искать компании-клиенты и привязанные конфигурационные единицы
- просматривать список счетов и команды технических специалистов
Примеры запросов агенту
- Вызови halopsa_navigate и открой домен тикетов
- Найди в HaloPSA клиента с названием Acme Corp
- Добавь в тикет 1042 действие с описанием проблемы и спиши 30 минут работы
Как установить HaloPSA
Командой платформы
claude mcp add --env HALOPSA_CLIENT_ID=<HALOPSA_CLIENT_ID> --env HALOPSA_CLIENT_SECRET=<HALOPSA_CLIENT_SECRET> --env HALOPSA_TENANT=<HALOPSA_TENANT> --env HALOPSA_BASE_URL=<HALOPSA_BASE_URL> --env MCP_TRANSPORT=<MCP_TRANSPORT> --transport stdio halopsa -- docker run -i --rm -e HALOPSA_CLIENT_ID -e HALOPSA_CLIENT_SECRET -e HALOPSA_TENANT -e HALOPSA_BASE_URL -e MCP_TRANSPORT ghcr.io/wyre-ai/halopsa-mcp:v1.8.4Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
codex mcp add halopsa --env HALOPSA_CLIENT_ID=<HALOPSA_CLIENT_ID> --env HALOPSA_CLIENT_SECRET=<HALOPSA_CLIENT_SECRET> --env HALOPSA_TENANT=<HALOPSA_TENANT> --env HALOPSA_BASE_URL=<HALOPSA_BASE_URL> --env MCP_TRANSPORT=<MCP_TRANSPORT> -- docker run -i --rm -e HALOPSA_CLIENT_ID -e HALOPSA_CLIENT_SECRET -e HALOPSA_TENANT -e HALOPSA_BASE_URL -e MCP_TRANSPORT ghcr.io/wyre-ai/halopsa-mcp:v1.8.4Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"halopsa": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HALOPSA_CLIENT_ID",
"-e",
"HALOPSA_CLIENT_SECRET",
"-e",
"HALOPSA_TENANT",
"-e",
"HALOPSA_BASE_URL",
"-e",
"MCP_TRANSPORT",
"ghcr.io/wyre-ai/halopsa-mcp:v1.8.4"
],
"env": {
"HALOPSA_CLIENT_ID": "<HALOPSA_CLIENT_ID>",
"HALOPSA_CLIENT_SECRET": "<HALOPSA_CLIENT_SECRET>",
"HALOPSA_TENANT": "<HALOPSA_TENANT>",
"HALOPSA_BASE_URL": "<HALOPSA_BASE_URL>",
"MCP_TRANSPORT": "<MCP_TRANSPORT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"halopsa": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HALOPSA_CLIENT_ID",
"-e",
"HALOPSA_CLIENT_SECRET",
"-e",
"HALOPSA_TENANT",
"-e",
"HALOPSA_BASE_URL",
"-e",
"MCP_TRANSPORT",
"ghcr.io/wyre-ai/halopsa-mcp:v1.8.4"
],
"env": {
"HALOPSA_CLIENT_ID": "<HALOPSA_CLIENT_ID>",
"HALOPSA_CLIENT_SECRET": "<HALOPSA_CLIENT_SECRET>",
"HALOPSA_TENANT": "<HALOPSA_TENANT>",
"HALOPSA_BASE_URL": "<HALOPSA_BASE_URL>",
"MCP_TRANSPORT": "<MCP_TRANSPORT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e HALOPSA_CLIENT_ID=<HALOPSA_CLIENT_ID> -e HALOPSA_CLIENT_SECRET=<HALOPSA_CLIENT_SECRET> -e HALOPSA_TENANT=<HALOPSA_TENANT> -e HALOPSA_BASE_URL=<HALOPSA_BASE_URL> -e MCP_TRANSPORT=<MCP_TRANSPORT> halopsa docker run -i --rm -e HALOPSA_CLIENT_ID -e HALOPSA_CLIENT_SECRET -e HALOPSA_TENANT -e HALOPSA_BASE_URL -e MCP_TRANSPORT ghcr.io/wyre-ai/halopsa-mcp:v1.8.4Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о HaloPSA
Как установить HaloPSA в Claude Code?
Выполните команду: `claude mcp add --env HALOPSA_CLIENT_ID=<HALOPSA_CLIENT_ID> --env HALOPSA_CLIENT_SECRET=<HALOPSA_CLIENT_SECRET> --env HALOPSA_TENANT=<HALOPSA_TENANT> --env HALOPSA_BASE_URL=<HALOPSA_BASE_URL> --env MCP_TRANSPORT=<MCP_TRANSPORT> --transport stdio halopsa -- docker run -i --rm -e HALOPSA_CLIENT_ID -e HALOPSA_CLIENT_SECRET -e HALOPSA_TENANT -e HALOPSA_BASE_URL -e MCP_TRANSPORT ghcr.io/wyre-ai/halopsa-mcp:v1.8.4`.
Что делает HaloPSA?
Сервер даёт ассистенту доступ к тикетам, клиентам, счетам, агентам и активам через REST API системы HaloPSA. Набор инструментов открывается пошагово после выбора нужного домена.
Что нужно для работы HaloPSA?
Нужны учётные данные OAuth 2.0 (HALOPSA_CLIENT_ID, HALOPSA_CLIENT_SECRET), имя тенанта HALOPSA_TENANT или HALOPSA_BASE_URL, а также Docker. При установке через npm требуется токен GitHub с правом read:packages.