> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whaapy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar MCPs

> Cómo conectar sistemas externos al agente de Whaapy mediante MCPs

# Configurar MCPs

La tab `MCPs` conecta al agente con sistemas externos mediante capacidades estructuradas.

MCP significa Model Context Protocol. Para usar Whaapy no necesitas aprender el protocolo a bajo nivel. En la práctica, un MCP es un conector que le da al agente acceso controlado a datos o acciones fuera de Whaapy.

<Tip>
  Si vas a construir tu propio servidor MCP para Whaapy, revisa la [especificación técnica de compatibilidad](/guides/mcp-server-spec).
</Tip>

***

## Cuándo usar MCPs

Usa MCPs cuando el agente necesita trabajar con sistemas externos:

* CRM
* calendario externo
* base de datos
* documentos internos
* ERP
* helpdesk
* e-commerce
* herramientas propias del negocio
* automatizaciones internas

Si la información vive dentro de un documento estable, usa [Knowledge](/guides/agent-knowledge). Si la acción ya existe como capacidad nativa de Whaapy, usa [Tools](/guides/agent-tools). Si viene de otro sistema, usa `MCPs`.

***

## Qué puede aportar un MCP

<CardGroup cols={2}>
  <Card title="Lectura de datos" icon="database">
    Consultar registros, pedidos, clientes, tickets, inventario o documentación.
  </Card>

  <Card title="Acciones externas" icon="bolt">
    Crear tickets, actualizar campos, agendar eventos o disparar procesos.
  </Card>

  <Card title="Contexto especializado" icon="book">
    Darle al agente acceso a conocimiento que no vive en Whaapy.
  </Card>

  <Card title="Integración controlada" icon="lock">
    Limitar qué puede ver o ejecutar el agente.
  </Card>
</CardGroup>

***

## Cómo configurar un MCP

<Steps>
  <Step title="Elige el sistema">
    Define qué sistema quieres conectar y qué problema resuelve para el agente.
  </Step>

  <Step title="Agrega el MCP">
    Crea o selecciona el conector desde la tab `MCPs`.
  </Step>

  <Step title="Configura credenciales">
    Agrega API keys, tokens u otro método de autenticación requerido por el conector.
  </Step>

  <Step title="Selecciona capacidades">
    Habilita solo las herramientas que el agente debe usar. No expongas todo el sistema.
  </Step>

  <Step title="Define permisos">
    Separa lectura y escritura. Leer datos suele ser menos riesgoso que modificar registros.
  </Step>

  <Step title="Prueba conexión">
    Ejecuta una prueba simple antes de usarlo en una conversación real.
  </Step>

  <Step title="Conecta con Tools o Subagents">
    Decide qué tool o subagent puede usar ese MCP y bajo qué condiciones.
  </Step>
</Steps>

***

## Permisos recomendados

Empieza con el menor permiso posible.

| Necesidad                           | Permiso recomendado                        |
| ----------------------------------- | ------------------------------------------ |
| Responder dudas desde docs externas | Solo lectura                               |
| Consultar estado de pedido          | Solo lectura por ID o cliente              |
| Crear ticket                        | Escritura limitada a tickets               |
| Actualizar CRM                      | Escritura limitada a campos específicos    |
| Cancelar o cobrar                   | Requiere confirmación y normalmente humano |

<Warning>
  No conectes credenciales con permisos administrativos si el agente solo necesita consultar datos.
</Warning>

***

## Ejemplo: CRM

```text theme={null}
Sistema: CRM

Objetivo:
Permitir que el agente consulte información básica del lead y cree una nota de seguimiento.

Capacidades:
- Buscar lead por teléfono
- Leer estado del lead
- Crear nota

No permitido:
- Borrar leads
- Cambiar dueño del lead
- Modificar etapa de venta sin confirmación
```

***

## Ejemplo: helpdesk

```text theme={null}
Sistema: Helpdesk

Objetivo:
Permitir que el subagent de soporte cree tickets cuando no puede resolver el caso.

Capacidades:
- Crear ticket
- Adjuntar resumen de conversación
- Consultar estado de ticket

Reglas:
- Pedir correo o número de pedido antes de crear ticket.
- Si el cliente está molesto, transferir a humano después de crear ticket.
```

***

## MCPs y seguridad operativa

Un MCP amplía lo que el agente puede hacer. Eso es poderoso, pero exige límites claros.

Checklist antes de activar:

<Check>El MCP tiene un objetivo específico.</Check>
<Check>Las credenciales tienen permisos mínimos.</Check>
<Check>Las acciones de escritura requieren confirmación cuando hay riesgo.</Check>
<Check>El agente tiene instrucciones de fallback si el MCP falla.</Check>
<Check>Hay una forma clara de desconectar el MCP si algo sale mal.</Check>

***

## Cómo probar un MCP

| Prueba               | Qué validar                              |
| -------------------- | ---------------------------------------- |
| Consulta simple      | El agente obtiene el dato correcto       |
| Dato inexistente     | El agente no inventa                     |
| Error de conexión    | El agente explica y ofrece handoff       |
| Permiso insuficiente | El agente no insiste ni promete acciones |
| Acción sensible      | Pide confirmación o escala               |

Ejemplo de fallback:

```text theme={null}
No pude consultar el sistema externo en este momento. Puedo tomar tus datos y pasar el caso al equipo para revisión.
```

***

## Errores comunes

| Error                          | Resultado                                      | Mejor enfoque                  |
| ------------------------------ | ---------------------------------------------- | ------------------------------ |
| Exponer demasiadas capacidades | El agente puede usar herramientas innecesarias | Habilita solo lo requerido     |
| Credenciales amplias           | Riesgo operativo                               | Usa permisos mínimos           |
| Sin fallback                   | Respuestas falsas ante fallos                  | Define salida clara            |
| MCP para datos estáticos       | Complejidad innecesaria                        | Usa Knowledge                  |
| No conectar con un subagent    | Uso fuera de contexto                          | Asigna MCPs a flujos concretos |

***

## Relación con Tools y Subagents

Un MCP suele ser la conexión. Una tool o subagent decide cuándo usarla.

```mermaid theme={null}
flowchart LR
    subagent["Subagent de soporte"] --> tool["Tool crear ticket"]
    tool --> mcp["MCP Helpdesk"]
    mcp --> external["Sistema externo"]
```

Esto permite que el agente no tenga acceso libre a todo. Accede a capacidades específicas cuando la conversación lo requiere.

***

## Siguiente paso

<CardGroup cols={2}>
  <Card title="Tools" icon="wrench" href="/guides/agent-tools">
    Define las acciones que usarán esos conectores.
  </Card>

  <Card title="Subagents" icon="diagram-project" href="/guides/agent-subagents">
    Decide qué especialista puede usar cada MCP.
  </Card>
</CardGroup>