Introducción

El componente MCP (Model Context Protocol) es una herramienta nativa integrada en wolkvox Studio que permite conectar los flujos de routing points con servicios externos como CRM, calendarios, ERPs u otras plataformas mediante el protocolo estándar MCP.

Este componente funciona como un puente inteligente entre wolkvox y sistemas externos, permitiendo que los flujos conversacionales puedan consultar información, crear registros o ejecutar acciones en otros sistemas sin necesidad de desarrollar código personalizado.

Entre sus principales beneficios se encuentran:

• Integración Low-Code: permite importar automáticamente las funciones disponibles en servidores externos, reduciendo tiempos de desarrollo.
• Omnicanalidad nativa: puede utilizarse en routing points de tipo IVR, Chat, Interactions y Agent Scripting.
• Automatización de autoservicio: facilita la creación de flujos conversacionales que permiten, por ejemplo, consultar información o agendar citas en tiempo real.

Para utilizar el componente MCP es necesario primero configurar la conexión con el servidor MCP externo desde wolkvox Manager y posteriormente utilizar el componente dentro de wolkvox Studio.

Configuración

Crear la conexión MCP desde wolkvox Manager

Antes de usar el componente MCP en un flujo, primero debes configurar la conexión con el servidor MCP externo.

1. Haz clic en el icono de configuración ubicado en la parte superior derecha de wolkvox Manager.
2. En el menú lateral selecciona Integraciones.
3. Luego abre la pestaña MCP Client.
4. Haz clic en Nueva conexión para crear la integración con el servidor MCP.
5. Debes completar los siguientes campos:
   1. Nombre de conexión: nombre identificador de la integración.
   2. MCP Endpoint URL: URL del servidor MCP externo.
6. Tipo de autenticación: puede ser:
   • none
   • bearer
   • oauth

Dependiendo del método seleccionado se habilitarán campos adicionales.

1. Si eliges Bearer:
   • Aparecerá el campo Bearer Token, donde debes ingresar el token de autenticación.
2. Si eliges OAuth:
   • Debes hacer clic en Conectar cuenta OAuth para iniciar el proceso de autorización con el servicio externo.
   • Durante este proceso se abrirá una ventana de autenticación del servicio externo donde se debe aprobar el acceso.
   • Una vez finalizado, el estado de la conexión debe mostrarse como:
   • oauth_ok
   • Esto indica que la conexión se realizó correctamente.

Importar las herramientas disponibles del servidor MCP

Una vez creada la conexión, debes importar las funciones disponibles en el servidor MCP.

1. En la sección Herramientas MCP haz clic en: Listar herramientas
   • Esto consultará el servidor MCP y mostrará el catálogo de funciones disponibles.
2. Por ejemplo, en integraciones con plataformas como Notion o Zapier pueden aparecer herramientas como: notion-search,notion-fetch, notion-create-pages, notion-update-page, notion-create-database, notion-create-comment, notion-get-users
   • Marca las herramientas que deseas habilitar dentro de wolkvox.
   • Estas herramientas serán las que podrán ejecutarse desde los flujos de wolkvox Studio.

Haz clic en Guardar configuración para almacenar las herramientas seleccionadas.

Usar el componente MCP dentro de wolkvox Studio

Una vez configurada la integración, puedes utilizar el componente dentro de tus flujos conversacionales. Accede a wolkvox Studio y abre el routing point donde deseas utilizar la integración.

1. El componente MCP se encuentra dentro del grupo de componentes: Cognitivos
2. Arrastra el componente MCP Client al lienzo del flujo en la posición donde deseas ejecutar la integración.

Configurar el componente MCP en el flujo

Para configurar el componente:

1. Haz doble clic sobre el componente MCP en el flujo.
2. Se abrirá la ventana de configuración. Los campos disponibles son:
   • Conexión MCP: Permite seleccionar la conexión previamente configurada en wolkvox Manager.
   • Instrucción base: Es la instrucción que se enviará al servidor MCP.
     • Aquí puedes utilizar variables del flujo.
     • Por ejemplo, en routing points de tipo chat, se puede usar la variable: $txt_query
       • Esta variable corresponde al mensaje que escribe el cliente en el chat.
     • El servidor MCP interpretará la instrucción y ejecutará la acción correspondiente en el sistema externo.

Probar la integración en el chatbot

Una vez configurado el flujo, deberías probar la integración utilizando la herramienta Probar ChatBot de wolkvox Studio.

En el ejemplo mostrado en las pruebas:

1. Se utilizó una conexión MCP con Zapier, la cual integraba Google Calendar.
2. El usuario escribió en el chat: ¿Qué puedes hacer por mí?

El chatbot respondió indicando las acciones disponibles, como:

• Crear eventos en Google Calendar
• Buscar eventos existentes
• Crear hojas de cálculo
• Añadir filas a hojas de cálculo

Posteriormente se solicitó crear un evento con el siguiente mensaje:

El sistema procesó la solicitud y creó el evento automáticamente en Google Calendar.

Posibles diferencias de horario en eventos creados

Durante las pruebas se observó que el evento se creó una hora después del horario indicado. Este comportamiento suele deberse a problemas relacionados con zonas horarias (timezone) en la integración. Las causas más comunes son:

Diferencia de timezone entre sistemas

Google Calendar utiliza la zona horaria configurada en la cuenta o en el calendario, mientras que el LLM o el servidor MCP puede estar usando UTC o una zona horaria diferente.

Conversión automática de tiempo

Algunas plataformas convierten automáticamente los horarios recibidos a UTC antes de enviarlos a Google Calendar.

Esto puede generar desfases de 1 hora, especialmente en regiones con horario de verano o configuraciones regionales distintas.

Cómo corregir desfases de horario en el evento creado

En estos casos, el propio cliente puede corregir el desfase directamente desde la conversación con el asistente. Si el evento fue creado con una hora incorrecta, el usuario puede solicitar el ajuste indicando explícitamente el cambio requerido. Por ejemplo, si la reunión fue programada una hora después de lo solicitado, el cliente puede escribir un mensaje como: “La hora de la reunión quedó una hora después de la pedida, ponla una hora antes”. El sistema interpretará la instrucción y ejecutará la modificación correspondiente en el calendario mediante la integración MCP, permitiendo corregir rápidamente este tipo de inconsistencias sin necesidad de intervención manual en el sistema externo.

Manejar errores usando la variable de respuesta

El componente MCP guarda automáticamente el resultado de la operación en la variable: $mcp_client_result

Dentro de esta variable se encuentra la respuesta generada por el servidor MCP. Por ejemplo: $mcp_client_result["response"]

Este valor puede utilizarse dentro del flujo para:

• Validar si la operación fue exitosa.
• Detectar errores de integración.
• Ejecutar rutas alternativas.

Puedes guardar este resultado en una variable adicional y utilizar los diferentes componentes de wolkvox Studio como Intenciones para manejar distintos escenarios según la respuesta recibida.

Consideraciones importantes

Antes de utilizar el componente MCP, debes tener en cuenta:

• Conectividad externa: El servidor MCP de destino (por ejemplo Salesforce, Zapier o Google) debe estar correctamente configurado y accesible desde wolkvox.
• Configuración de variables: Es importante mapear correctamente las variables de entrada del flujo hacia el componente MCP para asegurar que las instrucciones se interpreten correctamente.