Skip to content

CLOUD-DEPLOYMENT.md

Latest commit

 

History

History
251 lines (182 loc) · 5.66 KB

CLOUD-DEPLOYMENT.md

File metadata and controls

251 lines (182 loc) · 5.66 KB
Raw

🚀 Cloud Deployment Guide - ChatGPT Integration

🎯 Overview

To connect your GoHighLevel MCP Server to ChatGPT, you need to deploy it to a publicly accessible URL. Here are the best options:

🌟 Option 1: Railway (Recommended - Free Tier)

Why Railway?

  • ✅ Free tier available
  • ✅ Automatic HTTPS
  • ✅ Easy GitHub integration
  • ✅ Fast deployment

Deployment Steps:

  1. Sign up at Railway.app

  2. Create New Project from GitHub:

    • Connect your GitHub account
    • Import this repository
    • Railway will auto-detect the Node.js app

  3. Set Environment Variables:

    GHL_API_KEY=your_api_key_here
GHL_BASE_URL=https://services.leadconnectorhq.com
GHL_LOCATION_ID=your_location_id_here
NODE_ENV=production
PORT=8000

  4. Deploy:

    • Railway will automatically build and deploy
    • You'll get a URL like: https://your-app-name.railway.app

  5. For ChatGPT Integration:

    MCP Server URL: https://your-app-name.railway.app/sse

🌟 Option 2: Render (Free Tier)

Deployment Steps:

  1. Sign up at Render.com

  2. Create Web Service:

    • Connect GitHub repository
    • Select "Web Service"
    • Runtime: Node

  3. Configuration:

    Build Command: npm run build
Start Command: npm start

  4. Environment Variables: (Same as above)

  5. For ChatGPT:

    MCP Server URL: https://your-app-name.onrender.com/sse

🌟 Option 3: Vercel (Free Tier)

Deploy with One Click:

  1. Click Deploy Button: Deploy with Vercel

  2. Add Environment Variables during setup

  3. For ChatGPT:

    MCP Server URL: https://your-app-name.vercel.app/sse

🌟 Option 4: Heroku (Paid)

Deployment Steps:

  1. Install Heroku CLI

  2. Deploy Commands:

    heroku create your-app-name
heroku config:set GHL_API_KEY=your_key_here
heroku config:set GHL_BASE_URL=https://services.leadconnectorhq.com
heroku config:set GHL_LOCATION_ID=your_location_id_here
heroku config:set NODE_ENV=production
git push heroku main

  3. For ChatGPT:

    MCP Server URL: https://your-app-name.herokuapp.com/sse

🎯 Quick Test Your Deployment

Once deployed, test these endpoints:

Health Check:

GET https://your-domain.com/health

Should return:

{
  "status": "healthy",
  "server": "ghl-mcp-server",
  "tools": { "total": 21 }
}

Tools List:

GET https://your-domain.com/tools

Should return all 21 MCP tools.

SSE Endpoint (for ChatGPT):

GET https://your-domain.com/sse

Should establish Server-Sent Events connection.

🔗 Connect to ChatGPT

Once your server is deployed:

  1. Open ChatGPT Desktop App

  2. Go to: Settings → Beta Features → Model Context Protocol

  3. Add New Connector:

    • Name: GoHighLevel MCP
    • Description: Connect to GoHighLevel CRM
    • MCP Server URL: https://your-domain.com/sse
    • Authentication: OAuth (or None if no auth needed)

  4. Save and Connect

Test the Connection:

Try asking ChatGPT:

"List all available GoHighLevel tools"
"Create a contact named Test User with email test@example.com"
"Show me recent conversations in GoHighLevel"

🚨 Troubleshooting

Common Issues:

  1. 502 Bad Gateway:

    • Check environment variables are set
    • Verify GHL API key is valid
    • Check server logs for errors

  2. CORS Errors:

    • Server includes CORS headers for ChatGPT
    • Ensure your domain is accessible

  3. Connection Timeout:

    • Free tier platforms may have cold starts
    • First request might be slow

  4. SSE Connection Issues:

    • Verify /sse endpoint is accessible
    • Check browser network tab for errors

Debug Commands:

# Check server status
curl https://your-domain.com/health

# Test tools endpoint
curl https://your-domain.com/tools

# Check SSE connection
curl -H "Accept: text/event-stream" https://your-domain.com/sse

🎉 Success Indicators

✅ Deployment Successful When:

  • Health check returns status: "healthy"
  • Tools endpoint shows 21 tools
  • SSE endpoint establishes connection
  • ChatGPT can discover and use tools

🎯 Ready for Production:

  • All environment variables configured
  • HTTPS enabled (automatic on most platforms)
  • Server responding to all endpoints
  • ChatGPT integration working

🔐 Security Notes

  • ✅ All platforms provide HTTPS automatically
  • ✅ Environment variables are encrypted
  • ✅ No sensitive data in code repository
  • ✅ CORS configured for ChatGPT domains only

💰 Cost Comparison

Platform Free Tier Paid Plans HTTPS Custom Domain
Railway 512MB RAM, $5 credit $5/month ✅ ✅
Render 512MB RAM $7/month ✅ ✅
Vercel Unlimited $20/month ✅ ✅
Heroku None $7/month ✅ ✅

Recommendation: Start with Railway's free tier!

🚀 Next Steps

  1. Choose a platform (Railway recommended)
  2. Deploy your server following the guide above
  3. Test the endpoints to verify everything works
  4. Connect to ChatGPT using your new server URL
  5. Start managing GoHighLevel through ChatGPT!

Your GoHighLevel MCP Server will be accessible at:

https://your-domain.com/sse

Ready to transform ChatGPT into your GoHighLevel control center! 🎯