Jobber Automation MCP

Ein selbst gehosteter MCP-Server, der es ChatGPT ermöglicht, Jobber-Daten zu prüfen und kontrollierte Automatisierungen zu verwalten. Derselbe Docker-Compose-Stack läuft auf macOS, Linux und Raspberry Pi ARM64.

Dies ist ein früher Build für einen einzelnen Eigentümer. Er ist nicht für öffentliches oder Multi-Tenant-Hosting ausgelegt.

Aktuelle Version: v0.2.0

Architektur

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]

Der MCP-Server definiert die Tools, die ChatGPT aufrufen darf. Der Worker führt gespeicherte Zeitpläne auch dann aus, wenn kein Chat geöffnet ist. Der Aktionskatalog ist bewusst kontrolliert; Automatisierungsdefinitionen können keine beliebigen Betriebssystembefehle ausführen.

Aktuelle Funktionen

• Jobber-OAuth-Autorisierungscode-Flow und Unterstützung für rotierende Refresh-Tokens

• Jobber-Konto-, Kunden- und Auftragsabfragen

• Schreibgeschützte GraphQL- und bestätigte Mutations-Notausgänge

• SQLite-Persistenz mit WAL-Modus und einer privaten Datenbankdatei

• Automatisierungs-Tools zum Erstellen, Auflisten, Abrufen, Aktualisieren, Aktivieren, Pausieren, Vorschauen, Sofort-Ausführen, Verlauf und Löschen

• Manuelle und sich wiederholende Intervall-Trigger

• Protokoll-, Jobber-Abfrage- und Jobber-Mutations-Aktionen

• Lebenszyklus mit Entwurf bei Erstellung und Entwurf nach Bearbeitung

• Richtlinien mit Genehmigung pro Ausführung oder ausdrücklich vorab genehmigten Automatisierungen

• Hintergrundplaner mit Ausführungs- und Audit-Verlauf

• Docker-Paketierung kompatibel mit macOS-Entwicklung und Linux-ARM64-Raspberry-Pi-Hosts

Sicherheitsverhalten

• Neue und bearbeitete Automatisierungen sind Entwürfe und können nicht ausgeführt werden.

• Die Aktivierung erfordert den genauen Ausdruck I APPROVE THIS AUTOMATION.

• Eine Jobber-Mutationsautomatisierung mit always-Genehmigung kann nicht vom Planer aus mutieren.

• Für die manuelle Ausführung ist I CONFIRM THIS AUTOMATION RUN erforderlich.

• Eine preapproved-Mutationsautomatisierung kann nur unbeaufsichtigt ausgeführt werden, nachdem ihre vollständige Definition überprüft und aktiviert wurde.

• Allgemeine einmalige Mutationen erfordern I CONFIRM THIS JOBBER CHANGE.

• Der OAuth-Status ist gehasht, nur einmal verwendbar und läuft nach zehn Minuten ab.

• Jeder Mutationsversuch und jedes Automatisierungsergebnis wird auditiert.

Installation

Beginnen Sie mit der Dokumentation, die zur Aufgabe passt:

• Installation und Updates

• Raspberry-Pi-Bereitstellung und -Migration

• Sicherung, Wiederherstellung und Rollback

• Sicherheitsrichtlinie

• Versionsverlauf

Für die schnelle lokale Entwicklungsumgebung ist Node.js 22.5 oder neuer erforderlich:

npm install
npm run build
npm start

Die Datenbank verwendet standardmäßig ./data/jobber-mcp.sqlite.

ChatGPT-MCP-Endpunkt

Der lokale MCP-Pfad lautet:

http://localhost:8080/mcp/YOUR_MCP_PATH_TOKEN

Die enthaltene Compose-Datei führt den OpenAI Secure MCP Tunnel zusammen mit dem Server aus. Beide veröffentlichten Ports binden nur an den Host-Loopback; setzen Sie sie nicht über Router-Portweiterleitung aus.

Beispiel für eine Automatisierungsdefinition

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

Das MCP-Tool erstellt dies als Entwurf. Zeigen Sie eine Vorschau an, aktivieren Sie es und prüfen Sie dann seinen Verlauf.

Entwicklung

npm run check

Die Testsuite deckt die Trennung von GraphQL-Operationen und den lokalen Automatisierungslebenszyklus ab.

Versionsrichtlinie

Versionen verwenden MAJOR.MINOR.PATCH Semantic Versioning. Jede Version erhält einen Git-Tag und einen passenden Changelog-Eintrag. Bis v1.0 können Nebenversionen erhebliche Änderungen enthalten, die eine Überprüfung der Migrationshinweise erfordern.

Geplante Arbeiten

• Benannte Jobber-Tools basierend auf dem authentifizierten Schema anstelle von generischem GraphQL

• Kalender-/Cron-, Jobber-Polling- und Webhook-Relay-Trigger

• Bedingungen, Vorlagen, Benachrichtigungen, Wiederholungen und Idempotenzschlüssel

• Eingebettetes MCP-Apps-Automatisierungs-Dashboard

• Verschlüsselte oder betriebssystemgestützte Token-Speicherung

• Automatisierte Sicherungsüberprüfung und einfachere Wiederherstellungsbefehle

• Speziell entwickelte Planungs- und Besuchsverwaltungs-Workflows

Wichtige Einschränkungen

• Geplante Arbeiten laufen nur, während der Host aktiv und der Server läuft.

• Ein Secure MCP Tunnel verbindet ChatGPT mit MCP; es ist kein allgemeiner eingehender Jobber-Webhook-Endpunkt.

• Jobber-Felder und -Mutationen müssen vor dem Produktionseinsatz gegen das authentifizierte Schema und die ausgewählte API-Version verifiziert werden.

• Setzen Sie den lokalen Port nicht direkt dem öffentlichen Internet aus.

Lizenz

Veröffentlicht unter der MIT-Lizenz.