Jobber Automation MCP

ChatGPTがJobberのデータを確認し、管理された自動化を実行できるようにするセルフホスト型MCPサーバーです。同じ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認可コードフローとローテーション式リフレッシュトークンのサポート

• Jobberのアカウント、クライアント、ジョブのクエリ

• 読み取り専用GraphQLと確認済みミューテーションのエスケープハッチ

• WALモードとプライベートデータベースファイルによるSQLite永続化

• 自動化の作成、一覧表示、取得、更新、有効化、一時停止、プレビュー、即時実行、履歴、削除ツール

• 手動および繰り返し間隔トリガー

• ログ、Jobberクエリ、Jobberミューテーションアクション

• 作成時ドラフトと編集後ドラフトのレビューライフサイクル

• 実行ごとの承認または明示的に事前承認された自動化ポリシー

• 実行履歴と監査履歴を備えたバックグラウンドスケジューラー

• macOS開発環境とLinux ARM64 Raspberry Piホストに対応したDockerパッケージ

安全動作

• 新規および編集された自動化はドラフトであり、実行できません。

• 有効化には正確なフレーズ I APPROVE THIS AUTOMATION が必要です。

• always 承認を使用するJobberミューテーション自動化は、スケジューラーからミューテーションを実行できません。

• 手動実行には I CONFIRM THIS AUTOMATION RUN が必要です。

• preapproved ミューテーション自動化は、完全な定義がレビューされ有効化された後にのみ無人実行できます。

• 一般的な単発ミューテーションには I CONFIRM THIS JOBBER CHANGE が必要です。

• OAuth状態はハッシュ化され、一度きりの使用で、10分後に失効します。

• すべてのミューテーション試行と自動化結果が監査されます。

インストール

タスクに合ったドキュメントから始めてください:

• インストールと更新

• 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をサーバーと一緒に実行します。公開された両方のポートはホストのループバックにのみバインドされます。ルーターのポートフォワーディングで公開しないでください。

自動化定義の例

{
  "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までは、マイナーリリースに移行ノートの確認が必要な大幅な変更が含まれる場合があります。

計画中の作業

• 汎用GraphQLの代わりに認証済みスキーマに基づく名前付きJobberツール

• カレンダー/cron、Jobberポーリング、Webhookリレートリガー

• 条件、テンプレート、通知、リトライ、冪等性キー

• 組み込みMCP Apps自動化ダッシュボード

• 暗号化またはオペレーティングシステムバックアップのトークンストレージ

• 自動バックアップ検証とよりシンプルな復元コマンド

• 専用のスケジューリングおよび訪問管理ワークフロー

重要な制限事項

• スケジュールされた作業は、ホストが起動中でサーバーが実行中の場合のみ実行されます。

• Secure MCP TunnelはChatGPTをMCPに接続します。これは一般的なインバウンドJobber Webhookエンドポイントではありません。

• Jobberのフィールドとミューテーションは、本番使用前に認証済みスキーマと選択したAPIバージョンに対して検証する必要があります。

• ローカルポートをパブリックインターネットに直接公開しないでください。

ライセンス

MITライセンスの下で公開されています。