GOHIGHLEVEL ANSWERS & PROMPTS: PLAYBOOK T70 · GOHIGHLEVEL MCP V2 ENDPOINTS & SCOPED PRIVATE INTEGRATION TOKENS
AUTHOR: DANIEL HALLMAN
KEYWORD: MCP DISCONNECT
PLAYBOOK T70 · GoHighLevel MCP V2 Endpoints & Scoped Private Integration Tokens KEYWORD: MCP DISCONNECT

How Do You Stop GoHighLevel MCP From Constantly Disconnecting in Claude and ChatGPT?

Answer: GoHighLevel MCP connections drop every few days when you connect through the legacy endpoint or rely on a browser OAuth session whose refresh token expires. Switch to HighLevel's client-specific V2 MCP endpoint, authenticate with a location-scoped Private Integration token (pit-...) created in Settings > Private Integrations alongside your locationId header, and run one test contact lookup and tag update in Automation > Workflow > Execution Logs before deleting the old connection.

STEP-BY-STEP INSTRUCTIONS + ANNOTATED GHL SCREENSHOTS

Steps in GoHighLevel

  1. STEP 1
    In Settings > Private Integrations, click Create New Integration, select only the scopes your assistant needs (Contacts, Opportunities, Calendars, Conversations, and Workflows, leaving destructive delete scopes unchecked), and copy the pit-... token.
    REAL GHL SCREEN · SETTINGS > PRIVATE INTEGRATIONS (API V2) ANNOTATED GHL SCREENSHOT
    Annotated GoHighLevel Private Integrations API v2.0 screenshot showing Settings > Private Integrations menu, Create New Integration button, and scoped token audit row
    1Open Settings > Private Integrations 2Click Create New Integration 3Review Scoped Token & Last Used Date
  2. STEP 2
    In Automation > Workflow Builder (and your Claude or ChatGPT MCP server settings), replace the legacy /mcp/ browser OAuth connection with the V2 MCP endpoint and pass Authorization: Bearer pit-... plus your target sub-account locationId so rotating web sessions never disconnect the tool.
    REAL GHL SCREEN · AUTOMATION > WORKFLOW BUILDER CANVAS ANNOTATED GHL SCREENSHOT
    Annotated GoHighLevel Workflow Builder canvas screenshot showing If/Else condition branch, priority routing steps, and Builder/Settings/Execution logs tabs
    1Add If/Else Condition & Tag Guard 2Chain Priority & Wait Steps 3Switch to Settings or Execution Logs
  3. STEP 3
    In Automation > Workflow > Execution Logs (and Contacts), run one test contact search and one test tag update through the new MCP connection to confirm it reads and writes in the right sub-account before removing your old connector.
    REAL GHL SCREEN · WORKFLOW > EXECUTION LOGS ANNOTATED GHL SCREENSHOT
    Annotated GoHighLevel Workflow Execution Logs screenshot showing Execution logs tab, All actions and All statuses filters, and populated contact run rows
    1Open Execution Logs Tab 2Filter by Action Type or Status 3Search Contact to Trace Runs
MODE: AGENT PROMPT
PASTE INTO CLAUDE CODE, CURSOR, CHATGPT, OR GOHIGHLEVEL ASK AI AGENT PROMPT
Fix recurring GoHighLevel MCP disconnections for Claude or ChatGPT in sub-account <YOUR_LOCATION_ID>:
1. In Settings > Private Integrations, create a scoped API v2 token (pit-...) with Contacts, Opportunities, Calendars, Conversations, and Workflows permissions and no delete scopes.
2. Configure the client-specific V2 MCP endpoint with Authorization: Bearer <PIT_TOKEN> and locationId: <YOUR_LOCATION_ID> instead of an expiring browser OAuth session.
3. Run a test contact lookup and tag update and verify the event in Contacts and Automation > Workflow > Execution Logs before removing the legacy connection.
Cause
  • Operators connecting Claude or ChatGPT to the legacy https://services.leadconnectorhq.com/mcp/ URL via interactive browser login get forced to reauthorize every few days whenever the OAuth session token expires or rotates.
  • Even after switching to the newer client-specific V2 URL, keeping delete scopes enabled or skipping a live sub-account write test can leave the assistant pointing at the wrong location or failing on tool calls.
GoHighLevel Configuration
  • Generate a non-expiring, least-privilege Private Integration token (pit-...) in Settings > Private Integrations, pair it with the V2 MCP endpoint and explicit locationId in Automation > Workflow Builder (or your MCP client config)
  • and verify a real contact tag update in Automation > Workflow > Execution Logs.
MENU PATH REFERENCE

GoHighLevel Menu Paths

Step Menu Path in GHL Action
Step 1 Settings > Private Integrations Click Create New Integration, select only the scopes your assistant needs (Contacts, Opportunities, Calendars, Conversations, and Workflows, leaving destructive delete scopes unchecked), and copy the pit-... token.
Step 2 Automation > Workflow Builder In Automation > Workflow Builder (and your Claude or ChatGPT MCP server settings), replace the legacy /mcp/ browser OAuth connection with the V2 MCP endpoint and pass Authorization: Bearer pit-... plus your target sub-account locationId so rotating web sessions never disconnect the tool.
Step 3 Automation > Workflow > Execution Logs Run one test contact search and one test tag update through the new MCP connection to confirm it reads and writes in the right sub-account before removing your old connector.
3-step diagram showing Scoped PIT token creating a location token without delete scope, Client V2 endpoint passing Bearer token and location ID, and Test write action verifying contact tag update in logs.
VISUAL PLAYBOOK · PLAYBOOK T70 (GOHIGHLEVEL MCP V2 ENDPOINTS & SCOPED PRIVATE INTEGRATION TOKENS) Back to Annotated GHL Screenshots ↑
DEFAULT SETUP VS. AUTOMATED WORKFLOW

Operational Comparison

Speed to Lead & Callback Safety
Default 0s Checkbox: Collides with Rep
45s Guard Workflow: Zero Collision
Caller Reply & Booking Rate
Generic 'We Missed You' SMS: 12%
Question-First Workflow SMS: 64%

Related Questions

BUILD FASTER IN GOHIGHLEVEL · FREE TRIAL BONUSES + MCP SERVER

Build this directly inside your GoHighLevel sub-account

Connect Claude Code, Cursor, or OpenAI Codex to our ghl-tools MCP Server & Rust CLI to build workflows, forms, and funnels from your editor, or start your GoHighLevel plan through our partner link to unlock $612+ in ready-to-import kits (including GHL MCP V2 & Private Integration Setup Kit) and weekly live clinics.