Crisphive MCP

Crisphive API 的官方 MCP（Model Context Protocol）伺服器——為現場服務打造的 agentic AI 排程基礎設施。

它讓 AI 代理（Claude、ChatGPT、Gemini、Cursor 或任何 MCP 用戶端）都能在客戶與商家之間配對行程，並依 位置、技能和即時可用性 將團隊派往工單：工作預約與約會排程、工單追蹤、來自即時派遣與排程引擎的可用性、客戶（CRM）同步、服務目錄、技術人員與團隊名冊、地理服務區域與車隊——適用於 HVAC、管道、電氣、清潔、家電維修與物業維護等各行各業與居家服務。使用遠端託管伺服器；無需自行安裝或運行（本倉庫存放文件與 registry manifest）。

https://api.crisphive.com/mcp

先試試這些

連接（一把 chsk_test_ 沙盒金鑰就夠了），然後把以下任何一段直接貼給你的 agent：

1. 建立工單 — 「為 Marie Tremblay（613-555-0142）安排明天在 145 Laurier Ave W 的 2 小時 HVAC 工作。」 (createCustomer → listJobRequestBookingWindows → createJobRequest → quoteJobRequest → confirmJobRequest)

2. 緊急插入 — 「請馬上處理 David Okafor（613-555-0198）在 99 Bank St 的緊急管道工作——讓我看哪些會被重新安排。」 (listEmergencyCandidates → previewEmergencyReschedule → commitEmergencyReschedule)

3. 每日總覽 — 「整理我明天的行程，並標出任何有風險的部分。」 (listJobRequests → getTechnicianSchedule)

4. 空檔發現 — 「找這週 3 小時，讓我和太太去騎單車，但不能冒任何工事的風險。」 (getTechnicianSchedule → 由 agent 自行判斷空檔)

相同的提示詞在每個 Crisphive listing 與 docs 頁面上都會出現，所以你在這裡看到的正是每個地方第一次使用時的體驗。

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——無需金鑰）

Settings → Connectors → Add custom connector，貼上 https://api.crisphive.com/mcp。同意畫面出現時，以 Crisphive 商家負責人身分登入。（自訂 connector 需要支援該功能的 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" }
  }
}

設定 VSCode

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

ChatGPT

Settings → Connectors（開發者模式）→ 用 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…）

大多用戶端接受標準的 remote-server 格式：

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

只有少數用戶端的 URL 欄位名稱不同：

只支援 stdio 的用戶端可以透過 mcp-remote 來連接：

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

本地伺服器（npm — @crisphive/mcp）

這個儲存庫還提供一個輕量的本地 stdio 伺服器：同樣的 43 個工具（名稱相同、schema 相同——由與託管端點相同的 /v1 OpenAPI 規格產生），每次呼叫都是電腦以你的金鑰向 Crisphive API 發出 HTTPS 請求。本地不執行任何業務邏輯。

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

環境變數：

如果你的用戶端支援，請優先使用remote server（https://api.crisphive.com/mcp）——有 OAuth、不用處理金鑰、永遠保持最新。本地套件是為僅支援 stdio 的用戶端及自架環境而存在。

本儲存庫開發：npm ci && npm test。工具註冊表（src/tools.generated.json）為生成內容——npm run generate 會依照線上規格重新產生；若它與 /v1 有差異，CI 會失敗。

Authentication

每個請求都會以秘密 API key 作為 bearer token 進行驗證。用你的 Crisphive 業務後台建立金鑰。金鑰前綴決定資料環境：

• chsk_live_… → 正式（production）資料

• chsk_test_… → 沙盒（隔離測試）資料

請從環境中讀取金鑰——絕不要將金鑰提交入庫。

金鑰會到期。 到期存的時間是在建立金鑰時選定的——預設 30 天，最長 365 天——而且對那支金鑰的一生固定不變，之後無法延長。若要續期，建立第二把金鑰，讓你的 agent 指向它，然後撤銷第一把：一個商家可同時持有多把有效鑰匙，因此換鑰過程不會有停機，也根本需要特殊的 endpoint（與 AWS 文件記載的 access key 流程相同）。從後台或 key API 讀取 expires_at，並安排切換時間。當 key 到期時會以 API_KEY_EXPIRED 失敗，與 API_KEY_INVALID 有區隔，因此你可以額外對漏續期發警報，不需與撤銷混同。

Crisphive 會在 key 到期前 7 天（如果是 OAuth 連線則為 14 天）以電子郵件通知商家擁有者，所以到期這件事不該是驚https；但郵件是寄給商家，未必是寄給你，請自行追蹤 expires_at。一支刻意建立為少於 7 天的 key 不會收到提前通知，它的通知早在建立的當下就已寄出。

MCP endpoint 另外支援使用者端連接器的 OAuth 2.1（claude.ai、ChatGPT…）：使用者端在同意畫面授權你的 agent，不需要處理任何 keyi。一個兼容的 MCP 用戶端會自動完成整個流程——discovery、dynamic client registration、authorization code + PKCE。完整的流程、scopes 與 token 存活時間：docs/integration.md。

Tools

43 個工具，對應公開 /v1 API 的每個操作——與 SDK 方法同名（listCustomers、createJobRequest……），出自同一份 OpenAPI 規格，所以 REST 與 MCP 永遠同步。完整參考：docs/tools.md。

典型 agent 流程：

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

Pagination

List tools 接受 page / limit 參數，並回傳 meta 物件（total、count、per_page、current_page、total_pages）。

Idempotency

Create/commit 工具（createCustomer、createTechnician、createJobRequest、confirmJobRequest、commitJobRequestMove、commitEmergencyReschedule）接受 idempotency_key 參數，使重試不會重複建立——重試時請傳相同的值。

Errors

每個工具都會回傳 Crisphive 的回應 envelope（以文字以及 structuredContent 形式）：error_code 成功時為 0，失敗時為穩定的字串（CUSTOMER_NOT_FOUND、API_KEY_INVALID…）。請比對 code，不要比對訊息字串。

Documentation

• 文件：https://docs.crisphive.com

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

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

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

• For AI（OpenAPI 規格 + assistant bootstrap）：https://docs.crisphive.com/for-ai

• 用戶端整合指南：docs/integration.md

• Tools 參考：docs/tools.md

Privacy & support

• 隐私政策： https://crisphive.com/privacy-policy — Crisphive 仅处理通过 API 可访问的业务数据（客户、预订、技术人员、车队），以运营服务；它不出售个人信息。该数据在账户有效期间保留，并仅在必要情况下与服务提供商/子处理方共享。通过 MCP 连接的智能体代表授权业务方行事，其访问范围限于该业务的数据、环境（实时版与沙盒版）和已授予的权限。

• 支持： support@crisphive.com

许可协议

MIT