Set up Crisphive in ChatGPT
Set it up with your AI assistant
- What it is
- A setup file: this ChatGPT guide rewritten as instructions for ChatGPT, Claude or any AI chat.
- Why use it
- On its own, an AI assistant only guesses how to connect Crisphive to ChatGPT, from memory that can be wrong or out of date. With this file it follows this exact guide and walks you through it one step at a time: it asks how far you have got, tells you exactly what to click and checks the result with you.
- What is inside
- Every step of this page, with the current screens, buttons and values
- Rules for the assistant: one step at a time, start in Rehearsal, finish with the test
- Links back to this page and to Crisphive support
- Is it safe?
- Yes. It is plain text (Markdown) — no program, nothing to install, no keys. Use Preview to read it in your browser before you save anything.
The file is in English. Never paste an API key or password into the chat.
Follow these steps and Crisphive will be connected to your ChatGPT account — signed in, pointed at the right data, and tested with a real confirmed booking — in about five minutes.
ChatGPT reaches other services through plugins — its directory is now called Plugins; older pages call the same thing an app. The Crisphive plugin speaks MCP (Model Context Protocol), the open format ChatGPT uses to discover and call another service’s actions. You do not need to know MCP to set it up. For what ChatGPT can do once connected, see Crisphive for ChatGPT; for the full tool list, see the MCP reference.
Ways to connect
| Option | Use it when | You need |
|---|---|---|
| A — The Crisphive plugin from Plugins (recommended) | Almost always. It is the quickest path. | Any ChatGPT plan, including Free; a workspace admin may control plugins on Business and Enterprise. |
| B — Custom connector in developer mode | Your workspace only allows custom connectors, or you want to point at a smaller tool set. | A ChatGPT plan where developer mode is available. A Free account shows no developer mode in its settings. |
Before you start
- A Crisphive account you can sign in to at
https://crisphive.com/app, with at least one technician, a service area and working hours — ChatGPT can only book times your team can work. - Know who should approve. ChatGPT always acts as the person who clicks Approve, with that person’s current Crisphive role. For dispatch work, an Owner or Booking Coordinator; see Which role to connect with.
- A ChatGPT account. The Free plan is enough for the Crisphive plugin.
- About 5 minutes. No API key and nothing to install.
- Start in Rehearsal. Rehearsal is your business’s sandbox: isolated test data — nothing there reaches a real customer. You choose the mode on the Crisphive approval page; see Step 3.
Step 1 — Add Crisphive to ChatGPT
Use Option A or Option B from Ways to connect. Both end on the same Crisphive approval page in Step 2.
Option A — Install the Crisphive plugin
In ChatGPT’s left navigation click Plugins. The page reads Connect plugins to let ChatGPT work across your tools.
Type Crisphive in Search plugins. The result is Crisphive — Scheduling API for AI agents.
Click the + button on the Crisphive result. The Crisphive approval page opens in a new tab — continue at Step 2.
Step 1 of 2Open Plugins in the left navigation and type Crisphive in Search plugins.
All steps
- Open Plugins in the left navigation and type Crisphive in Search plugins.
- Click + on the Crisphive result. The Crisphive approval page opens in a new tab.
Option B — Add a custom connector in developer mode
ChatGPT moves these settings between versions and plans, so the steps below say what to do rather than which menu to click. OpenAI keeps the current menu path in its own guide: ChatGPT developer mode. If your settings have no developer mode (a Free account has none), use Option A.
In ChatGPT’s settings, find Developer mode and switch it on. If you cannot find it, your plan or your workspace admin does not allow it.
With developer mode on, ChatGPT shows an option to create your own connector from an MCP server. Open it.
Name: Crisphive. Description (if asked): Book and dispatch field jobs in Crisphive. Server URL: https://api.crisphive.com/mcp. Authentication: OAuth. Leave any client ID and client secret fields empty — ChatGPT registers itself with Crisphive automatically. If ChatGPT asks you to confirm that you trust the server, confirm.
ChatGPT connects to Crisphive and opens the Crisphive approval page — continue at Step 2.
Step 2 — Sign in to Crisphive and approve
Both options end on the same Crisphive page. This is OAuth: a standard way to let ChatGPT act for you in Crisphive without you copying a password or key.
If you are signed out, sign in with your usual email or phone code; you come back to the approval page afterwards.
The page is titled Authorize ChatGPT and reads ChatGPT wants to access your Crisphive business. It shows your business name and the mode (Rehearsal or Live), with a Switch link if the business or account is wrong. In Rehearsal it says ChatGPT will only see Rehearsal (test) data and offers Connect Live instead.
Back in ChatGPT the plugin card shows Crisphive plugin installed and a Try now button. Deny shares nothing.
Step 1 of 2Check the business and the mode. In Rehearsal, ChatGPT will only see Rehearsal (test) data. Use Switch for another business or account, or Connect Live instead for live data.
All steps
- Check the business and the mode. In Rehearsal, ChatGPT will only see Rehearsal (test) data. Use Switch for another business or account, or Connect Live instead for live data.
- Click Approve. Back in ChatGPT the card reads Crisphive plugin installed, with Try now.
Step 3 — Point it at Live or Rehearsal data
Crisphive keeps a Live copy of your business (real customers and jobs) and a Rehearsal copy (the sandbox: isolated test data that never reaches a real customer). ChatGPT has no setting for this: the connection uses the mode shown on the Authorize ChatGPT page when you click Approve, and keeps it.
Approve while the page shows Rehearsal. If it shows Live, switch the Crisphive dashboard to Rehearsal (Rehearsal | Live switch in the left sidebar → Switch) and start the connection again.
Click Connect Live instead on the approval page, check that it shows Live, then approve.
Disconnect Crisphive in ChatGPT, connect again and approve in the other mode.
Step 4 — Use Crisphive in a chat and confirm actions
Click Try now on the plugin card. A new chat opens with a Crisphive chip already in the message box and an example prompt. Replace the text after the chip with your request.
Before ChatGPT uses Crisphive it shows a card Allow ChatGPT to use Crisphive? describing the action and the data shared (for example names and physical addresses), with Always allow, Deny (Esc) and Allow once. On a live connection, prefer Allow once for anything that books, moves or deletes.
ChatGPT may ask you to confirm the job estimate (duration and buffers) before scheduling, and offers the nearest open time when the time you asked for is not free. Answer in plain words.
Crisphive labels every tool so ChatGPT knows when to ask: read-only for lookups; destructive for anything that overwrites, reschedules or deletes (updates, deletes, and the three “commit” tools); open world for every write, because a write can email or text a customer or technician, send a webhook, or update a connected calendar. Matching reads are also marked open world because they price travel through Google Maps — they still change nothing.
Step 5 — Test the connection
Do this on a Rehearsal connection. Use an address inside one of your service areas. 613-555-01xx numbers are reserved for fiction, and Crisphive never texts them.
After the Crisphive chip, type, for example: “book a water heater check for Sam Tremblay (phone +16135550188) at 300 Bank Street, Ottawa, K2P 1X8, next Wednesday at 11 am, and confirm it.” Allow the action cards.
In our test ChatGPT found the existing customer, asked us to confirm a 60-minute visit with 15-minute buffers, then reported that 11:00 was not open and offered 10:30. We replied “Yes, please confirm 10:30 AM.”
Success: Appointment confirmed! with a booking reference such as REQ-CA-…, the date and time range, the technician arrival window, a technician assigned, and View booking details.
In https://crisphive.com/app (Rehearsal), the job shows Confirmed on the existing customer — Crisphive does not create a second customer with the same phone. Under Settings → Developer → MCP connections, ChatGPT is listed in Connected AI apps.
Which role to connect with
ChatGPT can do exactly what the approving person can do in the Crisphive dashboard, re-checked on every request. Change their role and ChatGPT’s access follows; remove or suspend them and the connection stops at once.
| Approved by | Result |
|---|---|
| Owner | Full access to the business, as in the dashboard. |
| Booking Coordinator | The schedule and customers — the usual choice for dispatch. |
| Administrator | Rehearsal (sandbox) only by default; nothing in live data until the Owner grants modules in the role matrix. |
| Technician | Can read the job type list, but not the business job board, job details, matching views or other technicians’ schedules (403 FORBIDDEN). |
Ready-to-copy settings
For Option B (custom connector in developer mode).
Name: Crisphive MCP server URL: https://api.crisphive.com/mcp Authentication: OAuth — leave client ID and client secret empty Smaller tool sets (optional, same sign-in, same permissions): https://api.crisphive.com/mcp/dispatch jobs, moves, emergencies, sick calls, roster reads https://api.crisphive.com/mcp/crm customers and their bookings
Keep the connection alive
- While you use it, ChatGPT refreshes its access by itself. After 30 days without use, the connection lapses.
- Whatever the use, it ends 90 days after approval. Change that with Set lifetime on ChatGPT’s row in Settings → Developer → MCP connections (1–365 days, counted from the original approval).
- You are warned: Owners and Administrators are emailed 14 days before it ends. To renew, connect again and approve.
Disconnect ChatGPT
Open Settings → Developer → MCP connections, click Disconnect on ChatGPT’s row under Connected AI apps, then confirm. This revokes every active grant ChatGPT holds for your business, including other people’s. The list shows the dashboard’s current mode only — switch to Rehearsal to find a Rehearsal connection.
In ChatGPT’s settings, open the list of apps and connectors, open Crisphive, and disconnect or delete it.
An access token ChatGPT already holds keeps working for up to one hour after a disconnect in Crisphive. Removing or suspending the member stops it on the next request.
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
| No Developer mode in settings | Your ChatGPT plan or workspace does not offer it (a Free account has none). | Use the Crisphive plugin from Plugins (Option A), or ask your workspace admin. |
| ChatGPT answers without using Crisphive | The chat has no Crisphive chip, so ChatGPT did not pick the plugin. | Open the chat from Try now on the plugin card, or start a new chat with Crisphive selected. |
| ChatGPT offers a different time than you asked for | No qualified technician is free at that exact time. | Accept the offered time, or ask for other open times. |
| Crisphive page says Invalid authorization request | The sign-in link was incomplete or expired. | Close the window and start the connection again from ChatGPT. |
| ChatGPT finds no customers or jobs, or the wrong ones | The connection is in the other mode (Live vs Rehearsal) than your dashboard. | Disconnect, connect again and approve in the mode you want (Connect Live instead for live data). |
403 FORBIDDEN when asking about jobs or the schedule | The approving member is a Technician or lacks job management. | Have an Owner or Booking Coordinator connect. |
Approve fails with access_denied | Your membership is suspended, or the request asked for a permission your role lacks. | Ask the Owner to reactivate you or adjust your role. |
ChatGPT asks to reconnect; OAUTH_GRANT_EXPIRED | The connection reached its lifetime or was unused for 30 days. | Connect and approve again. |
Test booking “saved but not confirmed”, or JOB_REQUEST_NO_TECHNICIAN_AVAILABLE | No technician fits that exact time. | Ask for the nearest open times. Do not book the job again — it is already in the coordinator queue. |
JOB_REQUEST_QUOTE_NOT_SCHEDULABLE | No technician can take the job in any window asked for; data.reason says why. | Pick another day, or fix the cause in the dashboard (service area, working hours, skills). |
PHONE_INVALID | The phone number is not in international form. | Give it with the country code: +1 613 555 0177. |
JOB_REQUEST_INVALID_INPUT with data.means_locally | A time carried a timezone offset that disagrees with your business’s local time. | Ask for the time in your business’s local time, without an offset. |
429 | More than 240 requests a minute on this key or connection, shared with REST — about 120 MCP tool calls a minute, since each tool call also makes one REST request. | Wait a minute and retry. |
Go live
- Disconnect the Rehearsal connection, connect again, choose Connect Live instead on the approval page and approve — as an Owner or Booking Coordinator.
- On live data, a confirmed job notifies the customer and technician, and a committed move, emergency or sick-call plan notifies every customer whose visit changed. Read each confirmation card before you accept it.
- Note the Expires date in MCP connections (90 days by default) and renew or raise the lifetime before it.
Related guides and reference
- AI assistants overview — Claude, ChatGPT and any other MCP client
- Claude — the Crisphive connector for claude.ai, Desktop and Claude Code
- MCP server reference — every tool, the tool profiles and client setup
- Voice agents overview — the voice tool set and booking rules
- Automation platforms overview — what every automation integration shares