Skip to main content
Glama

Jobber Automation MCP

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

Esta es una versión inicial de un solo propietario. No está diseñada para alojamiento público o multitenant.

Versión actual: v0.2.1

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 invocar. El worker ejecuta las programaciones guardadas incluso cuando no hay ningún chat abierto. El catálogo de acciones está controlado intencionadamente; las definiciones de automatización no pueden ejecutar comandos arbitrarios del sistema operativo.

Related MCP server: Jobber MCP Connector

Capacidades actuales

  • Flujo de código de autorización OAuth de Jobber y soporte de tokens de actualización rotatorios

  • Consultas de cuenta, cliente y trabajo de Jobber

  • GraphQL de solo lectura y vías de escape de mutación explícitamente confirmadas

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

  • Herramientas de automatización: create, list, get, update, activate, pause, preview, run-now, history y delete

  • Disparadores manuales y de intervalo repetido

  • Acciones de Log, 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

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

  • Empaquetado Docker compatible con el desarrollo en macOS y los hosts Raspberry Pi con 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 la aprobación always no puede mutar desde el planificador.

  • 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 puntuales requieren confirmación explícita del usuario. Las confirmaciones aceptadas incluyen I CONFIRM THIS JOBBER CHANGE, I confirm, confirmed, yes, yes, do it, do it, approved e I approve (sin distinción de mayúsculas y minúsculas y con espacios recortados).

  • El estado de OAuth se procesa con hash, es de un solo uso y caduca a los diez minutos.

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

Instalación

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

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 utiliza por defecto ./data/jobber-mcp.sqlite.

Endpoint 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 únicamente al loopback del host; no los expongas mediante el reenvío de puertos del router.

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ízalo, actívalo y luego inspecciona su historial.

Desarrollo

npm run check

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

Política de lanzamientos

Las versiones usan Versionado Semántico MAJOR.MINOR.PATCH. Cada lanzamiento 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 webhook

  • 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 diseñados específicamente

Limitaciones importantes

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

  • Un Secure MCP Tunnel conecta ChatGPT con MCP; no es un endpoint webhook entrante general de Jobber.

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

  • No expongas el puerto local directamente a Internet pública.

Licencia

Publicado bajo la Licencia MIT.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      F
      maintenance
      Enables AI assistants to access and manage Jobber field-service data including clients, jobs, invoices, and quotes through natural language interactions.
      6
      61 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Connect an AI assistant to your Jobber account to query clients, jobs, invoices, and more in plain English, with optional write actions for creating clients and jobs.
      12
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants like Claude, ChatGPT, and Copilot to query live Jobber data—clients, jobs, quotes, invoices, revenue, and schedule—using natural language, with read-only access and careful API budget management.
      1
      MIT