Crisphive MCP

Официальный MCP-сервер (Model Context Protocol) для Crisphive API — агентная ИИ-инфраструктура планирования для выездного обслуживания.

Позволяет ИИ-агентам — Claude, ChatGPT, Gemini, Cursor или любому MCP-клиенту — согласовывать расписания между клиентами и компаниями и маршрутизировать бригады по заявкам с учётом локации, навыков и реальной доступности: бронирование работ и запись на приём, отслеживание рабочих нарядов, доступность на основе живого движка диспетчеризации и планирования, синхронизация клиентов (CRM), каталоги услуг, списки техников и бригад, географические зоны обслуживания и автопарк — для мастеров и бытовых услуг, таких как HVAC, сантехника, электрика, уборка, ремонт бытовой техники и обслуживание недвижимости. Размещённый удалённый сервер; ничего не нужно устанавливать или запускать (в этом репозитории находятся документация и манифест реестра).

https://api.crisphive.com/mcp

Что попробовать в первую очередь

Подключитесь (достаточно sandbox-ключа chsk_test_) и вставьте любой из этих запросов прямо в своего агента:

1. Создание заявки — * «Запланируйте двухчасовую работу HVAC на 145 Laurier Ave W на завтра для Marie Tremblay, 613-555-0142.»* (createCustomer → listJobRequestBookingWindows → createJobRequest → quoteJobRequest → confirmJobRequest)

2. Срочная вставка — * «Срочная сантехническая работа сейчас по адресу 99 Bank St для David Okafor (613-555-0198) — покажи, что будет перенесено.»* (listEmergencyCandidates → previewEmergencyReschedule → commitEmergencyReschedule)

3. План дня — * «Опиши, как выглядит мой завтра, и отметь, что под риском.»* (listJobRequests → getTechnicianSchedule)

4. Поиск свободного времени — * «Найди 3 часа на этой неделе для велосипедной прогулки с женой, не рискуя ни одной заявкой.»* (getTechnicianSchedule → агент рассуждает о свободных окнах)

Такие же примеры есть в каждом списке и на каждой странице документации Crisphive, так что этот первый опыт будет одинаковым везде.

Related MCP server: Servicialo

Требования

Любой MCP-клиент с поддержкой удалённых серверов через Streamable HTTP — 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 использует httpUrl для потоковых HTTP-серверов):

{
  "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 в нескольких клиентах:

Клиенты, которые работают только со stdio, могут использовать mcp-remote как мост:

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

Локальный сервер (npm — @crisphive/mcp)

В этом репозитории также доступен лёгкий локальный stdio-сервер: те же 43 инструмента (те же имена и схемы, созданные из той же спецификации OpenAPI /v1, что и размещённый endpoint), где каждый вызов — HTTPS-запрос к Crisphive API с вашим ключом. Никакая бизнес-логика не выполняется локально.

{
  "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-ключом, передаваемым в виде bearer-токена. Создавайте ключи в панели управления бизнесом Crisphive. Префикс ключа определяет среду данных:

• chsk_live_… → боевые (производственные) данные

• chsk_test_… → песочные (изолированные тестовые) данные

Загружайте ключи из окружения — никогда не коммитьте их.

Ключи истекают. Срок действия выбирается при создании ключа — по умолчанию 30 дней, максимум 365 — и фиксируется на всё время жизни ключа; его нельзя продлить. Чтобы обновить ключ, создайте второй ключ, укажите его своему агенту, а затем отзвоните первый: бизнес может одновременно иметь несколько активных ключей, поэтому переход выполняется без простоя и не требует отдельного endpoint (такая же процедура, что и описана в AWS для ключей доступа). Прочитайте expires_at из панели управления или key API и запланируйте смену. Истекший ключ выдаёт ошибку API_KEY_EXPIRED, которая отличается от API_KEY_INVALID, поэтому вы можете отдельно предупредить о пропущенном обновлении и об отзыве.

Crisphive по электронной почте уведомляет владельцев бизнеса за 7 дней до истечения срока ключа (за 14 дней для OAuth-подключения), так что истечение не должно стать неожиданностью, но письмо приходит бизнесу, а не обязательно вам, поэтому отслеживайте expires_at самостоятельно. Ключ, созданный на срок менее 7 дней, не получает предварительного уведомления; уведомление пришло бы при его создании.

MCP-эндпоинт также поддерживает OAuth 2.1 для пользовательских коннекторов (claude.ai, ChatGPT, …): владелец бизнеса авторизует вашего агента через экран согласования, и ключ никогда не обрабатывается. Поддерживающий MCP-клиент выполняет весь процесс автоматически — discovery, динамическая регистрация клиента, authorization code + PKCE. Полное описание процесса, уровней доступа (scopes) и срока жизни токенов: docs/integration.md.

Инструменты

43 инструмента — по одному на каждую операцию публичного /v1 API. Имена совпадают с методами SDK (listCustomers, createJobRequest, …) и создаются из той же спецификации OpenAPI, благодаря чему 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, …). Ориентируйтесь на коды, а не на текст оповещения.

Документация

• Документация: https://docs.crisphive.com

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

• API-справочник: https://docs.crisphive.com/technical-reference

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

• Для ИИ (спецификация OpenAPI + загрузочный файл ассистента): https://docs.crisphive.com/for-ai

• Руководство по интеграции клиента: docs/integration.md

• Справочник инструмента: docs/tools.md

Конфиденциальность и поддержка

• Политика конфиденциальности: https://crisphive.com/privacy-policy — Crisphive обрабатывает бизнес-данные, доступные через API (клиенты, бронирования, специалисты, автопарк), исключительно для работы Сервиса; он не продаёт личную информацию. Данные хранятся, пока учётная запись активна, и передаются только поставщикам услуг/суб-обработчикам по мере необходимости. Агент, подключённый через MCP, действует от имени авторизующего бизнеса и ограничен данными этого бизнеса, средой (рабочая vs песочница) и выданными разрешениями.

• Поддержка: support@crisphive.com

Лицензия

MIT