en

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

OptionUse it whenYou 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 modeYour 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

1
Open Plugins

In ChatGPT’s left navigation click Plugins. The page reads Connect plugins to let ChatGPT work across your tools.

2
Find Crisphive

Type Crisphive in Search plugins. The result is Crisphive — Scheduling API for AI agents.

3
Click +

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
  1. Open Plugins in the left navigation and type Crisphive in Search plugins.
  2. 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.

1
Turn on developer mode

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.

2
Create a new connector

With developer mode on, ChatGPT shows an option to create your own connector from an MCP server. Open it.

3
Fill in the form

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.

4
Create it

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.

1
Sign in to Crisphive if asked

If you are signed out, sign in with your usual email or phone code; you come back to the approval page afterwards.

2
Check the business, the mode and who you are

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.

3
Click Approve

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
  1. 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.
  2. 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.

1
For a Rehearsal (test) connection

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.

2
For a live connection

Click Connect Live instead on the approval page, check that it shows Live, then approve.

3
To switch later

Disconnect Crisphive in ChatGPT, connect again and approve in the other mode.

Step 4 — Use Crisphive in a chat and confirm actions

1
Open a chat with Crisphive

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.

2
Expect a confirmation before actions

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.

3
Expect questions

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.

1
Ask for a booking

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.

2
Answer ChatGPT’s questions

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.”

3
Read the answer

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.

4
Check in the dashboard

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 byResult
OwnerFull access to the business, as in the dashboard.
Booking CoordinatorThe schedule and customers — the usual choice for dispatch.
AdministratorRehearsal (sandbox) only by default; nothing in live data until the Owner grants modules in the role matrix.
TechnicianCan 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

1
From Crisphive — cuts off ChatGPT for the whole business

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.

2
From ChatGPT — only your account

In ChatGPT’s settings, open the list of apps and connectors, open Crisphive, and disconnect or delete it.

3
Expect a short tail

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

SymptomCauseFix
No Developer mode in settingsYour 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 CrisphiveThe 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 forNo qualified technician is free at that exact time.Accept the offered time, or ask for other open times.
Crisphive page says Invalid authorization requestThe 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 onesThe 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 scheduleThe approving member is a Technician or lacks job management.Have an Owner or Booking Coordinator connect.
Approve fails with access_deniedYour 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_EXPIREDThe 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_AVAILABLENo 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_SCHEDULABLENo 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_INVALIDThe phone number is not in international form.Give it with the country code: +1 613 555 0177.
JOB_REQUEST_INVALID_INPUT with data.means_locallyA 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.
429More 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.

FAQ

Do I need a paid ChatGPT plan?
No. The Crisphive plugin installs and books jobs on the Free plan. Developer mode (Option B) depends on your plan.
Is it a ChatGPT app, connector or plugin?
The same thing. ChatGPT now lists it under Plugins; older pages call it the Crisphive app. One you add yourself in developer mode is a custom connector.
Where is developer mode in ChatGPT?
In ChatGPT’s settings — the exact menu changes between versions; OpenAI’s developer mode guide has the current path. Availability depends on your plan, and a workspace admin may restrict it.
Do I need a Crisphive API key for ChatGPT?
No. You sign in to Crisphive and click Approve. No key is pasted into ChatGPT.
How do I connect ChatGPT to my sandbox (Rehearsal) instead of live data?
Approve while the Authorize ChatGPT page shows Rehearsal. The connection keeps that mode until you disconnect and approve again.
Why can my technician’s ChatGPT not see the schedule?
The connection acts as the person who approved it, and the Technician role cannot read the business-wide job board.
Why did ChatGPT stop working with Crisphive?
Usually the connection reached its lifetime (90 days after approval by default), sat unused for 30 days, or the approving member was removed, suspended or changed role. Reconnect; check the expiry under Settings → Developer → MCP connections.
How do I remove one person’s ChatGPT without disconnecting everyone?
Have that person disconnect Crisphive in their own ChatGPT settings, or suspend or remove them in Crisphive. Disconnect in MCP connections revokes ChatGPT for the whole business.