mcpField
O
OpsConduit Jobber MCP

OpsConduit Jobber MCP

ローカル
github.com/opsconduitビジネス・マーケティング123 週間前に更新
リポジトリ

OpsConduit Jobber MCP について

OpsConduit Jobber MCPは、現場サービス業務向けの顧客ホスト型・読み取り専用Jobberコネクターです。ローカルOAuth設定とGraphQLレポートで、経営者や運営担当者が対応事項を把握できます。プロジェクトは初期実装段階です。

主な機能

  1. 01Jobber OAuthのローカル設定
  2. 02トークンのローカル更新と保存
  3. 03接続アカウントの検証
  4. 04読み取り権限確認用の顧客データサンプル
  5. 05読み取り専用Jobber GraphQLクエリ
  6. 06送信前の変更操作ブロック

活用シーン

  1. 01フォローアップが必要な見積もりの特定
  2. 02期限超過請求書や未スケジュール作業の確認
  3. 03最近活動のない顧客の特定
  4. 04週ごとの要対応業務レポートの作成

MCP 対応

MCPサーバーは、Jobber OAuth、アカウント検証、顧客サンプルの読み取り、読み取り専用GraphQLレポートのツールを公開します。変更操作は送信前にブロックされます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "opsconduit-jobber": {
      "command": "npx",
      "args": [
        "-y",
        "@opsconduit/jobber-mcp"
      ],
      "env": {
        "JOBBER_CLIENT_ID": "<JOBBER_CLIENT_ID>",
        "JOBBER_CLIENT_SECRET": "<JOBBER_CLIENT_SECRET>",
        "JOBBER_REDIRECT_URI": "<JOBBER_REDIRECT_URI>"
      }
    }
  }
}
起動コマンドnpx -y @opsconduit/jobber-mcp
設定が必要な環境変数
JOBBER_CLIENT_IDJobber developer app client id for customer-owned OAuth setup.
JOBBER_CLIENT_SECRETシークレットJobber developer app client secret. Keep local; do not email or publish.
JOBBER_REDIRECT_URIOAuth redirect URI, usually http://localhost:3333/oauth/callback for local setup.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@opsconduit/jobber-mcp0.1.3

ツール

6

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
statestringいいえJobber からのリダイレクト時に検証する、不透明な CSRF/state トークン。省略すると、OpsConduit が生成します。
redirectUristringいいえJobber 開発者アプリで設定した OAuth コールバック URL。例：http://localhost:3333/oauth/callback。

詳細

OpsConduit Jobber MCP

Jobber のフィールドサービス業務向け読み取り専用 MCP コネクターです。

OpsConduit は、ビジネスの運営に使っているツールについて、オーナーや運営担当者が実用的な質問をできるよう支援します。この最初のコネクターは Jobber 向けで、デフォルトで読み取り専用となるよう設計されています。

購入検討者向けの概要は、docs/index.md にあります。 購入検討者からよく寄せられる質問への回答は、docs/faq.md にあります。 オーナーや運営担当者向けのプロンプト例は、docs/operator-prompts.md にあります。 最初の有料導入で納品する成果物の形式は、docs/first-report.md にあります。

回答できる内容

  • フォローアップが必要な見積もりはどれですか？
  • 支払期限を過ぎている請求書はどれですか？
  • 未スケジュール、停滞中、またはブロックされている作業はどれですか？
  • 最近、対応履歴のない顧客はどれですか？
  • 今週、対応が必要な作業は何ですか？
  • 運用上のフォローアップの漏れによって、どこで収益を失っていますか？

購入検討者向けの使用例は、docs/use-cases.md にあります。

架空の出力例は、docs/demo-output.md で確認するか、次を実行してください。

npm run demo

有料パイロットの引き継ぎ形式は、docs/pilot-deliverable-template.md に記載されています。

製品の方針

  • まずは顧客環境でホストします。
  • まずは読み取り専用で提供します。
  • 公開リポジトリで認証情報を預かる必要はありません。
  • 顧客システムへの自律的な書き込みは行いません。
  • 非公開データのスクレイピングは行いません。
  • 虚偽の主張、偽の推薦文、欺瞞的な勧誘は行いません。

提供プラン

早期アクセス価格は、docs/offer.md に記載されています。

パイロットのセットアップについては、件名を Jobber pilot として [email protected] までメールでお問い合わせください。Jobber のパスワード、トークン、API シークレット、または非公開の顧客データをメールで送信しないでください。

インストール

Node.js 20+ が必要です。

mkdir opsconduit-jobber
cd opsconduit-jobber
npm install @opsconduit/jobber-mcp
cp node_modules/@opsconduit/jobber-mcp/.env.example .env
npx opsconduit-jobber-auth
npx opsconduit-jobber-mcp

認証ヘルパーを実行する前に、.env の JOBBER_CLIENT_ID と JOBBER_CLIENT_SECRET を設定してください。ヘルパーは Jobber OAuth の URL を表示し、ローカルのコールバック http://localhost:3333/oauth/callback を受信して、トークンを .opsconduit/jobber-tokens.json に保存します。

詳しいセットアップ手順は、docs/install.md にあります。有料パイロットの検証手順は、docs/pilot-checklist.md にあります。 Jobber の GraphQL API に関する実装メモは、docs/jobber-api-notes.md にあります。

MCP ツール

  • jobber_auth_url - 顧客環境でのインストール用に、1 回限りの Jobber OAuth 認可リンクを作成します。
  • jobber_exchange_code - リダイレクトされた OAuth コードを交換し、チャットにトークンを表示せずにローカルへ保存します。
  • jobber_refresh_token - 保存済みのアクセストークンを更新し、読み取り専用レポートを継続できるようにします。
  • jobber_account - 運用クエリを実行する前に、接続済みアカウントを検証します。
  • jobber_clients_sample - 件数を制限したクライアントサンプルで、読み取りアクセスを検証します。
  • jobber_graphql_read - オーナー向けレポート用に読み取り専用の Jobber GraphQL を実行します。ミューテーションは送信前にブロックされます。

ポリシー

ステータス

このリポジトリは実装初期段階です。最初の実用版として、ローカル OAuth セットアップと読み取り専用の Jobber GraphQL アクセスに対応した、顧客環境でホストする MCP サーバーを目指しています。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。