# ChatGPT integration

> How the Maxmove app in ChatGPT connects to a Maxmove account over MCP and OAuth, what it can do per role, and how bookings and payment work.

The Maxmove app for ChatGPT lets a signed-in Maxmove user check serviceability, compare vehicle types, get binding quotes, book after explicit confirmation, and track orders in a ChatGPT conversation.

For setup, see [Use Maxmove in ChatGPT](https://maxmove.com/en/help/business-api/chatgpt-maxmove-setup).

## How it connects

ChatGPT connects to the [Maxmove MCP server](https://maxmove.com/en/developers/docs/ai/mcp-server) at `https://api.maxmove.com/mcp`. It does not use the public `/v1` API or API keys.

- **Sign-in.** The user selects **Connect** in ChatGPT and signs in with their Maxmove account (OAuth 2.1 with PKCE). ChatGPT identifies itself with an OAuth client metadata document on a `chatgpt.com` or `openai.com` domain.
- **Permissions.** The connection starts with read access. The first booking, cancellation, or dispatch change asks the user to grant write access.
- **Workspace.** The connection is bound to the Maxmove workspace that was active when the user connected. To switch, the user changes the workspace in Maxmove and reconnects.
- **Disconnect.** Removing the app or its connection in ChatGPT under **Settings → Apps & Connectors** revokes ChatGPT's access.

## Data flow

**1. Quote**

The user describes the transport. ChatGPT calls the quote tool with the addresses as the user gave them; Maxmove geocodes them and checks serviceability and the vehicle. The quote renders as a booking summary card.

**2. Confirm**

ChatGPT books only after the user confirms the reviewed quote in the conversation or taps the button on the card. The booking redeems exactly that quote.

**3. Track**

The order renders as a tracking card with status, driver, and arrival time. The user can list their orders, cancel one, or open a support conversation.

Orders booked this way are normal Maxmove orders in the workspace, marked as booked through ChatGPT. They don't send `/v1` webhook events.

## What it can do

The tools depend on the workspace type and the user's role: personal and business accounts can quote, book, track, and cancel; fleet control roles can inspect the order board and vehicle readiness and make confirmed dispatch changes; drivers can read their own routes, orders, and tours. See [Tools by role](https://maxmove.com/en/developers/docs/ai/mcp-server#content-tools-by-role).

## Payment

Bookings confirmed in ChatGPT use monthly invoice or cash payment. For card payment, ChatGPT hands the reviewed route, time, vehicle, and extras to a booking page on maxmove.com, where the user pays by card. That page prices the route again.

## Requirements

- A Maxmove account with an active personal, business, fleet, or driver workspace and an eligible role.
- A ChatGPT plan and region in which OpenAI offers apps.
- Addresses inside the Maxmove [service area](https://maxmove.com/en/developers/docs/coverage).

---

Source: https://maxmove.com/en/developers/docs/integrations/chatgpt