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:

\
![](https://storage.googleapis.com/chatwoot-leadway-data/hoqrxr0q0qe0xhmxhf9s2tzcclfo)

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

1. Ve a **Configuración → Integraciones Privadas** dentro de tu ubicación en **Leadway**.

2. Haz clic en **Crear nueva integración**.

3. Selecciona los **alcances (scopes)** necesarios.

4. 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())
```