crisphive

Crisphive MCP

Crisphive API の公式 MCP（Model Context Protocol）サーバーです。現場業務向けのエージェント型 AI スケジューリング基盤を提供します。

AI エージェント（Claude、ChatGPT、Gemini、Cursor、その他の MCP クライアント）が、場所、スキル、リアルタイムの空き状況に基づいて、顧客と事業者の間でスケジュールを調整し、作業員を現場へ割り当てられます。対応機能は、作業の予約とアポイントメントのスケジューリング、作業指示の追跡、リアルタイムの派遣・スケジューリングエンジンから取得する空き状況、顧客（CRM）との同期、サービスカタログ、技術者・作業員名簿、地理的なサービス提供地域、車両管理です。HVAC、配管、電気工事、清掃、家電修理、物件保守などの業種・ホームサービスに対応します。スケジューリングは決定論的ソルバーに基づく制約充足型です。エージェントが会話を担い、ソルバーが判断するため、同じ入力には常に同じ計画が適用され、LLM がカレンダーを推測することはありません。ホスト型リモートサーバーのため、インストールや実行は不要です（このリポジトリにはドキュメントとレジストリマニフェストが含まれています）。

https://api.crisphive.com/mcp

まずはこちらをお試しください

接続したら（chsk_test_ のサンドボックスキーで十分です）、以下のいずれかをエージェントにそのまま入力してください。

1. 作業の作成 — 「明日、Marie Tremblay のために、145 Laurier Ave W で 2 時間の HVAC 作業を予約してください。電話番号は 613-555-0142 です。」 （createCustomer → listJobRequestBookingWindows → createJobRequest → quoteJobRequest → confirmJobRequest）
2. 緊急作業の割り込み — 「99 Bank St で David Okafor（613-555-0198）の緊急配管作業を今すぐ手配してください。再スケジュールされるものを見せてください。」 （listEmergencyCandidates → previewEmergencyReschedule → commitEmergencyReschedule）
3. 1日の予定 — 「明日の予定をまとめて、リスクのあるものに印を付けてください。」 （listJobRequests → getTechnicianSchedule） . 病欠対応 — 「Dmitri が明日、病欠の連絡をしてきました。顧客の予約時間を変更せずに、彼の作業を別の担当者に割り当て直してください。」 （previewAbsenceResolve → commitAbsenceResolve）

同じプロンプトは Crisphive のすべての掲載ページとドキュメントページに掲載されているため、ここでご覧いただく内容が、どのページでも初回利用時の体験そのものです。

→ 概要、ツール一覧、ワンクリック接続はこちら：https://crisphive.com/claude

要件

Streamable HTTP 経由のリモートサーバーに対応する MCP クライアントであれば利用できます。 claude.ai、Claude Desktop、Claude Code、ChatGPT、Gemini CLI、Cursor、VS Code、Windsurf、Cline、Zed、LM Studio などに対応しています。

インストール

claude.ai / Claude Desktop（OAuth — キー不要）

設定 → コネクター → カスタムコネクターを追加を選択し、https://api.crisphive.com/mcp を貼り付けます。同意画面が表示されたら、Crisphive の事業主としてサインインしてください。(カスタムコネクターを利用するには、対応する Claude プランが必要です。)

Claude Code

# OAuth (you'll be prompted to authorize in the browser)
claude mcp add --transport http crisphive https://api.crisphive.com/mcp

# or with an API key (sandbox key shown — safe to experiment)
claude mcp add --transport http crisphive https://api.crisphive.com/mcp \
  --header "Authorization: Bearer chsk_test_YOUR_KEY"

Cursor

または、.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "crisphive": { "url": "https://api.crisphive.com/mcp" }
  }
}

VS Code

code --add-mcp '{"name":"crisphive","url":"https://api.crisphive.com/mcp"}'

ChatGPT

設定 → コネクター（開発者モード）で、URL https://api.crisphive.com/mcp を指定して MCP サーバーを追加します（OAuth）。

Gemini CLI

~/.gemini/settings.json に追加します（注：Gemini CLI は Streamable HTTP サーバーに httpUrl を使用します）。

{
  "mcpServers": {
    "crisphive": {
      "httpUrl": "https://api.crisphive.com/mcp",
      "headers": { "Authorization": "Bearer chsk_test_YOUR_KEY" }
    }
  }
}

その他の MCP クライアント（Windsurf、Cline、Zed、LM Studio、…）

ほとんどのクライアントでは、標準的なリモートサーバー形式が使用できます。

{
  "mcpServers": {
    "crisphive": {
      "url": "https://api.crisphive.com/mcp",
      "headers": { "Authorization": "Bearer chsk_test_YOUR_KEY" }
    }
  }
}

一部のクライアントでは、URL フィールド名のみが異なります。

クライアント	設定ファイル	URL フィールド
Cline / Roo Code	cline_mcp_settings.json	url
Windsurf	~/.codeium/windsurf/mcp_config.json	serverUrl
Gemini CLI	~/.gemini/settings.json	httpUrl
Zed	settings.json → context_servers	url

stdio のみをサポートするクライアントでは、mcp-remoteを使ってブリッジできます。

{
  "mcpServers": {
    "crisphive": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.crisphive.com/mcp"]
    }
  }
}

ローカルサーバー（npm — @crisphive/mcp）

このリポジトリには、薄いローカル stdio サーバーも含まれています。同じ 67 個のツール（名前とスキーマも同一で、ホストされたエンドポイントと同じ /v1 OpenAPI 仕様から生成）を提供し、各呼び出しはキーを使った Crisphive API への HTTPS リクエストになります。ビジネスロジックはローカルでは実行されません。

{
  "mcpServers": {
    "crisphive": {
      "command": "npx",
      "args": ["-y", "@crisphive/mcp"],
      "env": { "CRISPHIVE_API_KEY": "chsk_test_YOUR_KEY" }
    }
  }
}

環境変数：

変数	必須	意味
CRISPHIVE_API_KEY	ツール呼び出し時に必要	chsk_live_… = 本番データ、chsk_test_… = 分離されたサンドボックス。ダッシュボード（Developers → API keys）でキーを作成します。
CRISPHIVE_BASE_URL	いいえ	API オリジンの上書き（デフォルトは https://api.crisphive.com）。

クライアントがサポートしている場合は、ホストされたリモートサーバー（https://api.crisphive.com/mcp）を優先してください。OAuth に対応し、キーの管理が不要で、常に最新の状態です。ローカルパッケージは、stdio のみをサポートするクライアントとセルフホスト構成向けに用意されています。

このリポジトリで開発する場合：npm ci && npm test。ツールレジストリ（src/tools.generated.json）は生成ファイルです。npm run generate を実行すると、ライブ仕様から更新されます。CI では /v1 との差異があると失敗します。

認証

すべてのリクエストは、ベアラートークンとして送信されるシークレット API キーで認証されます。Crisphive のビジネスダッシュボードでキーを作成してください。キーのプレフィックスによってデータ環境が決まります。

• chsk_live_… → ライブ（本番）データ
• chsk_test_… → サンドボックス（分離されたテスト）データ

キーは環境変数から読み込み、決してコミットしないでください。

キーには有効期限があります。 有効期間はキーの作成時に選択され、デフォルトは 30 日、最長 365 日です。そのキーの有効期間中は固定され、後から延長できません。更新するには、2 つ目のキーを作成してエージェントに設定し、最初のキーを取り消してください。1 つのビジネスで複数の有効なキーを同時に保持できるため、切り替え時にダウンタイムはなく、特別なエンドポイントも不要です（AWS がアクセスキーについて説明している手順と同じです）。ダッシュボードまたはキー API で expires_at を確認し、切り替えをスケジュールしてください。有効期限が切れたキーは API_KEY_INVALID とは異なる API_KEY_EXPIRED で失敗するため、更新漏れを取り消しとは別に通知できます。

Crisphive はキーの有効期限の 7 日前（OAuth 接続の場合は 14 日前）にビジネスのオーナーへメールを送るため、有効期限切れを不意に迎えることはないはずです。ただし、メールの宛先はビジネスであり、必ずしもあなたとは限らないため、expires_at を自分で追跡してください。意図的に 7 日未満で作成されたキーには事前通知が届きません。作成時に通知されているためです。

MCP エンドポイントは、エンドユーザー向けコネクタ（claude.ai、ChatGPT、…）用のOAuth 2.1にも対応しています。ビジネスのオーナーが同意画面でエージェントを承認するため、キーを扱う必要はありません。準拠した MCP クライアントであれば、クライアント検出、動的クライアント登録、認可コード + PKCE によるフロー全体が自動で実行されます。フロー、スコープ、トークンの有効期間について詳しくは、docs/integration.mdをご覧ください。

ツール

公開 /v1 API の各操作に対応する 67 個のツールです。SDK メソッド（listCustomers、createJobRequest など）と同じ名前で、同じ OpenAPI 仕様から生成されるため、REST と MCP の間で差異が生じることはありません。完全なリファレンスは docs/tools.md をご覧ください。

グループ	ツール
顧客（CRM 同期、完全な CRUD）	listCustomers · createCustomer · getCustomer · updateCustomer · deleteCustomer
予約（作成と追跡）	createJobRequest · listJobRequests · getJobRequest · getJobRequestTimeline · listJobRequestBookingWindows · listJobRequestChanges
カタログ（読み取り）	listJobTypes · getJobType · listSkills · listSkillCategories · listSkillsByCategory · listServiceAreas · getServiceArea
カタログ管理（インポート同期）	createJobType · updateJobType · deleteJobType · createSkillCategory · deleteSkillCategory · createSkill · updateSkill · deleteSkill · createServiceArea · updateServiceArea · deleteServiceArea · createVehicle · updateVehicle · deleteVehicle
チームと車両群（読み取り）	listTechnicians · getTechnician · listVehicles · getVehicle
チーム名簿管理（人事システム同期）	listAssignableGroups · createTechnician · updateTechnician · deleteTechnician · replaceTechnicianBuddies · replaceTechnicianLeads · replaceTechnicianVehicles · replaceTechnicianServiceAreas · replaceTechnicianSkills · listTechnicianSkills
マッチングとスケジュール設定（読み取り専用、エンジンによる計算）	listMatchingSlots · listCrewCandidates · getTechnicianSchedule · listNearbyTechnicians
スケジュール設定アクション（スケジュールを操作）	quoteJobRequest · confirmJobRequest · bookAndConfirmJobRequest · previewJobRequestMove · commitJobRequestMove
優先度と緊急派遣（P0～P3、SLA、連鎖処理）	updateJobPriority · listEmergencyCandidates · previewEmergencyReschedule · commitEmergencyReschedule
不在時の調整（病欠連絡 — 技術者の終日予定を再割り当て）	previewAbsenceResolve · commitAbsenceResolve
技術者の休暇（病欠・休暇の記録、既存の休暇の確認、復帰時の削除）	createTechnicianTimeOff · listTechnicianTimeOff · deleteTechnicianTimeOff
Webhook（REST フックのトリガー：登録／登録解除）	listWebhookEventTypes · createWebhookEndpoint · deleteWebhookEndpoint

一般的なエージェントのフロー：

listSkills / listJobTypes                → discover reference IDs
createCustomer                           → { customer_id }
listJobRequestBookingWindows             → offer only the returned windows
createJobRequest                         → booking created
quoteJobRequest → confirmJobRequest      → scheduled (auto or forced technician)
   (quote answers 409 JOB_REQUEST_QUOTE_NOT_SCHEDULABLE when the customer
    would see no slot — agree a new time, or resend with force: true)
getJobRequest / listJobRequestChanges    → track status

電話または自動化向けの 1 回の呼び出しで完了するフロー（音声エージェントの場合は、ツールセットを絞るために https://api.crisphive.com/mcp?profile=voice に接続してください）：

listCustomers (phone: "+16135550188")    → is the caller already a customer?
bookAndConfirmJobRequest                 → booked + scheduled, or confirmed:false + refusal
                                           (the job then waits in the coordinator's queue)

緊急（P0）フロー：

createJobRequest (priority: "p0") → quoteJobRequest
listEmergencyCandidates                  → ranked techs + crew_recommendation
previewEmergencyReschedule               → what moves (or reassigns)
commitEmergencyReschedule                → inserted + auto-confirmed
   (or preview with an inline `job` probe, then bookAndConfirmJobRequest
    with priority p0 + emergency{dispatch: "now"} books and commits in one call)

病欠連絡のフロー（技術者が不在 — 担当予定のすべての作業を変更前と同じ時刻に別の担当者へ割り当て）：

previewAbsenceResolve                    → who takes each job; nothing written
createTechnicianTimeOff                  → record the sick day (lands pending — enough for the commit)
commitAbsenceResolve                     → apply exactly the previewed plan, all-or-nothing

ページネーション

一覧取得ツールは page と limit を受け付け、meta オブジェクト（total、 count、per_page、current_page、total_pages）を返します。

冪等性

作成／確定ツール（createCustomer、createTechnician、createJobRequest、 confirmJobRequest、commitJobRequestMove、commitEmergencyReschedule、commitAbsenceResolve） は idempotency_key 引数を受け付けるため、再試行しても重複が発生しません。 再試行時には同じ値を渡してください。

エラー

すべてのツールは、Crisphive のレスポンスエンベロープを（テキストおよび structuredContent として）返します。成功時の error_code は 0、失敗時は安定した文字列（CUSTOMER_NOT_FOUND、API_KEY_INVALID など）です。メッセージ文字列ではなく、コードで判定してください。

ドキュメント

• ドキュメント：https://docs.crisphive.com
• MCP：https://docs.crisphive.com/mcp
• API リファレンス：https://docs.crisphive.com/technical-reference
• Webhook：https://docs.crisphive.com/webhook
• AI 向け（OpenAPI 仕様とアシスタントのブートストラップ）：https://docs.crisphive.com/for-ai
• クライアント統合ガイド：docs/integration.md
• ツールリファレンス：docs/tools.md

プライバシーとサポート

• プライバシーポリシー： https://crisphive.com/privacy-policy — Crisphive は、サービスを運用する目的に限り、API 経由でアクセス可能な業務データ（顧客、予約、技術者、車両）を処理します。個人情報を販売することはありません。データはアカウントが有効な間保持され、必要に応じてサービスプロバイダー／サブプロセッサーとのみ共有されます。MCP 経由で接続されたエージェントは、承認した事業者の代理として動作し、その事業者のデータ、環境（本番環境とサンドボックスの別）、および付与された権限の範囲内で利用します。
• サポート： [email protected]

ライセンス

MIT