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. Selecciona la pestaña “Integraciones”.
3. Luego abre la pestaña “Conectores MCP”.

Haz clic en “Nueva conexión” para crear la integración con el servidor MCP.

Conexión personalizada

Si deseas agregar una conexión personalizada, debes seleccionar la opción “Conector personalizado MCP avanzado”.

1. 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.
2. Tipo de autenticación: puede ser:
   • none
   • bearer
   • oauth

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

Si eliges Bearer:

• Aparecerá el campo Bearer Token, donde debes ingresar el token de autenticación.

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.

Agregar una integración desde el catálogo de aplicaciones

Además de configurar manualmente un conector personalizado mediante la URL de un servidor MCP, wolkvox Manager permite conectar servicios externos desde un catálogo de aplicaciones.

Este método simplifica la integración, ya que evita tener que ingresar manualmente el endpoint, el tipo de autenticación y otros parámetros técnicos del servidor MCP. El catálogo cuenta actualmente con 1047 aplicaciones disponibles, cada una con sus propias herramientas, servicios y permisos de conexión.

Configuración

Desde la sección de integraciones MCP en wolkvox Manager, haz clic en Agregar integración.

Se abrirá una ventana con las siguientes opciones: Selecciona “Explorar aplicaciones — Catálogo disponible”.

Se abrirá la ventana “Catálogo de aplicaciones”, en la cual podrás consultar las aplicaciones disponibles para integrar.

Cada aplicación muestra información como:

• Nombre de la aplicación.
• Cantidad de herramientas disponibles.
• Categoría o tipo de servicio.
• Botón con el ícono “+” para iniciar la conexión.

Nota: Puedes utilizar el campo “Buscar aplicaciones” para encontrar una aplicación específica. También puedes hacer clic en “Cargar más” para consultar aplicaciones adicionales del catálogo.

Ubica la aplicación que deseas conectar y haz clic en el botón con el ícono “+”.

A continuación, se abrirá dentro de la misma ventana el proceso de autenticación correspondiente a la aplicación seleccionada.

Los pasos pueden variar según el proveedor. Dependiendo de la aplicación, es posible que debas:

• Iniciar sesión con una cuenta existente.
• Escribir una dirección de correo electrónico.
• Ingresar un código de verificación.
• Autorizar el acceso mediante Google, Microsoft, Apple u otro proveedor.
• Seleccionar cuentas, espacios de trabajo, proyectos, calendarios, páginas, bases de datos u otros recursos.
• Aprobar los permisos solicitados por la aplicación.

Completa el proceso de autenticación siguiendo las instrucciones presentadas en pantalla.

Después de autenticarte, la aplicación puede solicitar que selecciones los recursos o servicios que estarán disponibles para wolkvox.

Esta configuración depende de cada aplicación. Por ejemplo, una plataforma puede solicitar permiso para:

• Consultar información.
• Crear o actualizar registros.
• Editar contenidos.
• Consultar usuarios.
• Crear comentarios.
• Administrar páginas, documentos, calendarios o bases de datos.

Revisa los permisos solicitados y selecciona únicamente los recursos que necesites integrar.

Luego, confirma la autorización para continuar.

Cuando el proceso termine correctamente, se mostrará el siguiente mensaje:

“Conexión completada. Puedes cerrar esta ventana y volver a la aplicación.”

La integración se guardará automáticamente. Cierra la ventana de conexión para regresar a wolkvox Manager.

La nueva conexión aparecerá en la tabla de integraciones.

Esta tabla contiene las siguientes columnas:

• Nombre: nombre visible asignado a la integración.
• Tipo: indica el tipo de integración. Las conexiones provenientes del catálogo se identifican como “Aplicación”.
• Estado: muestra el estado actual de la conexión. 
• Herramientas: indica la cantidad de herramientas habilitadas para la aplicación.
• Actualizado: muestra la fecha y hora de la última actualización de la integración.

Una vez listada y conectada, la aplicación podrá utilizarse desde el componente MCP de wolkvox Studio.

Para modificar una aplicación previamente integrada:

1. Ubica la aplicación en la tabla de integraciones. Haz clic derecho sobre la aplicación.
2. Selecciona “Editar”.
3. Se abrirá la ventana “Editar integración del catálogo”. En esta ventana encontrarás las siguientes opciones:
   • Nombre visible: Permite cambiar el nombre con el que la integración aparecerá dentro de wolkvox Manager y en las opciones de conexión disponibles para el componente MCP. Utiliza un nombre que permita identificar fácilmente la cuenta, el servicio o el propósito de la integración.
   • Herramientas habilitadas: Muestra todas las funciones disponibles para la aplicación integrada. Cada herramienta cuenta con un checkbox que permite activar la herramienta para que pueda utilizarse desde wolkvox o desactivar la herramienta para impedir su ejecución. Las herramientas disponibles dependen de cada aplicación. Por ejemplo, una integración puede incluir funciones para buscar información, crear registros, actualizar páginas, consultar usuarios, administrar comentarios o modificar bases de datos. Activa únicamente las herramientas requeridas por los flujos de tu operación. 
   • Después de realizar los cambios, haz clic en “Guardar configuración”.

Para eliminar una aplicación integrada:

• Ubica la aplicación en la tabla. Haz clic derecho sobre ella.
• Selecciona “Eliminar”.
• Confirma la acción cuando el sistema lo solicite.

Al eliminar una integración, las herramientas asociadas dejarán de estar disponibles para los componentes MCP que dependan de esa conexión. Antes de eliminarla, verifica que no esté siendo utilizada en flujos activos de wolkvox Studio.

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.