Claude + Crisphive MCPでフィールドオペレーション向けAI配車エージェントを構築する

Claudeをフィールドオペレーションの(サンドボックス)スケジューラーに接続し、自然言語での案件予約、全工程の自動再調整を伴うP0緊急対応、本番環境への実装チェックリストまでを解説。クレジットカード不要の無料サンドボックスで、所要時間は約15分です。

執筆者:Logan Le読了目安 1 分102 回閲覧4.9 (38)
Developer desk with two blurred screens and a hand-drawn agent flow sketched on a whiteboard behind

概要:Claudeを実際の(サンドボックス環境の)フィールドオペレーションのスケジュールに接続し、自然言語での案件予約、連動再調整によるP0緊急対応、本番運用の強化チェックリストまでを段階的に解説するチュートリアルです。所要時間:約15分。費用:無料(サンドボックスは無料、クレジットカード不要、MCP呼び出しに課金は発生しません)。

完成すると、次のようなやり取りができるアシスタントが構築できます。

あなた:バンク通り99番地のDavid Okafor(613-555-0198)から配管の緊急依頼が入った。スケジュールの再調整案を見せてほしい。

Claude:配車ツールを呼び出し、計画を提示します。「13:15に緊急案件を挿入。2件の案件を移動し到着予定時間を更新。1件のSLA余裕が減少。まだ確定していません。承認しますか?」

このやり取りで重要なのは、Claudeが行っていないことです。Claudeは計画を勝手に創作していません。Claudeはリクエストの意図を解釈し、Crisphiveの決定論的制約ソルバーがスケジュールを計算します。移動時間、スキル、資格、保護された休憩、SLAをハード制約として考慮して算出された結果が、承認待ちとして返されるのです。同じ入力であれば、毎回必ず同じスケジュールが出力されます。この役割分担こそが本チュートリアルのアーキテクチャ全体であり、開始前に理解しておくべき構造です。

あなた(自然言語)
→ Claude(意図を解釈し、ツールを選択)
→ Crisphive MCPサーバー — https://api.crisphive.com/mcp(43種類のツール)
→ REST API → 決定論的制約ソルバー
← 確認可能な計画(移動した案件、新しい到着予定時間、SLAへの影響)
← Claudeが計画とトレードオフを説明
あなたが承認 → スケジュールを確定

必要なもの

  • Claudeアカウント — claude.ai、Claude Desktop、Claude Codeのいずれでも動作します(コネクターのサポート状況はプランによって異なります)。

  • Crisphiveでフィールドオペレーション事業を運営している場合:他に必要なものはありません。事業者としてOAuthでサインインするだけです。

  • Crisphiveの事業アカウントを持っていない開発者の場合:無料のサンドボックスキー。開発者ページで登録し、chsk_test_キーを取得してください。同じベースURLに対して分離されたテスト環境が利用できます。クレジットカードの登録や営業電話はありません。

どちらの場合も、ローカルへのインストールや実行は不要です。MCPサーバーはホスト型のリモート環境であり、Streamable HTTP経由で動作します。

ステップ1 — ClaudeをCrisphiveに接続する

ルートA — 現場運用者(OAuth、ワンクリック)

ClaudeコネクターディレクトリのCrisphiveページを開き、「Connect」をクリックします。Crisphiveの事業所有者としてサインインし、接続を承認するよう求められます。セットアップはこれで完了です。

手動で設定する場合は、claude.aiまたはClaude Desktopで「設定」→「コネクター」→「カスタムコネクターを追加」を開き、https://api.crisphive.com/mcp を貼り付け、同意画面が表示されたらOAuthサインインを完了させてください。

ルートB — 開発者(Claude Code + サンドボックスキー)

claude mcp add --transport http crisphive https://api.crisphive.com/mcp

実際の事業環境ではなく、分離されたサンドボックス環境にセッションを固定するには、テストキーを添付します。

claude mcp add --transport http crisphive https://api.crisphive.com/mcp --header "Authorization: Bearer chsk_test_YOUR_KEY"

その他のMCPクライアント(Cursor、VS Code、Windsurf、Cline、Zed、LM Studio、Gemini CLIなど)も同じURLを使用します。クライアント一覧はGitHubのREADMEに掲載されています。stdioのみに対応するクライアントは、mcp-remoteを使ってブリッジ接続できます。

確認チェック:Claudeに「使用できるCrisphiveツールは何ですか?」と尋ねてみてください。案件予約・訪問日時設定、作業指示追跡、配車・空き状況、顧客(CRM)同期、サービスカタログ、クルー・名簿、対応エリア、車両フリートの8つのグループにわたる43種類のツールが表示されるはずです。

ステップ2 — スケジュールを確認する

まずはディレクトリページに掲載されている3つのプロンプトから試してみましょう。これらはCrisphiveのコネクタードキュメント全体で共通して使用されているプロンプトです。

最初に試すプロンプト

  1. 明日のMarie Tremblay(613-555-0142)、ローリエ・アベニュー・ウェスト145番地での2時間の空調(HVAC)作業を予約してください。

  2. バンク通り99番地のDavid Okafor(613-555-0198)からの今すぐの配管緊急作業が入りました。再調整が必要なスケジュールを表示してください。

  3. 明日の1日の予定の概要を表示し、リスクがある部分を指摘してください。

まずプロンプト3を実行してみてください。これは読み取り専用のため、一連の接続を安全に確認できます。

期待される結果:Claudeが配車・空き状況および作業指示ツールを呼び出し、明日のスケジュールを時系列のタイムラインとして返します。案件間の移動、各案件の余裕時間、リスク要素(厳しい移動時間、予定時間を超過しそうな案件)がハイライトされます。配車ボード上のデータは一切変更されません。読み取り専用プロンプトがデータを変更することはありません。

ステップ3 — 自然言語で案件を予約する

次に、プロンプト1を実行します。

明日のMarie Tremblay(613-555-0142)、ローリエ・アベニュー・ウェスト145番地での2時間の空調(HVAC)作業を予約してください。

実行される処理:案件予約・訪問日時設定、顧客同期(適切な顧客アカウントに予約を割り当てるため)、配車・空き状況(実際に誰が対応可能か)が呼び出されます。

期待される結果:配置の根拠(どの技術者か、なぜその人物か[スキル、資格、現在地からの距離、既存ルート])および正確な時間帯を含む予約完了通知。制約エンジンのより高度な計算を確認したい場合は、要求を厳しくしてみましょう。

同じ案件ですが、ガス配管の資格を持つ技術者のみを対象とし、誰の1日の移動時間にも20分以上追加しないでください。

ソルバーはこれらを推奨事項ではなくハード制約として処理します。条件を満たす人がいない場合は、推測で割り当てるのではなく、該当する制約を明記した上で「実行可能な枠がありません」という正確な結果を返します。

ステップ4 — P0緊急対応を吸収する(連動再調整)

このステップこそが、単なるカレンダー連携チャットボットとスケジューリングエージェントの違いを示す部分です。配管の破裂事故は都合の良い時間を聞いてはくれません。日中に緊急案件が発生した際、技術者のスケジュールをどのように自動再調整すればよいでしょうか。

バンク通り99番地のDavid Okafor(613-555-0198)からの今すぐの配管緊急作業が入りました。再調整が必要なスケジュールを表示してください。

実行される処理:配車・空き状況、案件予約、作業指示ツールが実行され、ソルバーが「連動再調整(Cascade Reschedule)」を実行します。割り込みによって影響を受ける後続のすべての案件について、移動時間、準備時間、資材調達、保護された休憩、SLA時間をすべてハード制約として保持したまま再計画します。完全な連動再調整は、これらの制約を適用した20箇所・3台の車両フリートシミュレーションにおいて3秒未満で計算されます。

期待される結果(ここが重要です):即座の変更ではなく「計画」が提示されます。Claudeは、緊急案件の挿入位置、移動するすべての案件、それぞれの新しい到着予定時間、SLA全体への影響という2通りの事前計画を提示します。あなたが承認するまで何も確定されません。このサーバー上のデータ変更を伴うフローはすべて、設計上「プレビュー / 確定」のペアとなっています。実際の配車ボードを予告なく静かに書き換えてしまうエージェントは、機能ではなく障害の原因になります。

承認してから、次のように質問してみてください。

なぜ14時の温水器作業は移動し、15時の点検作業は移動しなかったのですか?

Claudeはソルバーの実際の出力(適用された制約条件や存在した余裕時間)に基づいて説明します。計画はモデルの想像ではなく、ソルバーによって計算されたものだからです。

ステップ5 — 独自に応用する

この基本エージェントを応用する3つの方向性をご紹介します。それぞれプロンプト1つで実行できます。

  • 空き時間の発見:「案件にリスクを与えずに妻とサイクリングに行ける、今週の稼働時間内の3時間の空き枠を見つけてください。」 — スケジュールの余裕に基づいて空き枠をランク付けします。データは変更されません。

  • スキルおよび移動の照合:「カナタから20分圏内で、木曜日の午前に空いているガス配管資格を持つ技術者は誰ですか?」

  • 経営者向けブリーフィング:「全クルーの明日の予定の概要、リスクがある箇所、容量オーバーが発生している場所をわかりやすく説明してください。」

配車担当者、開発者、経営者のいずれであっても、使用するツールは同じ43種類です。違いは指示を出す立場だけです。Claude用MCPページには、これら3つの立場に対応したコピー可能なプロンプトライブラリが掲載されています。

チャット画面ではなくソフトウェアに組み込む場合も、同じエンジンがREST APIとして提供されています。docs.crisphive.comから始めるか、MCPと直接APIのどちらを選択すべきかについての統合パスの比較を参照してください。

ステップ6 — 本番環境運用の強化チェックリスト

サンドボックス環境から本番運用へ移行する前の確認事項:

  1. キーの有効期限管理:デフォルトの有効期限は30日であり、有効期限切れの通知メールは開発者ではなく事業所有者に届きます。本番運用向けのエージェントには365日有効なキーを発行し、2つのキーによるローテーション運用(キーBを発行、デプロイ、キーBでのアクセスを確認、キーAを失効)を行ってください。稼働後1か月でAPI_KEY_EXPIREDエラーによりエージェントが停止するのは、バグ報告ではなく契約解除につながる事態です。

  2. ユーザーにはOAuth、サービスにはAPIキーを使用:OAuthトークンはClaudeのコネクター設定またはCrisphiveアカウントのどちらからでも失効可能であり、チャット画面にAPIキーが露出することもありません。

  3. プレビュー / 確定(preview/commit)機能を有効にしておく:「クリック数を減らすため」に連動再調整を自動承認したくなる衝動を抑えてください。承認ステップがあることで、明日スケジュールを手動変更する配車担当者が監査・追跡できるようになります。

  4. スコープの確認:コネクターがアクセスできるのはスケジューリングデータ(案件、作業指示、顧客、クルー、カタログ、エリア、車両フリート)のみです。請求や決済のデータは開示されません。独自に構築するシステムでも同様になっているか確認してください。

  5. 例外系(アンハッピーパス)をサンドボックスで事前にテスト:対応不可能な案件(有資格の技術者がいない場合)、SLA違反が発生する連動再調整、セッション途中でのトークン失効など。ユーザーの記憶に残るのは、エージェントがエラーにどう対処したかです。

よくある質問

試すにはCrisphiveの事業アカウントが必要ですか?

いいえ。無料のchsk_test_サンドボックスは同じベースURL上の分離されたテスト環境であり、クレジットカードも不要です。OAuthサインインは、実際の事業アカウントを所有者として接続する場合に使用します。

スケジューリングを行っているのはClaudeですか?

いいえ。これこそが重要なポイントです。Claudeは質問内容を解釈するだけであり、すべての予約、連動再調整、再スケジュールはCrisphiveの決定論的制約ソルバーが計算します。同じ質問を2回行えば、2回とも全く同じ計画が得られます。

エージェントが確認なしに実際のスケジュール変更を行うことはありますか?

いいえ。既存の作業を変更する処理はすべて、確認可能な計画(移動した案件、新しい到着予定時間、SLAへの影響)として返され、あなたが承認した場合のみ確定されます。

MCPサーバーの利用に追加費用はかかりますか?

いいえ。MCPアクセスはすべてのビジネスプランおよび無料の開発者サンドボックスに含まれています。MCP呼び出し、連動再調整、再スケジュール、読み取り処理に対して課金されることはありません。課金対象となるのは実際の案件数のみです。

Claude以外に利用できるクライアントはありますか?

Streamable HTTP経由のリモートMCPサーバーに対応しているすべてのクライアント(ChatGPT、Gemini CLI、Cursor、VS Code、Windsurf、Cline、Zed、LM Studioなど)で動作します。stdioのみに対応するクライアントは、mcp-remoteを使ってブリッジ接続できます。

現場クルーを運営していて、先週の火曜日のスケジュールでこのエンジンがどのように機能したかを確認したいですか?無料のシャドウスケジュール監査を予約してください。直近1日の案件データを送信いただくと、48時間以内に検出された移動時間や追加キャパシティの分析結果をお届けします。

この記事を共有

この記事は役に立ちましたか?

5 点中 4.9 点 · 38 件の評価

コメント

0/2000

あわせて読む

How Toのノートをもっと見る