# 📈 Gestor de Clientes y Embudo Comercial (HubSpot CRM MCP)

> **Resumen para No Técnicos**: Permite que tu Inteligencia Artificial cree nuevos contactos, actualice el estado de tus cotizaciones y registre notas de llamadas directamente en tu CRM de HubSpot sin que tengas que llenar formularios a mano después de cada reunión con un cliente.

| Metadato | Detalle |
|---|---|
| **Tipo** | Servidor MCP & API Oficial de HubSpot |
| **Área Empresarial** | 02. Ventas y Gestión de Relaciones con Clientes (CRM) |
| **Nivel de Dificultad** | 🟢 Fácil |
| **Modelo de Costo** | Plan Free de HubSpot (100% Gratuito para contactos y cotizaciones ilimitadas) |
| **Enlace Oficial** | [HubSpot Developer Platform](https://developers.hubspot.com/) |

---

## 💡 ¿Para qué le sirve a tu empresa? (Valor Real)

El mayor problema de los equipos de ventas en las PyMEs es la **falta de registro**: los vendedores hablan con clientes, acuerdan precios, pero se les olvida anotar en el CRM qué hablaron o cuándo volver a llamar.

Con el conector MCP de HubSpot, el vendedor simplemente le dice a la IA por voz o texto:
> *"Acabo de terminar una llamada con Carlos Mendoza de Industrias ABC. Le coticé $1,200 USD por el lote de empaques. Quedó de responder el próximo jueves. Crea el contacto y el negocio en HubSpot."*

La IA registra todo en el sistema en 3 segundos con fechas de vencimiento y recordatorios automáticos.

---

## 🎁 ¿Qué valor aporta frente a soluciones tradicionales?

- **Cero fricción para el vendedor**: Nadie tiene que aprender menús difíciles de CRM.
- **Visibilidad total para la gerencia**: El dueño del negocio puede preguntarle a la IA: *"¿Cuántas cotizaciones tenemos abiertas este mes y cuál es el valor total en el embudo?"*
- **Sincronización automática de correos y notas**: Todo queda ordenado en la ficha de cada cliente.

---

## 🔑 ¿Qué necesitas para activarlo?

1. Una cuenta gratuita de [HubSpot](https://www.hubspot.es/).
2. Un *Token de Acceso Privado* (Private App Access Token) generado en *Configuración > Integraciones > Aplicaciones Privadas*.
3. Permisos de lectura y escritura para `crm.objects.contacts` y `crm.objects.deals`.

---

## ⚙️ Configuración Paso a Paso

Agrega este bloque a tu archivo `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-hubspot"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "pat-na1-12345678-abcd-efgh-ijkl-mnopqrstuvwx"
      }
    }
  }
}
```

---

## 🤖 Consultor Interactivo (Prompt Guiado para tu IA)

Copia y pega este prompt en tu chat con la IA:

```markdown
Actúa como mi Gerente Comercial y Administrador de HubSpot CRM. 
Vamos a revisar el estado de nuestros prospectos y registrar los últimos avances comerciales.

Por favor, pregúntame:
1. ¿Qué acción deseas realizar hoy (registrar un nuevo prospecto, actualizar una cotización existente, o generar un reporte del embudo de ventas)?
2. Si es un nuevo contacto: ¿cuál es su nombre, empresa, correo, teléfono y valor estimado del negocio?
3. ¿Cuál es el próximo paso o fecha límite para dar seguimiento?

Con tus datos, actualizaré HubSpot y te confirmaré los registros creados con su respectivo enlace directo.
```

---

## 🌎 Caso de Uso Real en América Latina

**Empresa**: "Soluciones Logísticas del Pacífico" (Agencia de aduanas y carga en Guayaquil, Ecuador).
- **Problema**: Los 4 ejecutivos comerciales olvidaban hacer seguimiento a más de 50 cotizaciones mensuales de fletes marítimos.
- **Resultado con el MCP**: Al cierre de cada jornada, cada ejecutivo dicta un audio de 1 minuto con sus avances del día. La IA transcribe el audio, actualiza HubSpot y programa alertas para los seguimientos de la semana. Las ventas cerradas aumentaron un 28%.

---

## 🛡️ Consideraciones de Seguridad y Buenas Prácticas

- **Privilegios Mínimos**: No otorgues permisos de borrado masivo (*delete*) a la aplicación privada de HubSpot para evitar pérdidas accidentales de datos.
- **Protección de Datos de Clientes**: Asegúrate de que los contactos registrados hayan solicitado cotizaciones o información de tu empresa.