Jobber Automation MCP

Un servidor MCP autoalojado que permite a ChatGPT inspeccionar datos de Jobber y gestionar automatizaciones controladas. La misma pila de Docker Compose se ejecuta en macOS, Linux y Raspberry Pi ARM64.

Esta es una compilación temprana de un solo propietario. No está diseñada para alojamiento público o multiinquilino.

Versión actual: v0.2.0

Arquitectura

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]

El servidor MCP define las herramientas que ChatGPT puede llamar. El trabajador ejecuta los horarios guardados incluso cuando no hay un chat abierto. El catálogo de acciones está controlado intencionalmente; las definiciones de automatización no pueden ejecutar comandos arbitrarios del sistema operativo.

Capacidades actuales

• Soporte para el flujo de código de autorización OAuth de Jobber y tokens de actualización rotativos

• Consultas de cuentas, clientes y trabajos de Jobber

• Vías de escape de GraphQL de solo lectura y mutaciones confirmadas

• Persistencia SQLite con modo WAL y un archivo de base de datos privado

• Herramientas de automatización: crear, listar, obtener, actualizar, activar, pausar, previsualizar, ejecutar ahora, historial y eliminar

• Disparadores manuales y de intervalo repetitivo

• Acciones de registro, consulta de Jobber y mutación de Jobber

• Ciclo de revisión de borrador al crear y borrador después de editar

• Políticas de automatización con aprobación por ejecución o preaprobadas explícitamente

• Programador en segundo plano con historial de ejecución y auditoría

• Empaquetado Docker compatible con desarrollo macOS y hosts Raspberry Pi Linux ARM64

Comportamiento de seguridad

• Las automatizaciones nuevas y editadas son borradores y no pueden ejecutarse.

• La activación requiere la frase exacta I APPROVE THIS AUTOMATION.

• Una automatización de mutación de Jobber que use aprobación always no puede mutar desde el programador.

• Su ejecución manual requiere I CONFIRM THIS AUTOMATION RUN.

• Una automatización de mutación preapproved solo puede ejecutarse sin supervisión después de que su definición completa sea revisada y activada.

• Las mutaciones genéricas únicas requieren I CONFIRM THIS JOBBER CHANGE.

• El estado OAuth se codifica, es de un solo uso y expira después de diez minutos.

• Cada intento de mutación y resultado de automatización se audita.

Instalación

Comience con la documentación que coincida con la tarea:

• Instalación y actualizaciones

• Despliegue y migración en Raspberry Pi

• Copia de seguridad, restauración y reversión

• Política de seguridad

• Historial de versiones

La configuración rápida de desarrollo local requiere Node.js 22.5 o superior:

npm install
npm run build
npm start

La base de datos por defecto es ./data/jobber-mcp.sqlite.

Punto de conexión MCP de ChatGPT

La ruta MCP local es:

http://localhost:8080/mcp/YOUR_MCP_PATH_TOKEN

El archivo Compose incluido ejecuta el OpenAI Secure MCP Tunnel junto con el servidor. Ambos puertos publicados se vinculan solo al loopback del host; no los exponga mediante el reenvío de puertos del enrutador.

Ejemplo de definición de automatización

{
  "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 } }"
    }
  ]
}

La herramienta MCP crea esto como borrador. Previsualícelo, actívelo y luego inspeccione su historial.

Desarrollo

npm run check

El conjunto de pruebas cubre la separación de operaciones GraphQL y el ciclo de vida local de automatización.

Política de versiones

Las versiones usan Versionado Semántico MAJOR.MINOR.PATCH. Cada versión recibe una etiqueta Git y una entrada de changelog correspondiente. Hasta v1.0, las versiones menores pueden incluir cambios sustanciales que requieren revisar las notas de migración.

Trabajo planificado

• Herramientas Jobber con nombre basadas en el esquema autenticado en lugar de GraphQL genérico

• Disparadores de calendario/cron, sondeo de Jobber y retransmisión de webhooks

• Condiciones, plantillas, notificaciones, reintentos y claves de idempotencia

• Panel de automatización integrado de MCP Apps

• Almacenamiento de tokens cifrado o respaldado por el sistema operativo

• Verificación automatizada de copias de seguridad y comandos de restauración más simples

• Flujos de trabajo de programación y gestión de visitas específicos

Limitaciones importantes

• El trabajo programado se ejecuta solo mientras el host está activo y el servidor está en ejecución.

• Un Secure MCP Tunnel conecta ChatGPT a MCP; no es un punto de conexión general de webhook entrante de Jobber.

• Los campos y mutaciones de Jobber deben verificarse contra el esquema autenticado y la versión de API seleccionada antes de su uso en producción.

• No exponga el puerto local directamente a Internet público.

Licencia

Publicado bajo la Licencia MIT.