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.