Jobber Automation MCP

Самодостаточный MCP-сервер, который позволяет ChatGPT просматривать данные Jobber и управлять контролируемой автоматизацией. Один и тот же стек Docker Compose работает на macOS, Linux и Raspberry Pi ARM64.

Это ранняя сборка для одного владельца. Она не предназначена для публичного или мультитенантного хостинга.

Текущий релиз: v0.2.0

Архитектура

flowchart LR
    C[ChatGPT] --> T[Secure MCP Tunnel]
    T --> M[Jobber Automation MCP]
    M --> J[Jobber GraphQL API]
    M --> D[(Private SQLite data)]
    M --> W[Automation worker]

MCP-сервер определяет инструменты, которые ChatGPT может вызывать. Воркер выполняет сохранённые расписания, даже когда чат не открыт. Каталог действий намеренно ограничен; определения автоматизации не могут выполнять произвольные команды операционной системы.

Текущие возможности

• Поток авторизации Jobber OAuth с кодом авторизации и поддержкой ротации refresh-токенов

• Запросы к аккаунту, клиентам и работам Jobber

• Запасные пути для GraphQL только на чтение и подтверждённых мутаций

• Хранение в SQLite с режимом WAL и приватным файлом базы данных

• Инструменты автоматизации: создание, список, получение, обновление, активация, пауза, предпросмотр, запуск сейчас, история и удаление

• Ручные и повторяющиеся интервальные триггеры

• Действия: журнал, запрос Jobber и мутация Jobber

• Жизненный цикл ревью: черновик при создании и черновик после редактирования

• Политики одобрения: одобрение каждого запуска или явно предодобренные автоматизации

• Фоновый планировщик с историей запусков и аудита

• Docker-упаковка, совместимая с разработкой на macOS и хостами Raspberry Pi на Linux ARM64

Поведение безопасности

• Новые и отредактированные автоматизации являются черновиками и не могут запускаться.

• Для активации требуется точная фраза I APPROVE THIS AUTOMATION.

• Автоматизация мутации Jobber с одобрением always не может выполнять мутации из планировщика.

• Её ручной запуск требует I CONFIRM THIS AUTOMATION RUN.

• Автоматизация мутации с preapproved может запускаться без присмотра только после того, как её полное определение проверено и активировано.

• Одиночные разовые мутации требуют I CONFIRM THIS JOBBER CHANGE.

• Состояние OAuth хешируется, используется один раз и истекает через десять минут.

• Каждая попытка мутации и результат автоматизации аудируются.

Установка

Начните с документации, соответствующей задаче:

• Установка и обновления

• Развёртывание и миграция на Raspberry Pi

• Резервное копирование, восстановление и откат

• Политика безопасности

• История версий

Для быстрой локальной настройки разработки требуется Node.js 22.5 или новее:

npm install
npm run build
npm start

База данных по умолчанию находится в ./data/jobber-mcp.sqlite.

Конечная точка MCP для ChatGPT

Локальный путь MCP:

http://localhost:8080/mcp/YOUR_MCP_PATH_TOKEN

Включённый файл Compose запускает OpenAI Secure MCP Tunnel вместе с сервером. Оба опубликованных порта привязаны только к loopback хоста; не открывайте их через проброс портов на роутере.

Пример определения автоматизации

{
  "name": "Hourly account check",
  "description": "Verify that Jobber remains reachable.",
  "approvalPolicy": "always",
  "trigger": { "type": "interval", "everyMinutes": 60 },
  "actions": [
    {
      "type": "jobber.query",
      "query": "query Account { account { id name } }"
    }
  ]
}

Инструмент MCP создаёт это как черновик. Просмотрите его, активируйте, а затем изучите егою.

Разработка

npm run check

Тестовый набор покрывает разделение операций GraphQL и локальный жизненный цикл автоматизации.

Политика релизов

Версии используют семантическое версионирование MAJOR.MINOR.PATCH. Каждый релиз получает Git-тег и соответствующую запись в журнале изменений. До v1.0 минорные релизы могут включать существенные изменения, требующие изучения примечаний к миграции.

Планируемые работы

• Именованные инструменты Jobber на основе аутентифицированной схемы вместо универсального GraphQL

• Триггеры календаря/cron, опроса Jobber и ретрансляции вебхуков

• Условия, шаблоны, уведомления, повторы и ключи идемпотентности

• Встроенная панель автоматизации MCP Apps

• Зашифрованное или поддерживаемое операционной системой хранение токенов

• Автоматическая проверка резервных копий и упрощённые команды восстановления

• Специализированные рабочие процессы планирования и управления визитами

Важные ограничения

• Запланированные работы выполняются только пока хост включён и сервер работает.

• Secure MCP Tunnel соединяет ChatGPT с MCP; это не общий входящий вебхук-эндпоинт Jobber.

• Поля и мутации Jobber должны быть проверены на соответствие аутентифицированной схеме и выбранной версии API перед использованием в производстве.

• Не открывайте локальный порт напрямую в публичный интернет.

Лицензия

Выпущено под лицензией MIT.