Crisphive MCP 是 Crisphive API 的官方 MCP（Model Context Protocol）服务器，定位为面向现场服务运营的智能体 AI 调度基础设施。它使 AI 智能体（如 Claude、ChatGPT、Gemini、Cursor 或任何 MCP 客户端）能够根据位置、技能和实时可用性，在客户与企业之间匹配日程并派遣班组。
主要能力
- 作业预约与预约排程
- 工单跟踪
- 来自实时调度与排程引擎的可用性查询
- 客户（CRM）同步
- 服务目录
- 技师与班组名册
- 地理服务区域
- 车队管理 适用于 HVAC、管道、电气、清洁、家电维修和物业维护等 trades 与家庭服务行业。
调度机制 调度基于确定性求解器的约束计算：智能体处理对话，求解器做出决策——相同输入，相同计划，绝不让 LLM 猜测日历。
使用方式 该服务为托管远程服务器，无需安装或运行（本仓库仅包含文档和注册清单）。支持任何支持 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 企业所有者身份登录。
- Cursor：添加到 .cursor/mcp.json。
- Gemini CLI：添加到 ~/.gemini/settings.json（注意使用 httpUrl）。
- 其他 MCP 客户端：多数接受标准远程服务器配置。
- 仅支持 stdio 的客户端可通过 mcp-remote 桥接。
- 本地服务器（npm @crisphive/mcp）：提供相同的 66 个工具（名称与 schema 相同，由同一 /v1 OpenAPI 规范生成），每次调用通过 HTTPS 请求 Crisphive API，本地不运行业务逻辑。
认证与密钥 每个请求使用作为 bearer token 发送的密钥 API 密钥进行认证。密钥从 Crisphive 企业仪表板创建。密钥前缀选择数据环境：chsk_live_… 为生产数据，chsk_test_… 为沙箱数据。密钥应从环境变量加载，切勿提交。密钥会过期，创建时选择生命周期（默认 30 天，最长 365 天），且不可延长。续期需创建第二个密钥、切换智能体、再撤销第一个。过期密钥返回 API_KEY_EXPIRED，与 API_KEY_INVALID 区分。Crisphive 会在密钥过期前 7 天（OAuth 连接为 14 天）向企业所有者发送邮件。MCP 端点还支持 OAuth 2.1，企业所有者可在同意屏幕授权智能体，无需处理密钥。
工具与流程 共 66 个工具，与公共 /v1 API 操作一一对应，名称与 SDK 方法相同（如 listCustomers、createJobRequest），由同一 OpenAPI 规范生成，确保 REST 与 MCP 不漂移。典型智能体流程包括：作业创建（createCustomer → listJobRequestBookingWindows → createJobRequest → quoteJobRequest → confirmJobRequest）、紧急插入（listEmergencyCandidates → previewEmergencyReschedule → commitEmergencyReschedule）、每日概览（listJobRequests → getTechnicianSchedule）、病假处理（previewAbsenceResolve → commitAbsenceResolve）。列表工具支持 page/limit 并返回 meta 对象。创建/提交工具接受 idempotency_key 参数以避免重复。每个工具返回 Crisphive 响应信封，error_code 为 0 表示成功，失败时为稳定字符串。
适用场景 适用于 HVAC、管道、电气、清洁、家电维修、物业维护等现场服务与家庭服务行业的调度、派工、工单、CRM 和车队管理。
限制 文档未提供具体收费、价格、平台兼容性细节或效果保证。密钥过期不可延长，需手动轮换。本地包仅用于 stdio 客户端和自托管场景。
