GoHighLevel

Integra GoHighLevel con asistentes de IA como Claude y ChatGPT usando una clave de API privada.

Documentación

🚀 Servidor MCP de GoHighLevel

🚨 IMPORTANTE: AVISO DE PROYECTO FUNDACIONAL

⚠️ Este es un proyecto fundacional de NIVEL BASE diseñado para conectar a la comunidad de GoHighLevel con la automatización mediante IA a través de MCP (Model Context Protocol).

🎯 Qué es este proyecto:

Capa fundacional: Proporciona acceso a TODOS los endpoints de la API de GoHighLevel a nivel de subcuenta mediante MCP
Inicio comunitario: Creado para impulsar a la comunidad hacia adelante, juntos y más rápido
Arquitectura abierta: El cliente de API y los tipos pueden modularizarse y segmentarse aún más según sea necesario
Recurso educativo: Aprende a integrar GoHighLevel con sistemas de IA

⚠️ Consideraciones críticas de seguridad para IA:

Sistemas de memoria/recuperación: Si no implementas mecanismos adecuados de memoria o recuperación, la IA podría realizar acciones no deseadas
Límites de velocidad: Supervisa el uso de la API para evitar alcanzar los límites de velocidad de GoHighLevel
Controles de permisos: Comprende que esto proporciona acceso COMPLETO a las API de tu subcuenta
Seguridad de datos: Todas las acciones se realizan con tus credenciales de API: asegúrate de seguir prácticas de seguridad adecuadas

🎯 Uso previsto:

Uso personal/empresarial: Integra tus propias cuentas de GoHighLevel con IA
Base de desarrollo: Construye sobre esta base para soluciones personalizadas
Aprendizaje y experimentación: Comprende los patrones de la API de GoHighLevel
Contribución comunitaria: Ayuda a mejorar y ampliar esta base

🚫 NO está previsto para:

Reventa directa: Este es software comunitario de libre acceso
Producción sin pruebas: Prueba siempre a fondo en entornos de desarrollo
Uso de IA sin supervisión: Implementa salvaguardas y supervisión adecuadas

🔑 CRÍTICO: Configuración de la API de GoHighLevel

📋 Requisito: Clave de API de integraciones privadas

⚠️ Este proyecto requiere una clave de API de INTEGRACIONES PRIVADAS, ¡no una clave de API normal!

Cómo obtener tu clave de API de integraciones privadas:

Inicia sesión en tu cuenta de GoHighLevel
Navega a Configuración → Integraciones → Integraciones privadas
Crea una nueva integración privada:
- Nombre: MCP Server Integration (o el nombre que prefieras)
- URL de webhook: Déjala en blanco (no es necesaria)
Selecciona los alcances requeridos según las herramientas que vayas a usar:
- ✅ contacts.readonly - Ver contactos
- ✅ contacts.write - Crear/actualizar contactos
- ✅ conversations.readonly - Ver conversaciones
- ✅ conversations.write - Enviar mensajes
- ✅ opportunities.readonly - Ver oportunidades
- ✅ opportunities.write - Gestionar oportunidades
- ✅ calendars.readonly - Ver calendarios/citas
- ✅ calendars.write - Crear/gestionar citas
- ✅ locations.readonly - Ver datos de ubicación
- ✅ locations.write - Gestionar configuraciones de ubicación
- ✅ workflows.readonly - Ver flujos de trabajo
- ✅ campaigns.readonly - Ver campañas
- ✅ blogs.readonly - Ver contenido de blogs
- ✅ blogs.write - Crear/gestionar publicaciones de blog
- ✅ users.readonly - Ver información de usuarios
- ✅ custom_objects.readonly - Ver objetos personalizados
- ✅ custom_objects.write - Gestionar objetos personalizados
- ✅ invoices.readonly - Ver facturas
- ✅ invoices.write - Crear/gestionar facturas
- ✅ payments.readonly - Ver datos de pagos
- ✅ products.readonly - Ver productos
- ✅ products.write - Gestionar productos
Guarda la integración y copia la clave de API privada generada
Copia tu ID de ubicación desde Configuración → Empresa → Ubicaciones

💡 Consejo: Siempre puedes añadir más alcances más adelante editando tu integración privada si necesitas funcionalidad adicional.

Este proyecto requirió mucho tiempo, pero sentí que era importante. Siéntete libre de donar: todo se destinará a impulsar este proyecto, con el objetivo de lograr "Operaciones impulsadas por agentes" para agencias masivas.

🔥 Transforma Claude Desktop en un completo centro de CRM de GoHighLevel con más de 269 herramientas potentes en más de 19 categorías

🎯 Qué hace esto

Este completo servidor MCP (Model Context Protocol) conecta Claude Desktop directamente a tu cuenta de GoHighLevel, proporcionando capacidades de automatización sin precedentes:

👥 Gestión completa de contactos: 31 herramientas para contactos, tareas, notas y relaciones
💬 Mensajería avanzada: 20 herramientas para SMS, correo electrónico, conversaciones y grabaciones de llamadas
🏢 Operaciones empresariales: Gestión de ubicaciones, objetos personalizados, flujos de trabajo y encuestas
💰 Ventas e ingresos: Oportunidades, pagos, facturas, presupuestos y automatización de facturación
📱 Automatización de marketing: Redes sociales, campañas de correo electrónico, gestión de blogs y biblioteca de medios
🛒 Comercio electrónico: Gestión de tiendas, productos, inventario, envíos y cumplimiento de pedidos

⚡ Opciones de implementación rápida

🟢 Vercel (Recomendado)

Por qué Vercel:

✅ Nivel gratuito con límites generosos
✅ HTTPS automático y CDN global
✅ Implementación sin configuración
✅ Perfecto para servidores MCP

🚂 Railway

Por qué Railway:

✅ $5 de crédito mensual gratuito
✅ Implementación simple con un clic
✅ Escalado automático
✅ Excelente para cargas de trabajo de producción

🎨 Render

✅ Nivel gratuito disponible
✅ Implementación automática desde GitHub
✅ SSL integrado

🌟 Catálogo completo de herramientas (269 herramientas)

🎯 Gestión de contactos (31 herramientas)

Operaciones principales:

create_contact, search_contacts, get_contact, update_contact, delete_contact
add_contact_tags, remove_contact_tags - Organiza con etiquetas

Gestión de tareas y 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

Funciones avanzadas:

upsert_contact - Creación/actualización inteligente
get_duplicate_contact - Detección de duplicados
bulk_update_contact_tags - Operaciones de etiquetado masivo
add_contact_to_workflow, remove_contact_from_workflow - Automatización de flujos de trabajo
add_contact_followers, remove_contact_followers - Colaboración en equipo

💬 Mensajería y conversaciones (20 herramientas)

Comunicación directa:

send_sms, send_email - Envía mensajes con formato enriquecido
search_conversations, get_conversation, create_conversation

Gestión de mensajes:

get_message, get_email_message, upload_message_attachments
update_message_status, cancel_scheduled_message

Funciones de llamadas:

get_message_recording, get_message_transcription, download_transcription
add_inbound_message, add_outbound_call - Registro manual

Chat en vivo:

live_chat_typing - Indicadores de escritura en tiempo real

📝 Gestión de blogs (7 herramientas)

create_blog_post, update_blog_post - Creación de contenido con SEO
get_blog_posts, get_blog_sites - Descubrimiento de contenido
get_blog_authors, get_blog_categories - Organización
check_url_slug - Validación de SEO

💰 Gestión de oportunidades (10 herramientas)

search_opportunities - Filtrado avanzado por pipeline, etapa, contacto
get_pipelines - Gestión de pipelines de ventas
create_opportunity, update_opportunity, delete_opportunity
update_opportunity_status - Actualizaciones rápidas de ganadas/perdidas
upsert_opportunity - Gestión inteligente de pipelines
add_opportunity_followers, remove_opportunity_followers

🗓️ Calendario y citas (14 herramientas)

Gestión de calendarios:

get_calendar_groups, get_calendars, create_calendar
update_calendar, delete_calendar

Reserva de citas:

get_calendar_events, get_free_slots - Verificación de disponibilidad
create_appointment, get_appointment, update_appointment, delete_appointment

Control de horarios:

create_block_slot, update_block_slot - Bloqueo de tiempo

📧 Marketing por correo electrónico (5 herramientas)

get_email_campaigns - Gestión de campañas
create_email_template, get_email_templates - Sistema de plantillas
update_email_template, delete_email_template

🏢 Gestión de ubicaciones (24 herramientas)

Gestión de subcuentas:

search_locations, get_location, create_location, update_location, delete_location

Sistema de etiquetas:

get_location_tags, create_location_tag, update_location_tag, delete_location_tag

Campos y valores personalizados:

get_location_custom_fields, create_location_custom_field, update_location_custom_field
get_location_custom_values, create_location_custom_value, update_location_custom_value

Plantillas y configuraciones:

get_location_templates, delete_location_template, get_timezones

✅ Verificación de correo electrónico (1 herramienta)

verify_email - Evaluación de entregabilidad y riesgo

📱 Gestión de redes sociales (17 herramientas)

Gestión de publicaciones:

search_social_posts, create_social_post, get_social_post
update_social_post, delete_social_post, bulk_delete_social_posts

Integración de cuentas:

get_social_accounts, delete_social_account, start_social_oauth

Operaciones masivas:

upload_social_csv, get_csv_upload_status, set_csv_accounts

Organización:

get_social_categories, get_social_tags, get_social_tags_by_ids

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

📁 Biblioteca de medios (3 herramientas)

get_media_files - Buscar y filtrar medios
upload_media_file - Cargas de archivos y URL alojadas
delete_media_file - Limpiar recursos de medios

🏗️ Objetos personalizados (9 herramientas)

Gestión de esquemas:

get_all_objects, create_object_schema, get_object_schema, update_object_schema

Operaciones de registros:

create_object_record, get_object_record, update_object_record, delete_object_record

Búsqueda avanzada:

search_object_records - Consultar datos personalizados

Casos de uso: Registros de mascotas, tickets de soporte, inventario, datos empresariales personalizados

🔗 Gestión de asociaciones (10 herramientas)

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
Mapeo avanzado de relaciones entre objetos

🎛️ Campos personalizados V2 (8 herramientas)

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

⚡ Gestión de flujos de trabajo (1 herramienta)

ghl_get_workflows - Descubrimiento de flujos de trabajo de automatización

📊 Gestión de encuestas (2 herramientas)

ghl_get_surveys - Gestión de encuestas
ghl_get_survey_submissions - Análisis de respuestas

🛒 Gestión de tiendas (18 herramientas)

Zonas de envío:

ghl_create_shipping_zone, ghl_list_shipping_zones, ghl_get_shipping_zone
ghl_update_shipping_zone, ghl_delete_shipping_zone

Tarifas de envío:

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

Transportistas y configuraciones:

ghl_create_shipping_carrier, ghl_list_shipping_carriers, ghl_update_shipping_carrier
ghl_create_store_setting, ghl_get_store_setting

📦 Gestión de productos (10 herramientas)

Operaciones de productos:

ghl_create_product, ghl_list_products, ghl_get_product
ghl_update_product, ghl_delete_product

Precios e inventario:

ghl_create_price, ghl_list_prices, ghl_list_inventory

Colecciones:

ghl_create_product_collection, ghl_list_product_collections

💳 Gestión de pagos (20 herramientas)

Proveedores de integración:

create_whitelabel_integration_provider, list_whitelabel_integration_providers

Gestión de pedidos:

list_orders, get_order_by_id, create_order_fulfillment, list_order_fulfillments

Seguimiento de transacciones:

list_transactions, get_transaction_by_id

Gestión de suscripciones:

list_subscriptions, get_subscription_by_id

Sistema de cupones:

list_coupons, create_coupon, update_coupon, delete_coupon, get_coupon

Pasarelas de pago personalizadas:

create_custom_provider_integration, delete_custom_provider_integration
get_custom_provider_config, create_custom_provider_config

🧾 Facturas y facturación (39 herramientas)

Plantillas de facturas:

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

Facturas recurrentes:

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

Gestión de facturas:

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

Presupuestos:

create_estimate, list_estimates, update_estimate, delete_estimate
send_estimate, create_invoice_from_estimate, generate_estimate_number Plantillas de presupuestos:
list_estimate_templates, create_estimate_template, update_estimate_template
delete_estimate_template, preview_estimate_template

🎮 Ejemplos de uso en Claude Desktop

📞 Flujo de trabajo de comunicación con clientes

"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"

💰 Gestión del pipeline de ventas

"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"

📊 Inteligencia de negocio

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

🛒 Operaciones de comercio electrónico

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

📱 Automatización de redes sociales

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

🎯 Automatización 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"

🔧 Desarrollo local

Requisitos previos

Node.js 18+ (se recomienda la última versión LTS)
Cuenta de GoHighLevel con acceso a la API
Clave de API válida e ID de ubicación
Claude Desktop (para la integración con MCP)

Instalación y configuración

# 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

Configuración del entorno

# 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 disponibles

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

Pruebas y validación

# 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

🌐 Guía de despliegue

🟢 Despliegue en Vercel (recomendado)

Opción 1: Despliegue con un clic

Opción 2: Despliegue 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

Configuración de Vercel (vercel.json):

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

🚂 Despliegue en Railway

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

# Login and deploy
railway login
railway init
railway up

# Add environment variables via Railway dashboard

🎨 Despliegue en Render

Conecta tu repositorio de GitHub
Configura el comando de compilación: npm run build
Configura el comando de inicio: npm start
Añade las variables de entorno en el panel de Render

🐳 Despliegue con 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

🔌 Integración con Claude Desktop

Configuración de MCP

Añade a tu mcp_settings.json de 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"
      }
    }
  }
}

Integración MCP por HTTP

Para clientes MCP basados en web, usa el endpoint HTTP:

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

📋 Arquitectura del proyecto

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

🔐 Seguridad y mejores prácticas

Seguridad del entorno

✅ Nunca subas claves de API al control de versiones
✅ Usa variables de entorno para todos los datos sensibles
✅ Implementa políticas CORS adecuadas
✅ Rota las claves de API periódicamente
✅ Supervisa el uso de la API y los límites de tasa

Consideraciones de producción

✅ Implementa un manejo de errores y registro adecuados
✅ Configura monitoreo y alertas
✅ Usa HTTPS en todos los despliegues
✅ Implementa limitación de tasa de solicitudes
✅ Aplica actualizaciones de seguridad periódicas

Límites de tasa de la API

La API de GoHighLevel tiene límites de tasa
Implementa retroceso exponencial
Almacena en caché los datos solicitados con frecuencia
Usa operaciones por lotes cuando estén disponibles

🚨 Guía de solución de problemas

Problemas comunes y soluciones

Errores de compilación:

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

Problemas de conexión con la 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 comunes con la API:

✅ Usar la clave de API de integraciones privadas (no la clave de API normal)
✅ Tener los alcances requeridos habilitados en la integración privada
✅ Que el ID de ubicación coincida con tu cuenta de GHL
✅ Tener las variables de entorno configuradas correctamente

Integración con Claude Desktop:

Verifica la sintaxis de la configuración de MCP
Comprueba que las rutas de archivo sean absolutas
Asegúrate de que las variables de entorno estén configuradas
Reinicia Claude Desktop después de los cambios

Problemas de memoria:

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

Errores CORS:

Configura la variable de entorno CORS_ORIGINS
Asegúrate de que las cabeceras HTTP sean correctas
Comprueba la lista blanca de dominios

Optimización del rendimiento

Habilita el almacenamiento en caché de respuestas para operaciones de lectura
Usa paginación para conjuntos de datos grandes
Implementa agrupación de conexiones
Supervisa el uso de memoria y optimiza en consecuencia

📊 Especificaciones técnicas

Requisitos del sistema

Runtime: Node.js 18+ (se recomienda la última versión LTS)
Memoria: Mínimo 512 MB de RAM, recomendado 1 GB o más
Almacenamiento: 100 MB para la aplicación, adicional para registros
Red: Conexión a internet estable para llamadas a la API

Stack tecnológico

Backend: Node.js + TypeScript
Framework HTTP: Express.js 5.x
SDK de MCP: @modelcontextprotocol/sdk ^1.12.1
Cliente HTTP: Axios ^1.9.0
Pruebas: Jest con soporte de TypeScript
Sistema de compilación: Compilador de TypeScript

Integración con la API

API de GoHighLevel: v2021-07-28 (Contactos), v2021-04-15 (Conversaciones)
Autenticación: Token Bearer
Límites de tasa: Respeta los límites de la API de GHL
Manejo de errores: Recuperación integral de errores

Métricas de rendimiento

Arranque en frío: < 2 segundos
Respuesta de la API: < 500 ms de promedio
Uso de memoria: ~50-100 MB base
Ejecución de herramientas: < 1 segundo de promedio

🤝 Contribuciones

¡Agradecemos las contribuciones de la comunidad de GoHighLevel!

Flujo de trabajo de desarrollo

# 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

Guía de contribuciones

✅ Añade pruebas completas para nuevas herramientas
✅ Sigue las mejores prácticas de TypeScript
✅ Actualiza la documentación para nuevas funciones
✅ Asegúrate de que todos los linters pasen
✅ Incluye ejemplos en la descripción de la solicitud de extracción

Estándares de código

Usa el modo estricto de TypeScript
Sigue las convenciones de nomenclatura existentes
Añade comentarios JSDoc para todos los métodos públicos
Implementa un manejo de errores adecuado
Incluye pruebas de integración

📄 Licencia

Este proyecto está licenciado bajo la Licencia ISC; consulta el archivo LICENSE para más detalles.

🆘 Comunidad y soporte

Documentación

Obtener ayuda

Problemas: Problemas de GitHub
Debates: Debates de GitHub
Referencia de la API: Documentación de la API de GoHighLevel
Protocolo MCP: Model Context Protocol

Recursos de la comunidad

💬 Únete a nuestra comunidad de Discord
📺 Suscríbete a nuestro canal de YouTube
📰 Sigue nuestro blog de desarrollo
🐦 Síguenos en Twitter para novedades

🎉 Métricas de éxito

Este servidor MCP integral ofrece:

✅ 269 herramientas operativas en 19 categorías

✅ Integración en tiempo real con GoHighLevel con cobertura completa de la API

✅ Despliegue listo para producción en múltiples plataformas

✅ Arquitectura de nivel empresarial con manejo integral de errores

✅ Soporte completo de TypeScript con definiciones de tipos completas

✅ Amplia cobertura de pruebas que garantiza la fiabilidad

✅ Despliegue multiplataforma (Vercel, Railway, Render, Docker)

✅ Integración con Claude Desktop con cumplimiento del protocolo MCP

✅ Desarrollo impulsado por la comunidad con documentación completa

🚀 ¿Listo para revolucionar tu automatización de GoHighLevel?

¡Despliega ahora y desbloquea todo el potencial de la gestión de CRM impulsada por IA!

💝 Apoya este proyecto

Este proyecto representa cientos de horas de trabajo de desarrollo para ayudar a la comunidad de GoHighLevel. Si te está ahorrando tiempo y ayudando a tu negocio, considera apoyar su desarrollo continuo:

🎁 Formas de apoyar:

⭐ Marca este repositorio con una estrella — Ayuda a otros a descubrir el proyecto
🍕 Invítame a una pizza — Dona a través de Stripe
🐛 Reporta errores — Ayuda a mejorarlo para todos
💡 Sugiere funciones — Comparte tus ideas para mejoras
🤝 Contribuye con código — ¡Las solicitudes de extracción siempre son bienvenidas!

🏆 Reconocimiento:

Los contribuyentes aparecerán en el proyecto
Las contribuciones significativas pueden recibir reconocimiento especial
Este proyecto es impulsado y respaldado por la comunidad

¡Cada contribución, grande o pequeña, ayuda a mantener este proyecto vivo y en crecimiento! 🚀

Hecho con ❤️ para la comunidad de GoHighLevel por desarrolladores que entienden el poder de la automatización.