Crisphive MCP

Der offizielle MCP-Server (Model Context Protocol) für die Crisphive API — agentische KI-Planungsinfrastruktur für den Außendienst.

Er ermöglicht KI-Agenten — Claude, ChatGPT, Gemini, Cursor oder jedem MCP-Client — Zeitpläne zwischen Kunden und Unternehmen abzustimmen und Crews anhand von Standort, Qualifikationen und Echtzeit-Verfügbarkeit an Aufträge zu leiten: Terminbuchung & Terminplanung, Arbeitsauftragsverfolgung, Verfügbarkeit über eine Live-Dispatch- & Planungs-Engine, Kunden(-CRM)-Sync, Servicekataloge, Techniker- & Crew-Verzeichnisse, geografische Servicegebiete und Fuhrpark — für Gewerke und Hausdienstleistungen wie HVAC, Sanitär, Elektrik, Reinigung, Reparatur von Haushaltsgeräten und Gebäudeinstandhaltung. Gehosteter Remote-Server; nichts zu installieren oder auszuführen (dieses Repository enthält die Dokumentation und das Registry-Manifest).

https://api.crisphive.com/mcp

Diese zuerst ausprobieren

Verbinden Sie sich (ein chsk_test_-Sandbox-Schlüssel genügt), und fügen Sie dann einen dieser Prompts direkt in Ihren Agenten ein:

1. Auftragserstellung — „Planen Sie für morgen einen 2-stündigen HVAC-Auftrag in der 145 Laurier Ave W für Marie Tremblay, 613-555-0142.“ (createCustomer → listJobRequestBookingWindows → createJobRequest → quoteJobRequest → confirmJobRequest)

2. Notfalleinplanung — „Jetzt einen sanitären Notfallauftrag in der 99 Bank St für David Okafor (613-555-0198) — zeigen Sie mir, was umgeplant wird.“ (listEmergencyCandidates → previewEmergencyReschedule → commitEmergencyReschedule)

3. Tagesübersicht — „Stellen Sie meine Planung für morgen zusammen und kennzeichnen Sie alles, was gefährdet ist.“ (listJobRequests → getTechnicianSchedule)

4. Verfügbarkeit finden — „Finden Sie diese Woche 3 Stunden für eine Radtour mit meiner Frau, ohne Aufträge zu riskieren.“ (getTechnicianSchedule → der Agent bewertet den frei verfügbaren Puffer)

Dieselben Prompts erscheinen auf allen Crisphive-Auflistungen und -Dokumentationsseiten – was Sie hier sehen, ist also überall genau das Erst-Erlebnis.

Related MCP server: Servicialo

Voraussetzungen

Jeder MCP-Client, der Remote-Server über Streamable HTTP unterstützt — claude.ai, Claude Desktop, Claude Code, ChatGPT, Gemini CLI, Cursor, VS Code, Windsurf, Cline, Zed, LM Studio, ….

Installation

claude.ai (OAuth — kein Key erforderlich)

Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen und https://api.crisphive.com/mcp einfügen. Melden Sie sich an, wenn der Zustimmungsbildschirm geöffnet wird – als Inhaber eines Crisphive-Unternehmens. (Benutzerdefinierte Connectors erfordern einen Claude-Plan, der sie unterstützt.)

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

Oder ergänzen Sie in .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

Einstellungen → Connectors (Entwicklermodus) → MCP-Server mit der URL https://api.crisphive.com/mcp hinzufügen (OAuth).

Gemini CLI

Fügen Sie in ~/.gemini/settings.json hinzu (Hinweis: Gemini CLI verwendet httpUrl für Streamable-HTTP-Server):

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

Andere MCP-Clients (Windsurf, Cline, Zed, LM Studio, …)

Die meisten Clients akzeptieren die gängige Remote-Server-Konfiguration:

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

Nur der Name des URL-Felds unterscheidet sich bei manchen Clients:

Clients, die nur stdio sprechen, können mit mcp-remote verbunden werden:

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

Lokaler Server (npm — @crisphrlve/mcp)

Dieses Repository enthält zusätzlich einen schlanken lokalen Stdio-Server: dieselben 43 Tools (gleiche Namen und Schemas – generiert aus derselben /v1-OpenAPI-Spezifikation wie der gehostete Endpoint). Jeder Aufruf ist eine HTTPS-Anfrage an die Crisphive API mit Ihrem Key. Es läuft keine Geschäftslogik lokal.

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

Umgebungsvariablen:

Verwenden Sie bevorzugt den gehosteten Remote-Server (https://api.crisphive.com/mcp), wenn Ihr Client ihn unterstützt – OAuth, keine Key-Verwaltung, immer aktuell. Das lokale Paket ist für reine Stdio-Clients und selbstgehostete Umgebungen gedacht.

Arbeit im Repository: npm ci && npm test. Die Tool-Registry (src/tools.generated.json) wird generiert – npm run generate aktualisiert sie auf Basis der Live-Spezifikation; CI schlägt fehl, wenn sie von /v1 abweicht.

Authentifizierung

Jede Anfrage wird mit einem geheimen API-Key als Bearer-Token authentifiziert. Keys erstellen Sie aus Ihrem Crisphive-Business-Dashboard. Der Key-Präfix bestimmt die Datenumgebung:

• chsk_live_… → production (Live)-Daten

• chsk_test_… → isolierte Sandbox-Daten

Keys aus der Umgebung laden – niemals einchecken.

Keys laufen ab. Die Lebensdauer wird bei der Erstellung gewählt – Standard 30 Tage (bis 365) – und ist für den Lebenszyklus des Keys fix; sie später nicht verlängert werden. Zum Verlängern zweite, auf den Agenten ausgerichten und den ersten sperren – so ist der Wechsel ohne Ausfallzeiten möglich und benötigt keinen speziellen Endpunkt (dieselbe Vorgehen wie bei AWS-Zugriffsschlüsseln). Lesen Sie expires_at aus dem Dashboard oder über die Key-API und legen Sie den Zeitpunkt für den Wechsel fest. Ein abgelaufener Key meldet API_KEY_EXPIRED (anders als API_KEY_INVALID), sodass Sie eine versäumte Verlängerung getrennt von einem Widerruf sehen.

Crisphiviertebenachrichtigt die Unternehmensinhaber 7 Tage vor Ablauf eines Keys (14 Tage bei einer OAuth-Verbindung), sodass ein Ablauf unerwartet. Die Mail geht an das Unternehmen, nicht immer an Sie, deshalb verfolgen Sie expires_at selbst. Ein bewusst auf unter 7 Tage Lesegerät erstellter Key erhält keine weitere Vorabwarnung.

Der MCP-Endpunkt unterstützt zusätzlich OAuth 2.1 für Client-Connectors (claude.ai, ChatGPT, …): Der Inhaber autorisiert den Agenten per Zustimmungsbildschirm, kein Key wird je ausgetauscht. Ein konformer MCP-Client führt den gesamten Ablauf automatisch aus – Discovery, dynamische Client-Registrierung, Authorization Code auch PKCE. Vollständiger Fluss, Scopes und Token-Lichtzeittypen finden Sie in docs/integration.md.

Tools

Mehr als 43 Tools, jeweils eines pro Operation der öffentlichen /v1-API – genau wie die SDK-Methoden (listCustomers, createJobRequest, …), abgeleitet aus derselben OpenAPI-Spezifikation, sodass REST und Zentrale stehen. Einbou Vollständige Referenz: docs/tools.md.

Typischer Agentenfluss:

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

Notfall (P0) Flow:

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

Pagination

Listen-Tools akzeptieren page / limit und verfügen über ein meta-Objekt (total, count, per_page, current_page, total_pages).

Idempotenz

Create-/commit-Tools (createCustomer, createTechnician, createJobRequest, confirmJobRequest, commitJobRequestMove, commitEmergencyReschedule) akzeptieren ein idempotency_key-Argument, sodass Wiederholungen niemals ein Duplikat der Erstellung auslösen – gleicher Wert bei erneutem Senden verwenden.

Fehler

Jedes Tool gibt den Crisphive-Anwort-Envelope zurück (als Text und structuredContent): error_code ist bei Erfolg 0, bei Fehler ein stabiler Code (CUSTOMER_NOT_FOUND, API_KEY_INVALID, …). Nicht an Texten, sondern an die Codes.

Dokumentation

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

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

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

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

• For AI (OpenAPI-Spezifikation + Assist prompt): https://docs.crisphive.com/for-ai

• Client-Integrationsleitfaden: docs/integration.md

• Tool-Referenz: docs/tools.md

Python

Beschreibung.

• Datenschutzerklärung: https://crisphive.com/privacy-policy — Crisphive verarbeitet die über die API erreichbaren Geschäftsdaten (Kunden, Buchungen, Techniker, Fuhrpark) ausschließlich zum Betrieb des Dienstes; es verkauft keine personenbezogenen Daten. Die Daten werden aufbewahrt, solange das Konto aktiv ist, und nur an Dienstleister/Unterauftragsverarbeiter weitergegeben, soweit dies notwendig ist. Ein über MCP verbundener Agent handelt im Auftrag des autorisierenden Unternehmens und ist auf die Daten dieses Unternehmens, die Umgebung (live vs. sandbox) und die erteilten Berechtigungen beschränkt.

• Support: support@crisphive.com

Lizenz

MIT