Crisphive MCP

Crisphive API の公式 MCP（Model Context Protocol）サーバー — 現場サービス向けエージェント型AIスケジューリング基盤です。

Claude、ChatGPT、Gemini、Cursor、または任意のMCPクライアントといったAIエージェントが、場所・スキル・リアルタイムの空き状況に基づいて、顧客と事業者のスケジュールをマッチングし、クルーを現場ジョブに割り当てられるようにします。対応するのは ジョブ予約とアポイントスケジューリング、作業指示書の追跡、稼働中のディスパッチ＆スケジューリングエンジンによる空き状況、顧客（CRM）同期、サービスカタログ、技術者＆クルー名簿、地理的なサービスエリア、車両フリートです。HVAC、配管、電気工事、清掃、家電修理、施設メンテナンスなどの専門業・家庭向けサービスを対象としています。ホスト型リモートサーバーで、インストールや実行は不要です（このリポジトリはドキュメントと登録マニフェストを保持しています）。

https://api.crisphive.com/mcp

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

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

1. ジョブ作成 — "明日、145 Laurier Ave W で、Marie Tremblay（613-555-0142）向けの2時間のHVACジョブを予約してください。" (createCustomer → listJobRequestBookingWindows → createJobRequest → quoteJobRequest → confirmJobRequest)

2. 緊急割り込み — "99 Bank St で、David Okafor（613-555-0198）向けの緊急配管ジョブを今すぐ作成し、何が再スケジューリングされるか確認させてください。" (listEmergencyCandidates → previewEmergencyReschedule → commitEmergencyReschedule)

3. 当日の概要 — "明日の1日の概要を作成し、リスクになりそうなものを知らせてください。" (listJobRequests → getTechnicianSchedule)

4. 空き時間の検索 — "夫とサイクリングに出かけるための空き時間を今週3時間を見つけてください。ジョブに危険を及ぼさないようにしてください。" (getTechnicianSchedule → エージェントが空き時間を分析します)

同じプロンプトは、Crisphive のすべてのリスティングとドキュメントページにも表示されるため、ここでの内容はどこでも初回の利用方法とまったく同じです。

Related MCP server: Servicialo

要件

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

設定 → コネクタ（デベロッパーモード）→ MCPサーバーを追加し、URL https://api.crisphive.com/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" }
    }
  }
}

stdio のみ対応のクライアントは、mcp-remote でブリッジできます。

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

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

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

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

環境変数：

クライアントが対応している場合は、ホスト側のリモートサーバー（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_… → サンバックス（隔離されたテスト）データ

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

キーは有効期限があります。 存続期間はキー作成時に選択されます — 既定は30日、最大365日 — その間固定され、後から延長することはできません。更新するには、別の キーを作成し、エージェントをそのキーに切り替えてから、最初のキーを失効させます：ビジネスでは複数の有効キーを同時に保持できるため、切替によるダウンタイムはなく、特別なエンドポイントも不要です（AWS がアクセスキーに文書化している手順と同じです）。expires_at をダッシュボードまたはキー API から読み取って、切替を計画します。期限の切れたキー（aged-out key）は API_KEY_EXPIRED で失敗し、API_KEY_INVALID とは区別されるため、失効ではなく再設定の未完了をアラートに使えます。

Crisphive はキー失効の7日前（OAuth 接続は14日前）にビジネスオーナーへメールを送信します。そのため、突然の失効はないはずですが、ビジネス宛てであり、必ずしも自分宛ではないため、自分で expire_at を追跡してください。7日未満で意図的に作成されたキーには事前通知はありません。その場合、通知は作成時点で既に届くはずです（そのため通知はないませんか）。

MCPエンドポイントはさらに、エンドユーザー向け接続（claude.ai、ChatGPTなど）のために OAuth 2.0 をサポートしています：ビジネスオーナーが同意画面でエージェントを承認し、キーは一切扱われません。対応したMCPクライアントは、探索、動的クライアント登録、認可コード+PKCE の全体フローを自動的に実行します。完全なフロー、スコープ、トークン存続期間は docs/integration.md を参照してください。

ツール

43個のツールは、公開 /v1 API の操作ごとに1つ対応し、SDK メソッドと同じ名前（listCustomers、createJobRequest、…）で、同じ OpenAPIspec から導出されます。これにより REST と MCP が乖離しません。 詳細は docs/tools.md を参照。

典型的なエージェントフロー：

listSkills / listJobTypes                → discover reference IDs
createCustomer                           → { customer_id }
listJobRequestBookingWindows             → offer only the returned windows
createJobRequest                         → booking created
quoteJobRequest → confirmJobRequest      → scheduled (auto or forced technician)
getJobRequest / listJobRequestChanges    → track status

緊急（P0）フロー：

createJobRequest (priority: "p0") → quoteJobRequest
listEmergencyCandidates                  → ranked techs + crew_recommendation
previewEmergencyReschedule               → what moves (or reassigns)
commitEmergencyReschedule                → inserted + auto-confirmed

ページング

リスト系ツールは page / limit を受け付け、meta オブジェクト（total、count、per_page、current_page、total_pages）を返します。

べき等性

作成・コミットクロツール（createCustomer、createTechnician、createJobRequest、 confirmJobRequest、commitJobRequestMove、commitEmergencyReschedule）は idempotency_key 引数を受け付け、リトライで重複が作成されないようにします。リトライするときは同じ値を渡してください。

エラー

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

ドキュメント

• Docs: https://docs.crisphive.com

• MCP: https://docs.crisphive.com/mcp

• API reference: https://docs.crisphive.com/technical-reference

• Webhooks: https://docs.crisphive.com/webhook

• For AI (OpenAPI spec + assistant startup): https://docs.crisphive.com/for-ai

• Client integration guide: docs/integration.md

• Tool reference: docs/tools.md

プライバシー & サポート

• プライバシーポリシー: https://crisphive.com/privacy-policy — Crisphive は、 API を通じてアクセスできるビジネスデータ(顧客、予約、技術者、 車両)を、本サービスを運営する目的のみに処理します。個人情報を販売することは ありません。データは、アカウントがアクティブな間のみ保持され、 必要な場合のみサービスプロバイダー/サブプロセッサーと共有されます。 MCP を介して接続されたエージェントは、承認元のビジネスに代わって動作し、 そのビジネスのデータ、環境(ライブ vs サンドボックス)、付与された権限に 限定されます。

• サポート: support@crisphive.com

ライセンス

MIT