Overview
OAuth is the non-technical path for ChatGPT, Claude, and Gemini: the AI app opens Liquify in your browser, you sign in (Ultra required), and tap Allow. No API keys to copy. Liquify then issues tokens the client uses with https://api.getliquify.com/v1/mcp.
For Cursor, Claude Desktop, and similar clients that paste URL + token, use API token setup (Other in the app).
In the app
- Open Connections → MCP.
- Copy the connection link.
- Follow the ChatGPT / Claude / Gemini guide in the hub (or the steps below).
- After Allow, the app appears under Connected apps — you can disconnect anytime.
Ultra lapse pauses grants (they stop working until Ultra returns). Connected apps stay listed so you can disconnect; new connections require Ultra.
Liquify does not start OAuth by itself. The AI client’s connector UI opens authorize; unauthenticated requests redirect to https://app.getliquify.com/oauth/mcp for consent.
Per client
ChatGPT
- Copy the connection link.
- In ChatGPT (web), open Settings → Apps / connectors (Developer Mode may be required on some plans).
- Create a connector named Liquify, paste the link, choose OAuth.
- Sign in to Liquify → Allow.
- Enable Liquify in the chat when prompted.
Claude
- Copy the connection link.
- In Claude, open Customize → Connectors → Add custom connector.
- Paste the Liquify connection link and continue.
- Click Connect, sign in to Liquify, and tap Allow.
Gemini
- Copy the connection link.
- In Gemini, open the MCP / connector settings and add a custom server.
- Paste the Liquify connection link and choose OAuth.
- Sign in to Liquify → Allow.
Menu names change often — see OpenAI’s custom MCP help and Claude custom connectors.
Technical notes
GET /v1/oauth/metadata
GET /.well-known/oauth-authorization-server
Flow: authorize (PKCE S256) → consent on app.getliquify.com → code → POST /v1/oauth/token (authorization_code or refresh_token) → MCP calls with Bearer access token. Revoke via POST /v1/oauth/revoke or Connected apps in Liquify. Ultra lapse pauses grants.
Allowlisted OAuth clients include Claude, ChatGPT, Gemini, and Cursor redirect URIs. In the app and these docs, Cursor’s primary path is still API token / Other.