Inicio Integraciónes Cómo usar el servidor MCP de Leadway

Cómo usar el servidor MCP de Leadway

Última actualización el Mar 28, 2026

Este artículo le mostrará cómo aprovechar el nuevo servidor Leadway MCP (Protocolo de Contexto de Modelo) para que sus agentes y copilotos de IA puedan acceder a los datos y herramientas de Leadway sin problemas, todo ello a través de un protocolo HTTP seguro y estandarizado.

¿Qué es el servidor MCP?

El servidor MCP de Leadway es un protocolo estandarizado y seguro que permite a los agentes de IA leer y escribir datos en Leadway sin necesidad de SDK ni integraciones personalizadas complejas. Ahora puede brindar a los agentes acceso a herramientas esenciales como Calendario, Contactos, Conversaciones, Oportunidades y Pagos a través de una interfaz única y unificada.

Principales ventajas de usar el servidor MCP

Conectar tus agentes de IA a Leadway nunca ha sido tan fácil ni tan seguro.

  • Acceso estandarizado:  Consulte y actualice datos mediante un protocolo unificado.

  • Integración rápida:  No se requieren SDK; funciona con cualquier cliente compatible con HTTP.

  • Seguro:  Utiliza tokens de integración privados (PIT) para un acceso granular basado en permisos.

  • Escalable:  Diseñado para una futura expansión a más de 250 herramientas.

  • Flexible:  Admite clientes populares como Cursor, Windsurf y OpenAI Playground.

Las 36 herramientas disponibles

A continuación se muestra el conjunto inicial de herramientas que sus agentes de IA pueden utilizar hoy:

Contactos

  1. contactos_obtener-contacto — Obtener datos de un contacto por ID.

  2. contactos_obtener-contactos — Listar todos los contactos de la cuenta.

  3. contactos_crear-contacto — Crear un nuevo contacto desde cero.

  4. contactos_actualizar-contacto — Modificar datos de un contacto existente.

  5. contactos_upsert-contacto — Crea el contacto si no existe; actualiza si ya existe.

  6. contactos_añadir-etiquetas — Añadir etiquetas a un contacto.

  7. contactos_eliminar-etiquetas — Quitar etiquetas de un contacto.

  8. contactos_obtener-todas-las-tareas — Recuperar todas las tareas de un contacto.

Conversaciones

  1. conversaciones_buscar-conversación — Buscar, filtrar y ordenar conversaciones.

  2. conversaciones_obtener-mensajes — Recuperar mensajes por ID de conversación.

  3. conversaciones_enviar-un-nuevo-mensaje — Enviar un mensaje a un hilo de conversación.

Calendario

  1. calendarios_obtener-eventos-del-calendario — Obtener eventos por usuario, grupo o calendario.

  2. calendarios_obtener-notas-de-citas — Recuperar notas de una cita específica.

Oportunidades

  1. oportunidades_búsqueda-de-oportunidades — Buscar oportunidades según criterios.

  2. oportunidades_obtener-canales — Obtener todos los embudos de oportunidades.

  3. oportunidades_obtener-oportunidad — Ver detalles de una oportunidad por ID.

  4. actualización de oportunidades-oportunidad — Modificar los detalles de una oportunidad.

Pagos

  1. pagos_obtener-ordenar-por-id — Recuperar detalles de una orden de pago.

  2. lista_de_pagos-transacciones — Obtener la lista paginada de transacciones.

Blog

  1. blogs_obtener-blogs — Listar blogs por ID de ubicación.

  2. blogs_obtener-publicación-de-blog — Ver publicaciones de un blog por ID.

  3. blogs_crear-publicación-de-blog — Crear una entrada de blog nueva.

  4. blogs_update-blog-post — Editar una entrada de blog existente.

  5. blogs_verificar-existe-el-slug-de-la-url — Comprobar el slug antes de publicar.

  6. blogs_obtener-todos-los-autores-de-blogs-por-ubicación — Obtener autores por ID de ubicación.

  7. blogs_obtener-todas-las-categorías-por-ubicación — Obtener categorías por ID de ubicación.

Redes sociales

  1. socialmediaposting_get-account — Listar cuentas y grupos conectados.

  2. socialmediaposting_get-social-media-analytics — Ver analítica de múltiples cuentas.

  3. socialmediaposting_create-post — Publicar en todas las plataformas compatibles.

  4. socialmediaposting_get-post — Ver una publicación específica.

  5. socialmediaposting_get-posts — Obtener todas las publicaciones.

  6. socialmediaposting_edit-post — Actualizar una publicación existente.

Configuración

  1. ubicaciones_obtener-ubicación — Ver detalles de ubicación por ID.

  2. ubicaciones_obtener-campos-personalizados — Recuperar campos personalizados de una ubicación.

  3. emails_create-template — Crear una nueva plantilla de correo.

  4. emails_fetch-template — Ver plantillas de correo por ID de ubicación.

Cómo configurar el servidor MCP

Paso 1: Instalalo

Agrega el punto final y los encabezados de MCP a la configuración de su agente (Claude, Chat GPT o cualquier otro LLM):

json

Copiar y editar

{

  "mcpServers": {

    "prod-ghl-mcp": {

      "url": "https://services.leadconnectorhq.com/mcp/",

      "headers": {

        "Authorization": "Bearer <your-token>",

        "locationId": "<sub-account-id>"

      }

    }

  }

}

Paso 2: Obten tu token de integración privada (PIT)

  1. Ve a  Configuración → Integraciones privadas  en tu cuenta de Leadway.

  2. Haz clic en  Crear nueva integración .

  3. Seleccione los ámbitos requeridos (enumerados a continuación).

  4. Copia y guarda tu token de forma segura.

Alcances requeridos

Asegúrese de que su PIT incluya:

  • Ver/Editar contactos

  • Ver/Editar conversaciones

  • Ver/Editar mensajes de conversación

  • Ver/Editar Oportunidades

  • Ver calendarios y eventos del calendario

  • Ver ubicaciones

  • Ver órdenes de pago y transacciones

  • Ver campos personalizados

  • Ver formularios

  • Verificar el slug de la entrada del blog

  • Actualizar la entrada del blog

  • Crear entrada de blog

  • Ver autores del blog

  • Ver categorías del blog

  • publicaciones de blogs solo lectura

  • Lista de blogs de solo lectura

  • Crear, actualizar y eliminar plantillas de correo electrónico

  • Ver plantillas de correo electrónico

  • Ver cuentas en redes sociales

  • Ver estadísticas de redes sociales

  • Editar publicaciones en redes sociales

  • Ver publicaciones en redes sociales

Paso 3: ¡Comienza a construir!

Ahora, sus agentes pueden llamar a las herramientas mediante instrucciones en lenguaje natural, que se traducen sin problemas en llamadas API seguras a través de MCP.

Ejemplo de llamada a herramienta

Ejemplo en Python:

python

Copiar y editar

solicitudes de importación:

import requests

headers = {

    "Authorization": "Bearer YOUR_PIT_TOKEN",

    "locationId": "YOUR_LOCATION_ID"

}

data = {

    "tool": "contacts_get-contact",

    "input": {

        "contactId": "abc123"

    }

}

response = requests.post(

    "https://services.leadconnectorhq.com/mcp/",

    headers=headers,

    json=data

)

print(response.json())

Hoja de ruta y visión

La versión actual de MCP es solo el comienzo. Nuestra hoja de ruta incluye:

  • Servidores MCP individuales dedicados a servicios específicos para flujos de trabajo concretos.

  • Paquete npx  para admitir clientes sin soporte HTTP nativo (por ejemplo, Claude Desktop).

  • Compatibilidad con OAuth para flujos de autorización avanzados.

  • Ampliación a  más de 250 herramientas  para crear una verdadera capa de orquestación unificada para agentes de IA.

  • Permite la automatización completa de los procesos de negocio en todos los módulos de Leadway

Preguntas frecuentes

P: ¿Puedo usar esto con OpenAI Playground o Claude?
 ¡Sí! Cualquier cliente que admita solicitudes HTTP puede integrarse con MCP.

P: ¿Necesito instalar un SDK?
 No se requiere ningún SDK; MCP utiliza un protocolo HTTP estándar.

P: ¿Mis datos están seguros?
 Sí. El acceso a los datos está totalmente controlado mediante tokens de integración privados y protegido a través de HTTPS.

P: ¿Puedo restringir las herramientas que puede usar un agente?
 Sí. Puede controlar el acceso limitando los ámbitos en su PIT.

P: ¿Qué sucede si necesito una nueva herramienta o un nuevo punto de acceso? ¡
 Envíanos tus comentarios! Estamos ampliando constantemente el conjunto de herramientas disponibles.