# 🧠 Base de Conocimiento de Empresa y Manuales (Qdrant & Chroma Vector MCP)

> **Resumen para No Técnicos**: Permite que tu Inteligencia Artificial "se lea" todos los manuales de tus productos, políticas de devolución, fichas técnicas y preguntas frecuentes de tu empresa, y responda las dudas de tus clientes de forma exacta y sin inventar información (*cero alucinaciones*).

| Metadato | Detalle |
|---|---|
| **Tipo** | Servidor MCP de Búsqueda Semántica Vectorial (RAG) |
| **Área Empresarial** | 04. Servicio al Cliente, Soporte Técnico y Postventa |
| **Nivel de Dificultad** | 🟡 Media |
| **Modelo de Costo** | 100% Gratuito y de Código Abierto (Qdrant Cloud ofrece tier gratuito permanente) |
| **Enlace Oficial** | [Qdrant MCP Server](https://github.com/qdrant/mcp-server-qdrant) / [Chroma DB](https://www.trychroma.com/) |

---

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

Cuando un cliente pregunta: *"¿Esta pintura para exteriores sirve para aplicar sobre madera tratada con humedad?"* o *"¿Cuál es la política de cambio si perdí la factura física?"*, un asistente de IA genérico podría dar una respuesta equivocada o inventar una política que no existe en tu negocio.

Con una **Base de Conocimiento Vectorial (RAG - *Retrieval-Augmented Generation*)**:
- La IA busca en milisegundos en los documentos oficiales de tu empresa.
- Encuentra el párrafo exacto que habla de ese tema.
- Le responde al cliente citando la política real de tu negocio: *"De acuerdo con nuestra guía técnica, la pintura modelo X solo debe aplicarse en maderas secas con menos del 15% de humedad..."*.

---

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

- **Cero Respuestas Inventadas**: La IA solo responde con base en tus documentos autorizados.
- **Actualización en 1 Clic**: Si cambias tus precios o políticas, solo subes el nuevo PDF y el asistente se actualiza de inmediato sin re-entrenar modelos.
- **Atención 24/7 sin Cansancio**: Responde cientos de dudas técnicas a la vez con la misma precisión.

---

## 🔑 ¿Qué necesitas para activarlo?

1. Tus manuales de producto, políticas y preguntas frecuentes en archivos de texto, Word o PDF.
2. Un clúster gratuito en [Qdrant Cloud](https://cloud.qdrant.io/) o una base de datos Chroma local.
3. Tu `QDRANT_URL` y `QDRANT_API_KEY`.

---

## ⚙️ Configuración Paso a Paso

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

```json
{
  "mcpServers": {
    "base-conocimiento": {
      "command": "npx",
      "args": [
        "-y",
        "@qdrant/mcp-server-qdrant"
      ],
      "env": {
        "QDRANT_URL": "https://xyz-example.cloud.qdrant.io:6333",
        "QDRANT_API_KEY": "tu_clave_secreta_qdrant",
        "COLLECTION_NAME": "manuales_empresa_xprof"
      }
    }
  }
}
```

---

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

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

```markdown
Actúa como el Agente Senior de Soporte Técnico y Postventa de [Nombre de Empresa].
Tu misión es resolver la consulta del cliente utilizando ÚNICAMENTE la información encontrada en nuestra base de conocimiento oficial.

Instrucciones de atención:
1. Si la información está en los manuales de la empresa, responde con claridad, amabilidad y paso a paso.
2. Cita la sección o manual de referencia (ej: "Según el Manual de Garantías 2026, sección 4.2...").
3. Si la respuesta NO se encuentra en los manuales o requiere una decisión especial, responde honestamente: "No dispongo de esa especificación técnica en nuestros manuales vigentes. Con gusto escalo tu caso a un ingeniero de soporte para que te contacte en breve".
```

---

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

**Empresa**: "Termotanques & Calderas del Sur" (Venta e instalación de calentadores solares en Arequipa, Perú).
- **Problema**: Los clientes llamaban constantemente los fines de semana por códigos de error en los paneles digitales de los calentadores y los técnicos no daban abasto.
- **Resultado con el MCP**: Subieron los manuales de los 15 modelos a la base de conocimiento. Ahora los clientes escriben el código de error por chat y la IA les explica el paso a paso de reinicio o les indica si deben cerrar la llave de paso. El 60% de los reportes se solucionan en el primer minuto.

---

## 🛡️ Consideraciones de Privacidad

- **Documentos Públicos vs. Secretos**: Sube a la base de soporte únicamente documentos destinados a atención a clientes (manuales, fichas comerciales, preguntas frecuentes). No subas contratos privados con proveedores o actas de asamblea.