# 🚀 Guía de Inicio Rápido para Personas No Técnicas

> **Objetivo de esta guía**: Enseñarte a conectar tus primeras herramientas y servidores MCP a tu aplicación de Inteligencia Artificial (Claude Desktop, Cursor, Antigravity, VS Code o similares) en menos de 10 minutos, sin saber programar y sin miedo a la terminal.

---

## 🧭 ¿Qué necesitas tener instalado en tu computadora?

Solo necesitas **2 cosas básicas**:

1. **Tu aplicación de IA favorita con soporte para MCP**:
   - **Claude Desktop** (Descárgalo gratis de [anthropic.com/claude-desktop](https://claude.ai/download)).
   - O **Cursor IDE** / **Antigravity** / **VS Code con extensiones MCP**.
2. **Node.js (El motor que ejecuta los conectores en segundo plano)**:
   - Ve a [nodejs.org](https://nodejs.org) y descarga la versión **LTS (Long Term Support / Recomendada para la mayoría)**.
   - Es un instalador normal: dale *Siguiente, Siguiente, Aceptar e Instalar*.

> [!TIP]
> **¿Cómo saber si quedó bien instalado Node.js?**
> Abre el buscador de Windows o Spotlight en Mac, escribe `Terminal` o `PowerShell`, presiona Enter y escribe:
> ```bash
> node -v
> ```
> Si te aparece un número como `v20.11.0` o superior, ¡ya estás 100% listo!

---

## 📍 ¿Dónde se encuentra el archivo de configuración?

Los servidores MCP se configuran mediante un archivo de texto llamado `claude_desktop_config.json` (o equivalente en tu editor).

### En Windows 🪟:
1. Presiona las teclas `Windows + R` en tu teclado.
2. Pega exactamente esto en la ventanita que aparece:
   ```text
   %APPDATA%\Claude
   ```
3. Presiona Enter. Verás la carpeta de Claude.
4. Ahí dentro busca el archivo `claude_desktop_config.json`. Si no existe, puedes crearlo con el Bloc de Notas.

### En macOS 🍏:
1. Abre **Finder** y presiona `Cmd + Shift + G`.
2. Pega esta ruta:
   ```text
   ~/Library/Application Support/Claude
   ```
3. Presiona Enter y abre el archivo `claude_desktop_config.json` con TextEdit.

---

## 🛠️ Estructura Básica del Archivo de Configuración

El archivo tiene un formato estándar llamado JSON. Luce de la siguiente manera:

```json
{
  "mcpServers": {
    "nombre-del-conector": {
      "command": "npx",
      "args": [
        "-y",
        "@modelo-o-paquete/servidor-mcp"
      ],
      "env": {
        "TU_CLAVE_SECRETA": "tu-api-key-aqui"
      }
    }
  }
}
```

### 3 Reglas de Oro para no tener errores de sintaxis:
1. **Comas al final**: Si agregas varios conectores, debes poner una coma `,` después del cierre de llave `}` de cada conector, **excepto en el último**.
2. **Comillas dobles**: Usa siempre comillas dobles `"`, nunca comillas simples `'` ni comillas tipográficas curvadas.
3. **Reiniciar la aplicación**: Cada vez que guardes cambios en este archivo, debes **cerrar por completo Claude Desktop o tu IDE y volver a abrirlo**.

---

## 🧪 Ejemplo Práctico: Conectar tu primer MCP (Explorador Web Brave)

Hagamos un ejercicio real paso a paso para que veas lo fácil que es:

### Paso 1: Obtener una clave gratuita de Brave Search
1. Ve a [brave.com/search/api](https://brave.com/search/api/) y crea una cuenta gratuita.
2. Genera una API Key (el plan gratuito te da 2,000 búsquedas al mes sin costo).
3. Copia tu clave (luce algo como `BSAxxxxxxxxxxxxxxxxx`).

### Paso 2: Editar tu archivo de configuración
Abre tu `claude_desktop_config.json` y pega lo siguiente:

```json
{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "PEGA_AQUI_TU_CLAVE_DE_BRAVE"
      }
    }
  }
}
```

### Paso 3: Guardar y Reiniciar
1. Guarda el archivo con `Ctrl + S` (Windows) o `Cmd + S` (Mac).
2. Cierra Claude Desktop por completo (asegúrate de que no quede en la barra de tareas).
3. Vuelve a abrir Claude Desktop.

### Paso 4: ¡Comprobar que funciona!
En la esquina inferior del chat de Claude verás el ícono de un martillo 🔨 o enchufe. Haz clic y verás activa la herramienta `brave_web_search`.

Ahora escribe en el chat:
> *"¿Cuáles son las 3 noticias empresariales más destacadas en Colombia/México el día de hoy? Utiliza tu buscador para confirmar la información más reciente."*

¡La IA buscará en internet en tiempo real y te dará la respuesta exacta con fuentes!

---

## ❓ Preguntas Frecuentes y Solución de Problemas

### 1. "Guardé el archivo pero no me aparece el ícono del martillo 🔨"
- **Causa común**: Quedó una coma mal puesta en el archivo JSON.
- **Solución**: Copia el texto de tu archivo y pégalo en [jsonlint.com](https://jsonlint.com). Esa página gratuita te dirá en qué línea exacta está el error de sintaxis.

### 2. "¿Tengo que pagar por usar MCPs?"
- El protocolo MCP y los conectores son **100% gratuitos y de código abierto**.
- Algunas APIs externas (como WhatsApp Cloud API o pasarelas de pago) tienen tiers gratuitos generosos y solo cobran si superas un volumen alto de transacciones. En cada ficha de este repositorio te indicamos si la herramienta es gratuita o si tiene costos.

### 3. "¿Puedo desactivar un MCP cuando no lo use?"
- Sí. Simplemente borra su bloque del archivo de configuración o renómbralo y reinicia tu aplicación.

---

## 🎯 Siguiente Paso

Ahora que dominas la conexión básica, explora las carpetas por área de tu empresa en este repositorio:
- [📢 01. Marketing Digital](./01-marketing-digital/)
- [🤝 02. Ventas y CRM](./02-ventas-y-crm/)
- [💰 03. Finanzas y Facturación](./03-finanzas-y-contabilidad/)
- [🎧 04. Soporte al Cliente](./04-servicio-al-cliente-y-soporte/)
- [📦 05. Operaciones y Logística](./05-operaciones-y-logistica/)
- [👥 06. Talento y RRHH](./06-talento-y-recursos-humanos/)
- [⚖️ 07. Legal y Seguridad](./07-legal-y-cumplimiento/)
- [🚀 08. Estrategia General](./08-estrategia-y-automatizacion-general/)