Skip to main content

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.

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. Si la acción ya existe como capacidad nativa de Whaapy, usa Tools. Si viene de otro sistema, usa MCPs.

Qué puede aportar un MCP

Lectura de datos

Consultar registros, pedidos, clientes, tickets, inventario o documentación.

Acciones externas

Crear tickets, actualizar campos, agendar eventos o disparar procesos.

Contexto especializado

Darle al agente acceso a conocimiento que no vive en Whaapy.

Integración controlada

Limitar qué puede ver o ejecutar el agente.

Cómo configurar un MCP

1

Elige el sistema

Define qué sistema quieres conectar y qué problema resuelve para el agente.
2

Agrega el MCP

Crea o selecciona el conector desde la tab MCPs.
3

Configura credenciales

Agrega API keys, tokens u otro método de autenticación requerido por el conector.
4

Selecciona capacidades

Habilita solo las herramientas que el agente debe usar. No expongas todo el sistema.
5

Define permisos

Separa lectura y escritura. Leer datos suele ser menos riesgoso que modificar registros.
6

Prueba conexión

Ejecuta una prueba simple antes de usarlo en una conversación real.
7

Conecta con Tools o Subagents

Decide qué tool o subagent puede usar ese MCP y bajo qué condiciones.

Permisos recomendados

Empieza con el menor permiso posible.
NecesidadPermiso recomendado
Responder dudas desde docs externasSolo lectura
Consultar estado de pedidoSolo lectura por ID o cliente
Crear ticketEscritura limitada a tickets
Actualizar CRMEscritura limitada a campos específicos
Cancelar o cobrarRequiere confirmación y normalmente humano
No conectes credenciales con permisos administrativos si el agente solo necesita consultar datos.

Ejemplo: CRM

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

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

Cómo probar un MCP

PruebaQué validar
Consulta simpleEl agente obtiene el dato correcto
Dato inexistenteEl agente no inventa
Error de conexiónEl agente explica y ofrece handoff
Permiso insuficienteEl agente no insiste ni promete acciones
Acción sensiblePide confirmación o escala
Ejemplo de fallback:
No pude consultar el sistema externo en este momento. Puedo tomar tus datos y pasar el caso al equipo para revisión.

Errores comunes

ErrorResultadoMejor enfoque
Exponer demasiadas capacidadesEl agente puede usar herramientas innecesariasHabilita solo lo requerido
Credenciales ampliasRiesgo operativoUsa permisos mínimos
Sin fallbackRespuestas falsas ante fallosDefine salida clara
MCP para datos estáticosComplejidad innecesariaUsa Knowledge
No conectar con un subagentUso fuera de contextoAsigna 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. Esto permite que el agente no tenga acceso libre a todo. Accede a capacidades específicas cuando la conversación lo requiere.

Siguiente paso

Tools

Define las acciones que usarán esos conectores.

Subagents

Decide qué especialista puede usar cada MCP.