# HaloPSA

MCP-сервер HaloPSA для Claude Code подключает сервис деск HaloPSA через REST API. Управляет заявками, клиентами и счетами прямо в сессии агента.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 у репозитория
- Автор: WYRE-AI
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/WYRE-AI/halopsa-mcp
- Обновлён: 2026-11-16
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/halopsa

## Что делает

Инструмент связывает агента с платформой HaloPSA для учёта заявок, контрагентов, оборудования и выставленных счетов. Вместо выгрузки десятков методов сразу сервер применяет иерархическую схему: сначала доступна навигация `halopsa_navigate`, а инструменты конкретного раздела подгружаются только после выбора нужной области.

В тикетах можно обновлять статусы, просматривать списки и фиксировать затраченное время через параметр `time_minutes` (сервер сам переводит минуты в десятичные доли часа). Для запуска требуются `HALOPSA_CLIENT_ID`, `HALOPSA_CLIENT_SECRET` и адрес тенанта `HALOPSA_TENANT` либо `HALOPSA_BASE_URL`. При установке пакета через npm обязателен токен GitHub с правом `read:packages`, поскольку зависимость опубликована в GitHub Packages.

## Требования
- Нужно: Docker
- Переменные окружения: `HALOPSA_CLIENT_ID`, `HALOPSA_CLIENT_SECRET`, `HALOPSA_TENANT`, `HALOPSA_BASE_URL`, `MCP_TRANSPORT`, `AUTH_MODE`, `LOG_LEVEL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 сервера

## Когда брать
- создавать и обновлять тикеты службы поддержки в HaloPSA
- списывать время работы по заявке через параметр `time_minutes`
- искать компании-клиенты и привязанные конфигурационные единицы
- просматривать список счетов и команды технических специалистов

## Примеры запросов агенту
- Вызови halopsa_navigate и открой домен тикетов
- Найди в HaloPSA клиента с названием Acme Corp
- Добавь в тикет 1042 действие с описанием проблемы и спиши 30 минут работы

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
