Este artículo te mostrará cómo aprovechar el nuevo servidor MCP (Model Context Protocol) de Leadway para que tus agentes de IA y copilotos puedan acceder de forma segura y fluida a los datos y herramientas de Leadway.
Todo esto se realiza mediante un protocolo HTTP estandarizado y seguro, permitiéndote conectar tus flujos de IA con la información y funciones clave de tu cuenta sin fricción.

¿Qué es el Servidor MCP?

El servidor MCP de Leadway es un protocolo estandarizado y seguro que permite que los agentes de IA lean y escriban datos dentro de Leadway sin necesidad de SDKs ni integraciones personalizadas complejas.
Ahora puedes dar acceso a tus agentes a herramientas esenciales como Calendario, Contactos, Conversaciones, Oportunidades y Pagos desde una sola interfaz unificada.

Beneficios clave de usar el Servidor MCP

Conectar tus agentes de IA a Leadway nunca había sido tan fácil ni tan seguro:

Acceso estandarizado

Consulta y actualiza datos mediante un protocolo unificado.

Integración rápida

No requiere SDKs; funciona con cualquier cliente que soporte HTTP.

Máxima seguridad

Utiliza tokens de integración privada (PITs) para otorgar acceso granular basado en permisos.

Escalable

Diseñado para expandirse a más de 250 herramientas en el futuro.

Flexible

Compatible con clientes populares como Cursor, Windsurf y OpenAI Playground.

Top 21 herramientas disponibles

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

Pasos de configuración

Paso 1: Configurar tu agente o cliente

Agrega el endpoint MCP y los encabezados en la configuración de tu agente:

{
  "mcpServers": {
    "prod-leadway-mcp": {
      "url": "https://services.leadconnectorhq.com/mcp/",
      "headers": {
        "Authorization": "Bearer <tu-token>",
        "locationId": "<id-de-tu-subcuenta>"
      }
    }
  }
}

Paso 2: Obtener tu Token de Integración Privada (PIT)

Ve a Configuración → Integraciones Privadas dentro de tu ubicación en Leadway.
Haz clic en Crear nueva integración.
Selecciona los alcances (scopes) necesarios.
Copia y guarda tu token en un lugar seguro.

Scopes requeridos

Asegúrate de que tu PIT incluya los siguientes permisos:

Ver / Editar Contactos
Ver / Editar Conversaciones
Ver / Editar Mensajes de Conversación
Ver / Editar Oportunidades
Ver Calendarios y Eventos
Ver Ubicaciones
Ver Órdenes de Pago y Transacciones
Ver Campos Personalizados
Ver Formularios

Paso 3: ¡Comienza a construir!

A partir de este punto, tus agentes pueden usar instrucciones en lenguaje natural que se traducen automáticamente en llamadas API seguras mediante MCP.

Ejemplo de llamada a una herramienta

Ejemplo en Python:

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())

Appearance

Cómo usar el servidor MCP de Leadway