Saltar al contenido principal

MCP · Agente IA con herramientas externas

MCP (Model Context Protocol) es un estándar abierto para que un modelo de IA invoque herramientas externas de forma estructurada. WhatsUY implementa un subset de MCP tanto en el modo agente IA directa (dentro de la plataforma) como en un endpoint público (/whats-uy-mcp/execute) para que agentes externos consuman funciones del sistema.

Capacidades​

Funciones como tools​

Cualquier función del proyecto AIFlows con type: "tool" o "mixed" se registra automáticamente como tool del LLM. El modelo puede decidir cuándo invocarla y con qué argumentos.

Endpoint MCP-style público​

POST /whats-uy-mcp/execute
Authorization: Bearer <jwt>

{
  "function": "toggle_bot",
  "arguments": {
    "reference": 12345,
    "chatId": "59891234567@s.whatsapp.net",
    "active": false
  }
}

Servidores MCP externos​

Además de las funciones locales, podés apuntar el agente a un servidor MCP externo (CRM, calendario, pasarela de pago, helpdesk) y combinar sus tools con las locales.

Anti-loop​

Para evitar loops de tool calls:

  • maxToolCallsPerTurn: tope de invocaciones por turno.
  • maxTurnsPerSession: tope de turnos por sesión.
  • Detección de repetición idéntica: si el agente invoca 3 veces la misma tool con los mismos inputs, se corta y escala.

Funciones típicas​

  • toggle_bot — activar/desactivar bot en un chat.
  • send_message — enviar mensaje al canal.
  • mark_read — marcar como leído.
  • set_variable — escribir variable de scope.
  • get_chat_history — leer historial.
  • lookup_customer — buscar cliente (custom).
  • schedule_callback — agendar llamada (custom).
  • ...y todas las que definas en tu proyecto.

Estado​

🟡 Implementación parcial (septiembre 2026). Ver AIFlows · Agente IA directa con MCP y API · MCP para el detalle.