jobber-mcp-server

Jobber MCP Server

Jobber 用の MCP サーバーです。MCP 対応クライアントを Jobber のフィールドサービスデータに接続できます。

これは何ですか？

Jobber のデータ（クライアント、作業、請求書、見積もり）に、整った型付き API を通じて AI アシスタントやエージェントからアクセスできる MCP（Model Context Protocol） サーバーです。

Claude Desktop、Cursor、Windsurf、Cline、または MCP 対応クライアントと連携して、自然言語で業務データについて質問したり、見積もりを作成したり、フィールドサービス業務を管理したりできます。

使う理由

• 組み込みツール 6 種類 — クライアント、作業、請求書、見積もりを 1 つのサーバーで管理
• モックモード — Jobber アカウントがなくても、偽のデータを使ってすぐに試せます
• 自然言語での問い合わせ — 「期限超過の請求書を表示して」と尋ねるだけで使えます
• 見積もりの作成 — Jobber を開かずに見積もりを作成して送信できます
• クライアント検索 — クライアントの詳細、連絡先情報、作業履歴を検索できます
• あらゆる MCP クライアントで動作 — Claude Desktop、Cursor、Windsurf、Cline などに対応

クイックスタート

MCP クライアントの設定ファイル（例：claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "jobber": {
      "command": "npx",
      "args": ["-y", "jobber-mcp-server"],
      "env": {
        "JOBBER_ACCESS_TOKEN": "your_token",
        "JOBBER_CLIENT_ID": "your_client_id",
        "JOBBER_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

または、まずモックデータで試すこともできます（Jobber アカウントは不要です）。

JOBBER_MOCK_MODE=true npx jobber-mcp-server

API 認証情報は Jobber Developer Portal で取得してください。

使い方

AI アシスタントに、次のように尋ねてみてください。

• 「すべてのクライアントを一覧表示して」
• 「client-101 の詳細を表示して」
• 「Alex Reyes に割り当てられている作業は？」
• 「Northwind Roofing の見積もりを作成して。緊急修理を 2 時間、1 時間あたり 150 ドルで」
• 「期限超過の請求書はどれ？」

ツール

ツール	説明
list_clients	任意の検索、リードの絞り込み、件数制限を指定してクライアントを一覧表示します
get_client	ID を指定してクライアントを取得します。連絡先情報と最近の作業も含まれます
get_job	作業の詳細を取得します。ステータス、担当者、スケジュール、明細が含まれます
list_invoices	クライアントやステータスで請求書を絞り込んで一覧表示します
get_invoice	明細と支払い状況を含む請求書の詳細を取得します
create_quote	明細を指定して、クライアント向けの新しい見積もりを作成します

ユースケース

毎日の業務確認

「今日の作業と、期限超過の請求書を表示して」と尋ねれば、対応が必要な項目を朝一番にまとめて確認できます。まず Jobber のダッシュボードにログインする必要はありません。

クライアントの調査

「Northwind Roofing とのこれまでの経緯は？」と尋ねれば、現地訪問や営業電話の前に、クライアントの詳細、最近の作業、未払いの請求書を確認できます。

見積もりの作成

「Chen さんの見積もりを作成して。雨どいの清掃を 1 時間、120 ドルで」と頼めば、アプリを切り替えずに現場から見積もりを作成して送信できます。

請求書の監査

「500 ドルを超える未払いの請求書をすべて表示して」と尋ねれば、Jobber の請求書一覧を手動で絞り込まずに、期限超過の支払いを見つけてフォローアップできます。

フィールドサービスのレポート

「今週の Alex Reyes の作業をまとめて」と頼めば、レポートを手動で取得せずに、チームミーティングや給与計算用の実績サマリーを作成できます。

セキュリティ

• OAuth 認証情報が必要です — Jobber API は OAuth2 を使用します。認証情報は環境変数経由で渡され、ログに記録されることはありません。
• ローカルファイルへのアクセスはありません — モックモードを有効にしない限り、お使いのマシン上のファイルの読み取りや書き込みは行いません。
• シェルへのアクセスはありません — コマンドの実行やプロセスの起動は行いません。
• モックモードは安全です — JOBBER_MOCK_MODE=true を設定すると、Jobber への API 呼び出しなしで偽のデータを使用します。
• オープンソースです — MIT ライセンスです。GitHub でコードを確認できます。

トラブルシューティング

「Authentication failed」エラー

JOBBER_CLIENT_ID、JOBBER_CLIENT_SECRET、JOBBER_ACCESS_TOKEN が正しいことを確認してください。トークンには有効期限があります。最新の認証情報については、Jobber Developer Portal を確認してください。

モックモードで「No data found」と表示される

環境または MCP 設定で JOBBER_MOCK_MODE=true が設定されていることを確認してください。モックモードでは、サンプルのクライアント、ジョブ、請求書が自動的に作成されます。

サーバーが起動しない

Node.js 18 以降がインストールされていることを確認してください：node --version。npx を使用する場合は、npm が最新であることを確認してください：npm install -g npm@latest。

MCP クライアントが接続できない

設定ファイルのパスが正しいことを確認してください。Claude Desktop では、macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の場合は %APPDATA%\Claude\claude_desktop_config.json を使用します。設定を変更した後は、クライアントを再起動してください。

応答が遅い

Jobber の GraphQL API のレイテンシーは約 200～500ms です。複雑なクエリ（たとえば、すべてのジョブ履歴を含めてクライアントを一覧表示するクエリ）では、さらに時間がかかる場合があります。初回のクエリを高速化するには、list_clients に limit パラメーターを指定してください。

Jobber API のセットアップ

実際の Jobber アカウントで使用するには：

1. Jobber Developer Portal にアクセスします
2. アプリを作成し、client_id と client_secret を取得します
3. OAuth フローを完了して access_token を取得します
4. 認証情報を .env または MCP クライアントの設定に追加します

要件

• Node.js 18+
• API アクセス権のある Jobber アカウント。または、テスト用に JOBBER_MOCK_MODE=true を使用してください

開発

git clone https://github.com/friendlygeorge/jobber-mcp-server.git
cd jobber-mcp-server
npm install
npm run build
npm run inspect   # opens MCP Inspector for testing

ライセンス

MIT