GoHighLevel

Integre o GoHighLevel com assistentes de IA como Claude e ChatGPT usando uma chave de API privada.

GitHub
8
Experimente este MCPPatrocinado

Documentação

🚀 Servidor MCP GoHighLevel

🚨 IMPORTANTE: AVISO DE PROJETO FUNDACIONAL

⚠️ Este é um projeto fundacional de NÍVEL BASE projetado para conectar a comunidade GoHighLevel com automação de IA através do MCP (Model Context Protocol).

🎯 O Que Este Projeto É:

  • Camada de Fundação: Fornece acesso a TODOS os endpoints da API GoHighLevel de nível de subconta via MCP
  • Início Comunitário: Construído para mover a comunidade adiante juntos, mais rápido
  • Arquitetura Aberta: O cliente de API e os tipos podem ser modularizados e segmentados conforme necessário
  • Recurso Educacional: Aprenda como integrar GoHighLevel com sistemas de IA

⚠️ Considerações Críticas de Segurança de IA:

  • Sistemas de Memória/Recall: Se você não implementar mecanismos adequados de memória ou recall, a IA pode executar ações não intencionais
  • Limitação de Taxa: Monitore o uso da API para evitar atingir os limites de taxa do GoHighLevel
  • Controles de Permissão: Entenda que isso fornece ACESSO TOTAL às APIs da sua subconta
  • Segurança de Dados: Todas as ações são executadas com suas credenciais de API - garanta práticas adequadas de segurança

🎯 Uso Pretendido:

  • Uso Pessoal/Empresarial: Integre suas próprias contas GoHighLevel com IA
  • Base de Desenvolvimento: Construa sobre esta fundação para soluções personalizadas
  • Aprendizado e Experimentação: Entenda os padrões da API GoHighLevel
  • Contribuição Comunitária: Ajude a melhorar e estender esta fundação

🚫 NÃO Destinado Para:

  • Revenda Direta: Este é um software comunitário disponível gratuitamente
  • Produção Sem Testes: Sempre teste minuciosamente em ambientes de desenvolvimento
  • Uso de IA Não Monitorado: Implemente salvaguardas e monitoramento adequados

🔑 CRÍTICO: Configuração da API GoHighLevel

📋 Necessário: Chave de API de Integrações Privadas

⚠️ Este projeto requer uma chave de API de INTEGRAÇÕES PRIVADAS, não uma chave de API regular!

Como obter sua Chave de API de Integrações Privadas:

  1. Faça login na sua conta GoHighLevel

  2. Navegue até Configurações → Integrações → Integrações Privadas

  3. Crie Nova Integração Privada:

    • Nome: MCP Server Integration (ou o nome de sua preferência)
    • URL de Webhook: Deixe em branco (não é necessário)

  4. Selecione os Escopos Necessários com base nas ferramentas que você usará:

    • ✅ contacts.readonly - Visualizar contatos
    • ✅ contacts.write - Criar/atualizar contatos
    • ✅ conversations.readonly - Visualizar conversas
    • ✅ conversations.write - Enviar mensagens
    • ✅ opportunities.readonly - Visualizar oportunidades
    • ✅ opportunities.write - Gerenciar oportunidades
    • ✅ calendars.readonly - Visualizar calendários/compromissos
    • ✅ calendars.write - Criar/gerenciar compromissos
    • ✅ locations.readonly - Visualizar dados de localização
    • ✅ locations.write - Gerenciar configurações de localização
    • ✅ workflows.readonly - Visualizar fluxos de trabalho
    • ✅ campaigns.readonly - Visualizar campanhas
    • ✅ blogs.readonly - Visualizar conteúdo de blog
    • ✅ blogs.write - Criar/gerenciar postagens de blog
    • ✅ users.readonly - Visualizar informações de usuário
    • ✅ custom_objects.readonly - Visualizar objetos personalizados
    • ✅ custom_objects.write - Gerenciar objetos personalizados
    • ✅ invoices.readonly - Visualizar faturas
    • ✅ invoices.write - Criar/gerenciar faturas
    • ✅ payments.readonly - Visualizar dados de pagamento
    • ✅ products.readonly - Visualizar produtos
    • ✅ products.write - Gerenciar produtos

  5. Salve a Integração e copie a Chave de API Privada gerada

  6. Copie seu ID de Localização de Configurações → Empresa → Localizações

💡 Dica: Você sempre pode adicionar mais escopos posteriormente editando sua Integração Privada se precisar de funcionalidade adicional.

Este projeto consumiu bastante tempo, mas senti que era importante. Sinta-se à vontade para doar - tudo será destinado ao avanço deste Projeto -> Visando "Operações Orientadas por Agentes" em Massa para Agências.

Deploy with Vercel Deploy on Railway Donate to the Project

🔥 Transforme o Claude Desktop em uma central completa de CRM GoHighLevel com mais de 269 ferramentas poderosas em mais de 19 categorias

🎯 O Que Isso Faz

Este servidor MCP (Model Context Protocol) abrangente conecta o Claude Desktop diretamente à sua conta GoHighLevel, fornecendo capacidades de automação sem precedentes:

  • 👥 Gerenciamento Completo de Contatos: 31 ferramentas para contatos, tarefas, notas e relacionamentos
  • 💬 Mensagens Avançadas: 20 ferramentas para SMS, e-mail, conversas e gravações de chamadas
  • 🏢 Operações de Negócios: Gerenciamento de localização, objetos personalizados, fluxos de trabalho e pesquisas
  • 💰 Vendas e Receita: Oportunidades, pagamentos, faturas, orçamentos e automação de cobrança
  • 📱 Automação de Marketing: Mídias sociais, campanhas de e-mail, gerenciamento de blog e biblioteca de mídia
  • 🛒 E-commerce: Gerenciamento de loja, produtos, inventário, envio e atendimento de pedidos

⚡ Opções de Implantação Rápida

🟢 Vercel (Recomendado)

Deploy with Vercel

Por que Vercel:

  • ✅ Nível gratuito com limites generosos
  • ✅ HTTPS automático e CDN global
  • ✅ Implantação sem configuração
  • ✅ Perfeito para servidores MCP

🚂 Railway

Deploy on Railway

Por que Railway:

  • ✅ $5 de crédito mensal gratuito
  • ✅ Implantação simples com um clique
  • ✅ Escalonamento automático
  • ✅ Ótimo para cargas de trabalho de produção

🎨 Render

  • ✅ Nível gratuito disponível
  • ✅ Implantação automática a partir do GitHub
  • ✅ SSL integrado

🌟 Catálogo Completo de Ferramentas (269 Ferramentas)

🎯 Gerenciamento de Contatos (31 Ferramentas)

Operações Principais:

  • create_contact, search_contacts, get_contact, update_contact, delete_contact
  • add_contact_tags, remove_contact_tags - Organize com tags

Gerenciamento de Tarefas e Notas:

  • get_contact_tasks, create_contact_task, update_contact_task, delete_contact_task
  • get_contact_notes, create_contact_note, update_contact_note, delete_contact_note

Recursos Avançados:

  • upsert_contact - Criação/atualização inteligente
  • get_duplicate_contact - Detecção de duplicatas
  • bulk_update_contact_tags - Operações de tags em massa
  • add_contact_to_workflow, remove_contact_from_workflow - Automação de fluxo de trabalho
  • add_contact_followers, remove_contact_followers - Colaboração em equipe

💬 Mensagens e Conversas (20 Ferramentas)

Comunicação Direta:

  • send_sms, send_email - Envie mensagens com formatação rica
  • search_conversations, get_conversation, create_conversation

Gerenciamento de Mensagens:

  • get_message, get_email_message, upload_message_attachments
  • update_message_status, cancel_scheduled_message

Recursos de Chamadas:

  • get_message_recording, get_message_transcription, download_transcription
  • add_inbound_message, add_outbound_call - Registro manual

Chat ao Vivo:

  • live_chat_typing - Indicadores de digitação em tempo real

📝 Gerenciamento de Blog (7 Ferramentas)

  • create_blog_post, update_blog_post - Criação de conteúdo com SEO
  • get_blog_posts, get_blog_sites - Descoberta de conteúdo
  • get_blog_authors, get_blog_categories - Organização
  • check_url_slug - Validação de SEO

💰 Gerenciamento de Oportunidades (10 Ferramentas)

  • search_opportunities - Filtragem avançada por funil, etapa, contato
  • get_pipelines - Gerenciamento de funil de vendas
  • create_opportunity, update_opportunity, delete_opportunity
  • update_opportunity_status - Atualizações rápidas de ganho/perda
  • upsert_opportunity - Gerenciamento inteligente de funil
  • add_opportunity_followers, remove_opportunity_followers

🗓️ Calendário e Compromissos (14 Ferramentas)

Gerenciamento de Calendário:

  • get_calendar_groups, get_calendars, create_calendar
  • update_calendar, delete_calendar

Agendamento de Compromissos:

  • get_calendar_events, get_free_slots - Verificação de disponibilidade
  • create_appointment, get_appointment, update_appointment, delete_appointment

Controle de Agenda:

  • create_block_slot, update_block_slot - Bloqueio de horários

📧 Marketing por E-mail (5 Ferramentas)

  • get_email_campaigns - Gerenciamento de campanhas
  • create_email_template, get_email_templates - Sistema de modelos
  • update_email_template, delete_email_template

🏢 Gerenciamento de Localização (24 Ferramentas)

Gerenciamento de Subcontas:

  • search_locations, get_location, create_location, update_location, delete_location

Sistema de Tags:

  • get_location_tags, create_location_tag, update_location_tag, delete_location_tag

Campos Personalizados e Valores:

  • get_location_custom_fields, create_location_custom_field, update_location_custom_field
  • get_location_custom_values, create_location_custom_value, update_location_custom_value

Modelos e Configurações:

  • get_location_templates, delete_location_template, get_timezones

✅ Verificação de E-mail (1 Ferramenta)

  • verify_email - Avaliação de entregabilidade e risco

📱 Gerenciamento de Mídias Sociais (17 Ferramentas)

Gerenciamento de Postagens:

  • search_social_posts, create_social_post, get_social_post
  • update_social_post, delete_social_post, bulk_delete_social_posts

Integração de Contas:

  • get_social_accounts, delete_social_account, start_social_oauth

Operações em Massa:

  • upload_social_csv, get_csv_upload_status, set_csv_accounts

Organização:

  • get_social_categories, get_social_tags, get_social_tags_by_ids

Plataformas: Google Business, Facebook, Instagram, LinkedIn, Twitter, TikTok

📁 Biblioteca de Mídia (3 Ferramentas)

  • get_media_files - Pesquisar e filtrar mídia
  • upload_media_file - Uploads de arquivos e URLs hospedadas
  • delete_media_file - Limpar ativos de mídia

🏗️ Objetos Personalizados (9 Ferramentas)

Gerenciamento de Esquema:

  • get_all_objects, create_object_schema, get_object_schema, update_object_schema

Operações de Registro:

  • create_object_record, get_object_record, update_object_record, delete_object_record

Pesquisa Avançada:

  • search_object_records - Consultar dados personalizados

Casos de Uso: Registros de animais de estimação, tickets de suporte, inventário, dados comerciais personalizados

🔗 Gerenciamento de Associações (10 Ferramentas)

  • ghl_get_all_associations, ghl_create_association, ghl_get_association_by_id
  • ghl_update_association, ghl_delete_association
  • ghl_create_relation, ghl_get_relations_by_record, ghl_delete_relation
  • Mapeamento avançado de relacionamentos entre objetos

🎛️ Campos Personalizados V2 (8 Ferramentas)

  • ghl_get_custom_field_by_id, ghl_create_custom_field, ghl_update_custom_field
  • ghl_delete_custom_field, ghl_get_custom_fields_by_object_key
  • ghl_create_custom_field_folder, ghl_update_custom_field_folder, ghl_delete_custom_field_folder

⚡ Gerenciamento de Fluxo de Trabalho (1 Ferramenta)

  • ghl_get_workflows - Descoberta de fluxos de trabalho de automação

📊 Gerenciamento de Pesquisas (2 Ferramentas)

  • ghl_get_surveys - Gerenciamento de pesquisas
  • ghl_get_survey_submissions - Análise de respostas

🛒 Gerenciamento de Loja (18 Ferramentas)

Zonas de Envio:

  • ghl_create_shipping_zone, ghl_list_shipping_zones, ghl_get_shipping_zone
  • ghl_update_shipping_zone, ghl_delete_shipping_zone

Taxas de Envio:

  • ghl_get_available_shipping_rates, ghl_create_shipping_rate, ghl_list_shipping_rates
  • ghl_get_shipping_rate, ghl_update_shipping_rate, ghl_delete_shipping_rate

Transportadoras e Configurações:

  • ghl_create_shipping_carrier, ghl_list_shipping_carriers, ghl_update_shipping_carrier
  • ghl_create_store_setting, ghl_get_store_setting

📦 Gerenciamento de Produtos (10 Ferramentas)

Operações de Produto:

  • ghl_create_product, ghl_list_products, ghl_get_product
  • ghl_update_product, ghl_delete_product

Precificação e Inventário:

  • ghl_create_price, ghl_list_prices, ghl_list_inventory

Coleções:

  • ghl_create_product_collection, ghl_list_product_collections

💳 Gerenciamento de Pagamentos (20 Ferramentas)

Provedores de Integração:

  • create_whitelabel_integration_provider, list_whitelabel_integration_providers

Gerenciamento de Pedidos:

  • list_orders, get_order_by_id, create_order_fulfillment, list_order_fulfillments

Rastreamento de Transações:

  • list_transactions, get_transaction_by_id

Gerenciamento de Assinaturas:

  • list_subscriptions, get_subscription_by_id

Sistema de Cupons:

  • list_coupons, create_coupon, update_coupon, delete_coupon, get_coupon

Gateways de Pagamento Personalizados:

  • create_custom_provider_integration, delete_custom_provider_integration
  • get_custom_provider_config, create_custom_provider_config

🧾 Faturas e Cobrança (39 Ferramentas)

Modelos de Fatura:

  • create_invoice_template, list_invoice_templates, get_invoice_template
  • update_invoice_template, delete_invoice_template
  • update_invoice_template_late_fees, update_invoice_template_payment_methods

Faturas Recorrentes:

  • create_invoice_schedule, list_invoice_schedules, get_invoice_schedule
  • update_invoice_schedule, delete_invoice_schedule, schedule_invoice_schedule
  • auto_payment_invoice_schedule, cancel_invoice_schedule

Gerenciamento de Faturas:

  • create_invoice, list_invoices, get_invoice, update_invoice
  • delete_invoice, void_invoice, send_invoice, record_invoice_payment
  • generate_invoice_number, text2pay_invoice

Orçamentos:

  • create_estimate, list_estimates, update_estimate, delete_estimate
  • send_estimate, create_invoice_from_estimate, generate_estimate_number Modelos de Estimativas:
  • list_estimate_templates, create_estimate_template, update_estimate_template
  • delete_estimate_template, preview_estimate_template

🎮 Exemplos de Uso no Claude Desktop

📞 Fluxo de Comunicação com o Cliente

"Search for contacts tagged 'VIP' who haven't been contacted in 30 days, then send them a personalized SMS about our new premium service offering"

💰 Gerenciamento do Funil de Vendas

"Create an opportunity for contact John Smith for our Premium Package worth $5000, add it to the 'Enterprise Sales' pipeline, and schedule a follow-up appointment for next Tuesday"

📊 Inteligência de Negócios

"Get all invoices from the last quarter, analyze payment patterns, and create a report of our top-paying customers with their lifetime value"

🛒 Operações de E-commerce

"List all products with low inventory, create a restock notification campaign, and send it to contacts tagged 'inventory-manager'"

📱 Automação de Mídias Sociais

"Create a social media post announcing our Black Friday sale, schedule it for all connected platforms, and track engagement metrics"

🎯 Automação de Marketing

"Find all contacts who opened our last email campaign but didn't purchase, add them to the 'warm-leads' workflow, and schedule a follow-up sequence"

🔧 Desenvolvimento Local

Pré-requisitos

  • Node.js 18+ (última versão LTS recomendada)
  • Conta GoHighLevel com acesso à API
  • Chave de API válida e ID de Localização
  • Claude Desktop (para integração com MCP)

Instalação e Configuração

# Clone the repository
git clone https://github.com/mastanley13/GoHighLevel-MCP.git
cd GoHighLevel-MCP

# Install dependencies
npm install

# Create environment file
cp .env.example .env
# Configure your GHL credentials in .env

# Build the project
npm run build

# Start the server
npm start

# For development with hot reload
npm run dev

Configuração de Ambiente

# Required Environment Variables
GHL_API_KEY=your_private_integrations_api_key_here  # From Private Integrations, NOT regular API key
GHL_BASE_URL=https://services.leadconnectorhq.com
GHL_LOCATION_ID=your_location_id_here              # From Settings → Company → Locations
NODE_ENV=production

# Optional Configuration
PORT=8000
CORS_ORIGINS=*
LOG_LEVEL=info

Scripts Disponíveis

npm run build          # TypeScript compilation
npm run dev            # Development server with hot reload
npm start              # Production HTTP server
npm run start:stdio    # CLI MCP server for Claude Desktop
npm run start:http     # HTTP MCP server for web apps
npm test               # Run test suite
npm run test:watch     # Watch mode testing
npm run test:coverage  # Coverage reports
npm run lint           # TypeScript linting

Testes e Validação

# Test API connectivity
curl http://localhost:8000/health

# List available tools
curl http://localhost:8000/tools

# Test MCP SSE endpoint
curl -H "Accept: text/event-stream" http://localhost:8000/sse

🌐 Guia de Implantação

🟢 Implantação na Vercel (Recomendado)

Opção 1: Implantação com Um Clique Deploy with Vercel

Opção 2: Implantação Manual

# Install Vercel CLI
npm i -g vercel

# Deploy
vercel --prod

# Configure environment variables in Vercel dashboard
# Add: GHL_API_KEY, GHL_BASE_URL, GHL_LOCATION_ID, NODE_ENV

Configuração da Vercel (vercel.json):

{
  "version": 2,
  "builds": [
    {
      "src": "dist/http-server.js",
      "use": "@vercel/node"
    }
  ],
  "routes": [
    {
      "src": "/(.*)",
      "dest": "/dist/http-server.js"
    }
  ]
}

🚂 Implantação na Railway

# Install Railway CLI
npm install -g @railway/cli

# Login and deploy
railway login
railway init
railway up

# Add environment variables via Railway dashboard

🎨 Implantação na Render

  1. Conecte seu repositório do GitHub
  2. Configure o comando de build: npm run build
  3. Configure o comando de inicialização: npm start
  4. Adicione as variáveis de ambiente no painel da Render

🐳 Implantação com Docker

# Build image
docker build -t ghl-mcp-server .

# Run container
docker run -p 8000:8000 \
  -e GHL_API_KEY=your_key \
  -e GHL_BASE_URL=https://services.leadconnectorhq.com \
  -e GHL_LOCATION_ID=your_location_id \
  ghl-mcp-server

🔌 Integração com o Claude Desktop

Configuração do MCP

Adicione ao seu mcp_settings.json do Claude Desktop:

{
  "mcpServers": {
    "ghl-mcp-server": {
      "command": "node",
      "args": ["path/to/ghl-mcp-server/dist/server.js"],
      "env": {
        "GHL_API_KEY": "your_private_integrations_api_key",
        "GHL_BASE_URL": "https://services.leadconnectorhq.com",
        "GHL_LOCATION_ID": "your_location_id"
      }
    }
  }
}

Integração MCP via HTTP

Para clientes MCP baseados na web, use o endpoint HTTP:

https://your-deployment-url.vercel.app/sse

📋 Arquitetura do Projeto

ghl-mcp-server/
├── 📁 src/                    # Source code
│   ├── 📁 clients/            # API client implementations
│   │   └── ghl-api-client.ts  # Core GHL API client
│   ├── 📁 tools/              # MCP tool implementations
│   │   ├── contact-tools.ts   # Contact management (31 tools)
│   │   ├── conversation-tools.ts # Messaging (20 tools)
│   │   ├── blog-tools.ts      # Blog management (7 tools)
│   │   ├── opportunity-tools.ts # Sales pipeline (10 tools)
│   │   ├── calendar-tools.ts  # Appointments (14 tools)
│   │   ├── email-tools.ts     # Email marketing (5 tools)
│   │   ├── location-tools.ts  # Location management (24 tools)
│   │   ├── email-isv-tools.ts # Email verification (1 tool)
│   │   ├── social-media-tools.ts # Social media (17 tools)
│   │   ├── media-tools.ts     # Media library (3 tools)
│   │   ├── object-tools.ts    # Custom objects (9 tools)
│   │   ├── association-tools.ts # Associations (10 tools)
│   │   ├── custom-field-v2-tools.ts # Custom fields (8 tools)
│   │   ├── workflow-tools.ts  # Workflows (1 tool)
│   │   ├── survey-tools.ts    # Surveys (2 tools)
│   │   ├── store-tools.ts     # Store management (18 tools)
│   │   ├── products-tools.ts  # Products (10 tools)
│   │   ├── payments-tools.ts  # Payments (20 tools)
│   │   └── invoices-tools.ts  # Invoices & billing (39 tools)
│   ├── 📁 types/              # TypeScript definitions
│   │   └── ghl-types.ts       # Comprehensive type definitions
│   ├── 📁 utils/              # Utility functions
│   ├── server.ts              # CLI MCP server (Claude Desktop)
│   └── http-server.ts         # HTTP MCP server (Web apps)
├── 📁 tests/                  # Comprehensive test suite
│   ├── 📁 clients/            # API client tests
│   ├── 📁 tools/              # Tool implementation tests
│   └── 📁 mocks/              # Test mocks and fixtures
├── 📁 api/                    # Vercel API routes
├── 📁 docker/                 # Docker configurations
├── 📁 dist/                   # Compiled JavaScript (auto-generated)
├── 📄 Documentation files
│   ├── DEPLOYMENT.md          # Deployment guides
│   ├── CLAUDE-DESKTOP-DEPLOYMENT-PLAN.md
│   ├── VERCEL-DEPLOYMENT.md
│   ├── CLOUD-DEPLOYMENT.md
│   └── PROJECT-COMPLETION.md
├── 📄 Configuration files
│   ├── package.json           # Dependencies and scripts
│   ├── tsconfig.json          # TypeScript configuration
│   ├── jest.config.js         # Testing configuration
│   ├── vercel.json            # Vercel deployment config
│   ├── railway.json           # Railway deployment config
│   ├── Dockerfile             # Docker containerization
│   ├── Procfile               # Process configuration
│   └── cursor-mcp-config.json # MCP configuration
└── 📄 README.md               # This comprehensive guide

🔐 Segurança e Boas Práticas

Segurança do Ambiente

  • ✅ Nunca envie chaves de API para o controle de versão
  • ✅ Use variáveis de ambiente para todos os dados sensíveis
  • ✅ Implemente políticas CORS adequadas
  • ✅ Faça rotação regular das chaves de API
  • ✅ Monitore o uso da API e os limites de taxa

Considerações de Produção

  • ✅ Implemente tratamento de erros e registro adequados
  • ✅ Configure monitoramento e alertas
  • ✅ Use HTTPS em todas as implantações
  • ✅ Implemente limite de taxa de requisições
  • ✅ Atualizações regulares de segurança

Limites de Taxa da API

  • A API do GoHighLevel possui limites de taxa
  • Implemente backoff exponencial
  • Armazene em cache dados solicitados com frequência
  • Use operações em lote quando disponíveis

🚨 Guia de Solução de Problemas

Problemas Comuns e Soluções

Falhas de Build:

# Clear cache and reinstall
rm -rf node_modules package-lock.json dist/
npm install
npm run build

Problemas de Conexão com a API:

# Test API connectivity (use your Private Integrations API key)
curl -H "Authorization: Bearer YOUR_PRIVATE_INTEGRATIONS_API_KEY" \
     https://services.leadconnectorhq.com/locations/YOUR_LOCATION_ID

Problemas Comuns de API:

  • ✅ Usar chave de API de Integrações Privadas (não a chave de API regular)
  • ✅ Escopos necessários habilitados na Integração Privada
  • ✅ ID de Localização corresponde à sua conta GHL
  • ✅ Variáveis de ambiente configuradas corretamente

Integração com o Claude Desktop:

  1. Verifique a sintaxe da configuração do MCP
  2. Confira se os caminhos de arquivo são absolutos
  3. Garanta que as variáveis de ambiente estejam definidas
  4. Reinicie o Claude Desktop após as alterações

Problemas de Memória:

# Increase Node.js memory limit
node --max-old-space-size=8192 dist/server.js

Erros de CORS:

  • Configure a variável de ambiente CORS_ORIGINS
  • Garanta cabeçalhos HTTP adequados
  • Verifique a lista de domínios permitidos

Otimização de Desempenho

  • Habilite cache de respostas para operações de leitura
  • Use paginação para grandes conjuntos de dados
  • Implemente pool de conexões
  • Monitore o uso de memória e otimize conforme necessário

📊 Especificações Técnicas

Requisitos do Sistema

  • Runtime: Node.js 18+ (última versão LTS recomendada)
  • Memória: Mínimo de 512MB de RAM, recomendado 1GB+
  • Armazenamento: 100MB para a aplicação, adicional para logs
  • Rede: Conexão estável com a internet para chamadas de API

Stack de Tecnologia

  • Backend: Node.js + TypeScript
  • Framework HTTP: Express.js 5.x
  • SDK MCP: @modelcontextprotocol/sdk ^1.12.1
  • Cliente HTTP: Axios ^1.9.0
  • Testes: Jest com suporte a TypeScript
  • Sistema de Build: Compilador TypeScript

Integração com a API

  • API do GoHighLevel: v2021-07-28 (Contatos), v2021-04-15 (Conversas)
  • Autenticação: Token Bearer
  • Limite de Taxa: Respeita os limites da API GHL
  • Tratamento de Erros: Recuperação abrangente de erros

Métricas de Desempenho

  • Inicialização a Frio: < 2 segundos
  • Resposta da API: < 500ms em média
  • Uso de Memória: ~50-100MB base
  • Execução de Ferramentas: < 1 segundo em média

🤝 Contribuições

Aceitamos contribuições da comunidade GoHighLevel!

Fluxo de Desenvolvimento

# Fork and clone the repository
git clone https://github.com/your-fork/GoHighLevel-MCP.git

# Create feature branch
git checkout -b feature/amazing-new-tool

# Make your changes with tests
npm test

# Commit and push
git commit -m "Add amazing new tool for [specific functionality]"
git push origin feature/amazing-new-tool

# Open Pull Request with detailed description

Diretrizes de Contribuição

  • ✅ Adicione testes abrangentes para novas ferramentas
  • ✅ Siga as boas práticas do TypeScript
  • ✅ Atualize a documentação para novos recursos
  • ✅ Garanta que toda a verificação de lint seja aprovada
  • ✅ Inclua exemplos na descrição do PR

Padrões de Código

  • Use o modo estrito do TypeScript
  • Siga as convenções de nomenclatura existentes
  • Adicione comentários JSDoc para todos os métodos públicos
  • Implemente tratamento de erros adequado
  • Inclua testes de integração

📄 Licença

Este projeto está licenciado sob a Licença ISC - consulte o arquivo LICENSE para obter detalhes.

🆘 Comunidade e Suporte

Documentação

Obtendo Ajuda

Recursos da Comunidade

  • 💬 Junte-se à nossa comunidade no Discord
  • 📺 Inscreva-se no nosso canal do YouTube
  • 📰 Siga nosso blog de desenvolvimento
  • 🐦 Siga-nos no Twitter para atualizações

🎉 Métricas de Sucesso

Este servidor MCP abrangente oferece:

✅ 269 Ferramentas Operacionais em 19 categorias

✅ Integração em Tempo Real com GoHighLevel com cobertura completa da API

✅ Implantação Pronta para Produção em múltiplas plataformas

✅ Arquitetura de Nível Empresarial com tratamento abrangente de erros

✅ Suporte Completo a TypeScript com definições de tipos completas

✅ Cobertura Extensa de Testes garantindo confiabilidade

✅ Implantação Multiplataforma (Vercel, Railway, Render, Docker)

✅ Integração com Claude Desktop em conformidade com o protocolo MCP

✅ Desenvolvimento Orientado pela Comunidade com documentação abrangente

🚀 Pronto para revolucionar sua automação GoHighLevel?

Implante agora e desbloqueie todo o potencial do gerenciamento de CRM com IA!

Deploy with Vercel Deploy on Railway

💝 Apoie Este Projeto

Este projeto representa centenas de horas de trabalho de desenvolvimento para ajudar a comunidade GoHighLevel. Se ele está economizando seu tempo e ajudando seu negócio, considere apoiar seu desenvolvimento contínuo:

🎁 Formas de Apoiar:

  • ⭐ Dê uma estrela neste repositório - Ajuda outras pessoas a descobrirem o projeto
  • 🍕 Compre uma pizza para mim - Doe via Stripe
  • 🐛 Reporte bugs - Ajude a melhorá-lo para todos
  • 💡 Sugira recursos - Compartilhe suas ideias para melhorias
  • 🤝 Contribua com código - Pull requests são sempre bem-vindos!

🏆 Reconhecimento:

  • Contribuidores serão listados no projeto
  • Contribuições significativas podem receber reconhecimento especial
  • Este projeto é orientado e apoiado pela comunidade

Cada contribuição, grande ou pequena, ajuda a manter este projeto vivo e crescendo! 🚀

Feito com ❤️ para a comunidade GoHighLevel por desenvolvedores que entendem o poder da automação.