GoHighLevel MCP Server कैसे सेटअप करें: हर AI टूल के लिए पूरी गाइड

संक्षेप में

• GoHighLevel का एक आधिकारिक MCP server है, जिससे Claude, Cursor और n8n जैसे AI टूल्स आपका अकाउंट पढ़ और बदल सकते हैं।
• इस एक पेज पर हर AI टूल, official बनाम community की तुलना, सुरक्षा और एजेंसी के असली prompts हैं।
• यह किसी भी GoHighLevel प्लान के साथ मुफ़्त है। आपको बस एक Private Integration Token और करीब 5 मिनट चाहिए।

Commands और config आखिरी बार 2026-08-10 को आधिकारिक GoHighLevel docs से मिलाकर जाँचे गए।

अपना टूल चुनें

• नॉन-डेवलपर्स के लिए MCP. MCP में नए हैं? Token छूने से पहले आसान भाषा वाला यह वर्ज़न पढ़ें।
• Claude को GoHighLevel से जोड़ें. Claude की अलग walkthrough, token से पहले prompt तक।
• ChatGPT को GoHighLevel से जोड़ें. ज़्यादातर प्लान पर अभी आधिकारिक MCP server नहीं है। Custom GPT और Zapier का रास्ता, जो आज काम करता है।

GoHighLevel MCP server क्या है

MCP का मतलब है Model Context Protocol। यह एक खुला मानक है, जिससे AI टूल नाम वाले tools के ज़रिए किसी बाहरी सेवा को चला सकता है। GoHighLevel MCP server इसी दरवाज़े का GoHighLevel का आधिकारिक रूप है। इसे जोड़ने के बाद AI असिस्टेंट आपके GoHighLevel अकाउंट पर सीधे काम कर सकता है, आपको dashboard में क्लिक नहीं करना पड़ता।

Server एक ही endpoint पर है: https://services.leadconnectorhq.com/mcp/। यह आपके अकाउंट के मुख्य हिस्सों तक पहुँचता है: contacts, conversations, calendars, opportunities, payments, locations, social media posting, blogs और emails। इनमें से AI क्या छू सकता है, यह आप token बनाते समय तय करते हैं, इसलिए उसके पास कभी उससे ज़्यादा access नहीं होता जितना आपने दिया।

आसान शब्दों में: GoHighLevel खोलकर किसी lead को ढूँढने के बजाय आप Claude से कह सकते हैं "इस हफ़्ते जिन leads ने जवाब दिया और कॉल बुक नहीं की, उन्हें ढूँढो", और वह जवाब सीधे आपके अकाउंट से लाइव निकाल लेता है। MCP server यही संभव बनाता है।

इससे क्या ऑटोमेट कर सकते हैं

व्यवहार में ज़्यादातर लोग इसे कुछ बार बार आने वाले कामों के लिए जोड़ते हैं। कुछ ठोस उदाहरण:

• Contact triage. हर वह lead ढूँढें जिसने जवाब दिया लेकिन कॉल बुक नहीं की, पाइपलाइन में हाथ से स्क्रॉल किए बिना।
• Pipeline अपडेट. आसान भाषा के अनुरोध से opportunity बनाएँ या सही stage में ले जाएँ, dashboard में क्लिक किए बिना।
• Conversation digest. एक हफ़्ते के संदेशों का सारांश बनवाएँ और जो खरीदने को तैयार या नाराज़ लगे उसे चिह्नित करवाएँ, सोमवार की समीक्षा से पहले।
• कॉल की तैयारी. डायल करने से ठीक पहले किसी contact का पूरा इतिहास एक छोटे ब्रीफ़ में लाएँ।
• लिस्ट की सफ़ाई. किसी tag वाले सारे contacts निकालें और देखें किनकी opportunity अब भी खुली है।

ये सब उन्हीं scopes से चलते हैं जो आपने token पर सेट किए हैं, इसलिए AI सिर्फ़ उन्हीं मॉड्यूल को छूता है जिन्हें आपने मंज़ूर किया। पूरी prompt walkthrough इस पेज में आगे हैं।

क्या यह मुफ़्त है, और क्या चाहिए

हाँ, आधिकारिक MCP server किसी भी GoHighLevel प्लान के साथ मुफ़्त है। MCP का कोई अतिरिक्त शुल्क नहीं है। लोग इसलिए उलझते हैं कि जो AI टूल आप जोड़ते हैं (Claude, Cursor और बाकी) उनकी अपनी कीमत होती है, लेकिन GoHighLevel की तरफ़ आपकी सामान्य सब्सक्रिप्शन के अलावा कुछ नहीं लगता।

आपको तीन चीज़ें चाहिए, और सेटअप में करीब 5 मिनट लगते हैं:

• एक GoHighLevel अकाउंट (कोई भी प्लान)।
• Settings में बना एक Private Integration Token (अगले हिस्से में)।
• आपकी Location ID, जो बताती है कि AI किस sub-account में काम करे।

Step 1: अपना Private Integration Token बनाएँ

GoHighLevel में Settings, फिर Private Integrations, फिर Create New Integration पर जाएँ। उसे साफ़ नाम दें (जैसे "Claude MCP, Acme client")। सिर्फ़ ज़रूरी scopes चुनें, फिर token कॉपी करें।

ज़रूरी: यह Private Integration Token ही होना चाहिए।

Token pit- से शुरू होता है। सामान्य API key या पुरानी v1 API key काम नहीं करती और 401 errors की सबसे बड़ी वजह यही है। Token सिर्फ़ एक बार दिखता है, इसलिए स्क्रीन बंद करने से पहले उसे किसी सुरक्षित जगह कॉपी कर लें।

scopes का एक समझदार न्यूनतम सेट

ज़्यादातर एजेंसी के काम के लिए read-only से शुरू करें और write scopes सिर्फ़ वहाँ जोड़ें जहाँ AI से बदलाव करवाने हैं। सुरक्षित शुरुआत यह है: contacts, conversations और opportunities का read access। सेटअप पर भरोसा बन जाए तो contacts और opportunities का write access जोड़ें। Delete scopes तब तक बंद रखें जब तक कोई साफ़ वजह न हो, क्योंकि कुछ scopes AI को डेटा हटाने देते हैं।

Step 2: अपनी Location ID ढूँढें

Location ID उस sub-account का नाम बताती है जिसमें AI काम करता है। इसे ढूँढने के दो तरीके:

• ऐप में: Settings, फिर Company, फिर Locations पर जाएँ और जिस अकाउंट की चाहिए उसकी ID कॉपी करें।
• URL से: sub-account खोलें और address bar से ID पढ़ें। यह /location/ के बाद की लंबी string है।

आधिकारिक docs का एक नोट: locationId header वैकल्पिक है। आप उसे नीचे दिखाए तरीके से header में दे सकते हैं, या छोड़कर अपने prompts में location का नाम बता सकते हैं। अगर आप सिर्फ़ एक अकाउंट में काम करते हैं तो header में सेट करना आसान है।

Step 3: अपना AI टूल जोड़ें

ज़्यादातर आधुनिक AI टूल्स HTTP पर MCP बोलते हैं, इसलिए config हर जगह एक ही शक्ल का है: endpoint, आपके token वाला Authorization header, और वैकल्पिक Location ID header। नीचे Cursor, Windsurf और OpenAI Playground में इस्तेमाल होने वाला base config है।

Base HTTP config (Cursor, Windsurf, OpenAI Playground)

{
  "mcpServers": {
    "ghl": {
      "url": "https://services.leadconnectorhq.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_PIT_TOKEN",
        "locationId": "YOUR_LOCATION_ID"
      }
    }
  }
}

Claude Code

Claude Code अपना MCP config ~/.claude.json में रखता है। ऊपर वाला ghl block mcpServers के नीचे जोड़ें, या claude mcp add चलाकर पूछे जाने पर endpoint और headers पेस्ट करें। Claude Code रीस्टार्ट करें, फिर /mcp टाइप करके देखें कि GoHighLevel के tools सूची में हैं।

Claude Desktop

Claude Desktop अभी सीधे HTTP पर नहीं जुड़ता, इसलिए वह mcp-remote npx wrapper इस्तेमाल करता है, जो HTTP server को उस लोकल कनेक्शन से जोड़ता है जो Claude Desktop को चाहिए। इसे अपने Claude Desktop config में डालें, फिर ऐप रीस्टार्ट करें। सेटअप करते समय आधिकारिक docs में मौजूदा तरीका जाँच लें, क्योंकि यही हिस्सा सबसे ज़्यादा बदल सकता है।

Claude Desktop config (mcp-remote wrapper)

{
  "mcpServers": {
    "ghl": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://services.leadconnectorhq.com/mcp/",
        "--header",
        "Authorization: Bearer YOUR_PIT_TOKEN",
        "--header",
        "locationId: YOUR_LOCATION_ID"
      ]
    }
  }
}

Cursor और Windsurf

दोनों सीधे HTTP पर जुड़ते हैं। MCP settings खोलें, इस हिस्से की शुरुआत वाला base config जोड़ें और सेव करें। Editor रीलोड होने पर GoHighLevel के tools सूची में दिखने लगते हैं। अगर कुछ न दिखे, तो दोबारा जाँचें कि token pit- से शुरू होता है।

Gemini CLI

वही server block अपनी Gemini CLI settings फ़ाइल में उसके MCP servers वाले हिस्से के नीचे जोड़ें, endpoint और Authorization header के साथ। CLI रीस्टार्ट करें और उसका MCP list command चलाकर कनेक्शन जाँचें। Gemini इकलौता AI crawler भी है जो JavaScript रेंडर करता है, लेकिन इस MCP कनेक्शन से उसका कोई लेना देना नहीं है।

OpenAI Playground

Playground में एक remote MCP server जोड़ें, endpoint पेस्ट करें, और Authorization header को Bearer YOUR_PIT_TOKEN पर सेट करें। सेव करने पर उस session में GoHighLevel के tools मॉडल को मिल जाते हैं।

n8n से जोड़ें

n8n बिना किसी custom plugin के जुड़ जाता है। अपने workflow में MCP Client node जोड़ें, URL को https://services.leadconnectorhq.com/mcp/ पर सेट करें, HTTP Streamable transport चुनें, और अपने pit- token के साथ header-based auth इस्तेमाल करें। आपको n8n का नया version चाहिए (लिखते समय 1.104 या उससे नया)। अगर Streamable transport का विकल्प न दिखे, तो पहले n8n अपडेट करें।

इसके बाद GoHighLevel के tools आपके workflow के किसी भी AI agent node को मिल जाते हैं, इसलिए आप GoHighLevel की actions को n8n से जुड़ने वाले सैकड़ों दूसरे ऐप्स के साथ जोड़ सकते हैं।

डेवलपर्स के लिए

अगर आप अपना agent बना रहे हैं, तो आधिकारिक docs में Python में LangChain और LangGraph का उदाहरण है। MCP adapter GoHighLevel के सारे tools लोड करता है, और आपका agent उन्हें किसी भी दूसरे tool की तरह बुला सकता है। इसका ढाँचा यह है।

Python: GoHighLevel MCP server के साथ LangGraph agent

# pip install langchain-mcp-adapters langgraph langchain-openai
import asyncio
from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent

async def main():
    client = MultiServerMCPClient({
        "ghl": {
            "url": "https://services.leadconnectorhq.com/mcp/",
            "transport": "streamable_http",
            "headers": {
                "Authorization": "Bearer YOUR_PIT_TOKEN",
                "locationId": "YOUR_LOCATION_ID",
            },
        }
    })
    tools = await client.get_tools()
    agent = create_react_agent("openai:gpt-4.1", tools)
    result = await agent.ainvoke(
        {"messages": "List my 5 most recent contacts"}
    )
    print(result["messages"][-1].content)

asyncio.run(main())

यही adapter Node और दूसरे LangChain runtimes से भी चलता है। अगर आप ऐसा custom server बनाना चाहते हैं जो GoHighLevel के वे endpoints लपेटे जो official server अभी कवर नहीं करता, तो हमारी build-your-own MCP server recipe देखें।

Official server बनाम community servers

GoHighLevel का official server शुरू करने की सही जगह है। कम्युनिटी ने GitHub पर open-source MCP servers भी बनाए हैं, जो API का ज़्यादा हिस्सा लपेटकर कहीं ज़्यादा tools देते हैं। वे अनऑफ़िशियल हैं, उन्हें सपोर्ट नहीं मिलता, और उन्हें आप खुद host करते हैं। यह ईमानदार तुलना है।

मोटा नियम: official से शुरू करें। Community server तब लें जब असली कमी मिले, और समझ लें कि उसे चलाने की hosting और सुरक्षा आपकी ज़िम्मेदारी बन जाती है।

बिल्ट-इन Ask AI बनाम बाहरी MCP server

GoHighLevel के ऐप में Ask AI है। dashboard में काम करते हुए जल्दी मदद के लिए वह बढ़िया है। MCP server अलग चीज़ है: वह आपके अपने AI टूल्स को बाहर से अकाउंट तक पहुँचने देता है। ऐप के अंदर के सवालों के लिए Ask AI इस्तेमाल करें। जब आप चाहें कि GoHighLevel आपके नियंत्रण वाले बड़े AI workflow का एक कदम बने, दूसरे टूल्स के साथ जुड़ा हुआ, तब MCP server इस्तेमाल करें।

असली उदाहरण prompts

जुड़ जाने के बाद आप अपने अकाउंट से आसान भाषा में बात करते हैं। ये पाँच prompts एजेंसी का असली काम करते हैं।

1. Hot leads ढूँढें और follow-up ड्राफ़्ट करें. "पिछले 7 दिनों में जिन contacts ने जवाब दिया लेकिन कोई appointment बुक नहीं है, उन्हें ढूँढो और हर एक के लिए छोटा follow-up संदेश ड्राफ़्ट करो।" अच्छा नतीजा एक छोटी सूची है, हर lead के लिए अलग संदेश के साथ, जो आपके भेजने के लिए तैयार हो।
2. Opportunity बनाएँ. "Jane Doe के लिए Sales pipeline में Proposal stage पर 2,500 डॉलर की नई opportunity बनाओ।" यह सही stage और value के साथ नई opportunity लौटाता है।
3. एक हफ़्ते की बातचीत का सारांश. "इस हफ़्ते की सारी बातचीत का सारांश दो और जो नाराज़ लगे उसे चिह्नित करो।" आपको एक digest और जोखिम वाले लोगों की छोटी सूची मिलती है।
4. Tag की सफ़ाई. "trial-expired tag वाले हर contact की सूची दो और बताओ किनकी opportunity अब भी खुली है।" दोबारा जोड़ने की मुहिम से पहले काम की चीज़।
5. कॉल की तैयारी. "इस ईमेल वाले contact का पूरा इतिहास निकालो और मेरी कॉल से पहले 3 लाइन का ब्रीफ़ दो।" यह contact, conversations और opportunities पढ़ता है और सारांश थमा देता है।

कई sub-accounts वाली एजेंसियों के लिए

यह एजेंसियों का सबसे आम सवाल है। हर client sub-account के लिए एक Private Integration Token इस्तेमाल करें। हर token एक ही location से बँधा है, इसलिए हर client का अलग token उसका डेटा पूरी तरह अलग रखता है और एक client को हटाने पर बाकी पर असर नहीं पड़ता।

हर token का नाम client के नाम पर रखें ताकि कभी गड़बड़ न हो। किसी खास client के लिए AI टूल जोड़ें, तो उसी client का token और Location ID इस्तेमाल करें। अगर client चला जाए, तो उसका token revoke कर दें और access खत्म। एक token को कई clients में शेयर करने से यह अलगाव टूट जाता है, इससे बचें।

MCP server इस्तेमाल करने के लिए आपको GoHighLevel अकाउंट चाहिए। हमारे लिंक से 30 दिन का ट्रायल शुरू करें।

सुरक्षा और token rotation

डर असली है: लोगों को चिंता होती है कि AI contacts डिलीट कर देगा या client का अकाउंट बिगाड़ देगा। इसका हल भरोसा नहीं, access control है। AI वही कर सकता है जो आपके token के scopes अनुमति देते हैं।

• कम से कम access दें. सिर्फ़ ज़रूरी scopes चुनें। Delete scopes तब तक बंद रखें जब तक सच में न चाहिए। Read-only tokens कुछ नहीं बदल सकते।
• हर 90 दिन में rotate करें. नया token बनाएँ, config अपडेट करें, कनेक्शन जाँचें, फिर पुराना छोड़ दें। Rotate विकल्प बदलाव के दौरान पुराने token को 7 दिन चालू रखता है, ताकि कुछ न टूटे।
• हर client के लिए एक token. अलग tokens का मतलब है कि एक revoke से एक client का access साफ़ तरीके से हट जाता है।
• लीक होने पर revoke करें. अगर token कभी लीक हो, तो अगले rotation का इंतज़ार किए बिना तुरंत revoke करें।

ध्यान दें कि पुरानी v1 API keys अब बंद की जा रही हैं (deprecated), और इसीलिए अब Private Integration Token ही ज़रूरी रास्ता है।

MCP बनाम Zapier

ये अलग समस्याएँ हल करते हैं। Zapier जैसे टूल तय और trigger वाले ऑटोमेशन के लिए सबसे अच्छे हैं: जब X हो, तो Y करो। MCP server खुले AI काम के लिए बेहतर है, जहाँ असिस्टेंट आपके कहे के आधार पर खुद तय करता है कि कौन सी actions लेनी हैं। कई लोग दोनों इस्तेमाल करते हैं: पहले से तय pipes के लिए Zapier, AI वाले कामों के लिए MCP।

अगर आप खास तौर पर ऑटोमेशन के लिए Zapier, Make, n8n और सीधी API में से चुन रहे हैं, तो वह फ़ैसला हमने Zapier vs Make vs n8n vs direct API recipe में विस्तार से समझाया है।

समस्या निवारण

• गलत key के प्रकार से 401. Token pit- से शुरू होना चाहिए। सामान्य या पुरानी API key से 401 आता है। Private Integrations में token दोबारा बनाएँ।
• Deprecated v1 key. पुरानी v1 API keys अब MCP के साथ काम नहीं करतीं। Private Integration Token पर जाएँ।
• Location ID गायब या गलत. अगर actions गलत अकाउंट पर लगें या फ़ेल हों, तो locationId header जाँचें या अपने prompt में location का नाम बताएँ।
• Rate limits. एक साथ बहुत ज़्यादा अनुरोध limits छू सकते हैं। बार बार के calls धीमे करें या काम को batch में बाँटें।
• पुराना session. अगर tools जवाब देना बंद कर दें, तो session साफ़ करने और दोबारा जुड़ने के लिए अपना AI टूल रीस्टार्ट करें।

RocketLauncher से और

• GoHighLevel Voice AI