Jobber Automation MCP

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

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

Текущий выпуск: v0.2.1

Архитектура

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 может вызывать. Воркер выполняет сохранённые расписания, даже когда чат не открыт. Каталог действий намеренно ограничен; определения автоматизаций не могут выполнять произвольные команды операционной системы.

Related MCP server: Jobber MCP Server

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

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

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

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

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

• Инструменты автоматизации: create, list, get, update, activate, pause, preview, run-now, history и delete

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

• Действия Log, Jobber query и Jobber mutation

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

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

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

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

Меры безопасности

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

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

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

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

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

• Разовые мутации общего назначения требуют явного подтверждения пользователя. Принимаются следующие подтверждения: I CONFIRM THIS JOBBER CHANGE, I confirm, confirmed, yes, yes, do it, do it, approved и I approve (без учёта регистра и с обрезкой пробелов).

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

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

Установка

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

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

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

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

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

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

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

npm install
npm run build
npm start

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

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

Локальный путь 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.