Jobkeepr

Jobkeepr MCP サーバー

Jobkeepr を Claude、ChatGPT、その他の MCP クライアントに接続すると、AI アシスタントが現場サービス事業の業務（案件、顧客、スケジュール、見積もり、請求書、支払い）を確認・管理できます。

Jobkeepr は、便利屋、テレビ設置業者、配管工、電気工事士、空調技術者など、1〜10 人で働く小規模な請負業者チーム向けの現場サービス管理ソフトウェアです。

"What's on my schedule tomorrow?"
"Which service made me the most money last month?"
"Book Sarah Chen for a TV mount Thursday at 2pm."
"Mark today's jobs complete."

接続方法は 2 通り

リモート（推奨）。 クライアントがリモート MCP サーバーに対応している場合は、ホストされたエンドポイントに直接接続すれば、このパッケージをインストールする必要はありません。

https://jobkeepr.com/mcp

OAuth に対応しているため、普段使用している Jobkeepr のログイン情報でサインインし、ブラウザーでアクセスを承認します。インストールは不要です。

stdio（このパッケージ）。 stdio のみを使用するクライアント向けに、API キーを使って同じサーバーに接続します。

このパッケージは npm にはありません。 以下に示す github:dandyer/jobkeepr-mcp 指定子を使って、GitHub から直接インストールしてください。 通常の npx jobkeepr-mcp では見つかりません。npm がインストール時に TypeScript をコンパイルするため、追加の実行作業は必要ありません。

セットアップ

Jobkeepr の Settings → API Keys で API キーを作成します。キーは一度だけ表示されるため、そのときにコピーしてください。

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "jobkeepr": {
      "command": "npx",
      "args": ["-y", "github:dandyer/jobkeepr-mcp"],
      "env": {
        "JOBKEEPR_API_KEY": "jk_live_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add jobkeepr --env JOBKEEPR_API_KEY=jk_live_your_key_here -- npx -y github:dandyer/jobkeepr-mcp

リモートエンドポイントに直接接続することもできます。

claude mcp add --transport http jobkeepr https://jobkeepr.com/mcp

ツール

読み取り

ツール	機能
get_business_context	事業名、タイムゾーン、営業時間、今日の日付、および「今週」「先月」などに対応する期間
get_jobs	日付、ステータス、顧客、種類、または流入元で絞り込んだ案件
get_customers	顧客を検索します。必要に応じて案件数と合計も取得します
get_schedule	予定されている案件、カレンダーイベント、空き時間枠
get_estimates	見積もりとそのステータス
get_invoices	請求書と未払い残高
get_payments	受領した支払い
get_line_items	利益率や構成の分析に使う、案件全体の明細項目
get_reference_data	案件の種類、リードの流入元、価格カタログ

書き込み

ツール	機能
create_job	顧客の案件を予約します
create_event	休暇や現地確認など、案件ではないカレンダーイベントを追加します
create_customer	顧客を追加します
create_estimate	見積もりを作成します
create_catalog_item	価格カタログにサービスまたは商品を追加します
add_line_items	請求対象の明細項目を案件に追加します
set_customer_source	顧客が事業を知った経緯を記録します
reschedule_job	案件の日付または時刻を変更します
cancel_job	予定されている案件をキャンセルします
close_jobs	案件を完了としてマークします

財務関連ツールには VIEW_FINANCIALS 権限が必要です。また、各書き込みツールには対応する権限が必要です。使用できないツールは表示されません。

このツールでできないこと

このツールでは顧客にテキストメッセージを送信できません。 SMS の送信は意図的に対象外としています。実際の人に届き、取り消せない唯一の操作だからです。アシスタントにメッセージの下書きを作成させ、Jobkeepr からご自身で送信してください。

書き込み操作はすぐに反映されます。ステージングの手順も取り消し機能もありません。そのため、cancel_job と close_jobs は破壊的な操作としてマークされ、実行前にクライアントが確認を求めます。close_jobs は一度に多くの案件を処理できるため、承認する前に対象を確認してください。

設定

変数	必須	デフォルト	備考
JOBKEEPR_API_KEY	はい	—	Settings → API Keys で取得します。jk_live_ で始まります。
JOBKEEPR_URL	いいえ	https://jobkeepr.com	セルフホスト環境またはステージング環境でのみ変更してください。

API キーは 1 つのアカウントに対して機能し、オーナーレベルのアクセス権を持ちます。Settings → API Keys からいつでも取り消せます。代わりに、ユーザーごとに範囲を限定したアクセス権をアシスタントに付与するには、OAuth を使ってリモートエンドポイントに接続してください。

仕組み

このパッケージは再実装ではなく、プロキシです。ツールはホストされたサーバー上にあり、このパッケージは標準入出力とサーバーをつなぎます。そのため、ここで利用できるツールセットは常に最新であり、このパッケージのリリースが必要になることはほとんどありません。

開発

npm install
npm run build
JOBKEEPR_API_KEY=jk_live_... node dist/index.js

MCP Inspector を使って対話的にテストします。

JOBKEEPR_API_KEY=jk_live_... npx @modelcontextprotocol/inspector node dist/index.js

リンク

• Jobkeepr
• Model Context Protocol

MIT ライセンスです。