La pestaña Capacidades (skills) de un Agente de IA reúne todo lo que le da capacidades adicionales: las integraciones y las MCP, que le permiten realizar acciones en sistemas externos, y las lógicas, que controlan el flujo del proceso. Trabajar con servicios externos tiene dos momentos: primero integrar el servicio al proyecto, es decir, vincular la cuenta una sola vez, y luego conectar esa integración al agente, habilitando sus acciones y describiendo cuándo usarlas.

Puedes:

• Integrar servicios externos al proyecto (Google Calendar, Gmail, Google Sheets, entre otros).
• Conectar integraciones y MCP a uno o más Agentes de IA.
• Usar tus propias acciones de código como MCP internas.
• Conectar servidores MCP externos para llegar a sistemas propios de tu empresa.
• Crear y usar lógicas: instrucción y condicional.
• Adicionar herramientas (skills) y lógicas dentro de un estado del Funnel.

Requisitos previos

Acceso a tu cuenta de Botmaker con permisos para administrar integraciones del proyecto.

Al menos un Agente de IA creado, al que vayas a conectarle las capacidades.

Las credenciales de la cuenta del servicio externo que vas a vincular (por ejemplo, el usuario de Google que administra el calendario del negocio).

Para las MCP internas, tener acciones de código ya creadas en el proyecto. Para las MCP externas, la URL del servidor MCP y sus datos de autenticación, que te tiene que dar el equipo técnico que lo administra.

Conceptos clave

Integrar: vincular la cuenta de un servicio externo al proyecto. Se hace una sola vez y deja la integración disponible para todos tus agentes.

Conectar: habilitar una integración ya disponible dentro de un agente, seleccionando sus acciones y describiendo cuándo usarlas.

Acción: cada cosa concreta que el agente puede ejecutar en el servicio externo (por ejemplo, consultar disponibilidad o crear un evento en un calendario).

MCP (Model Context Protocol): estándar que permite que tu Agente de IA use herramientas de otros sistemas sin que tengas que programar la conexión desde cero. Cada MCP le suma al agente un conjunto de acciones que puede ejecutar durante la conversación. En Botmaker hay dos tipos: internas y externas.

MCP internas: las que viven dentro de Botmaker. Ahí encuentras las acciones de código propias que creaste en tu proyecto, escritas en JavaScript o Python.

MCP externas: servidores MCP que ya existen fuera de Botmaker y que conectas indicando su URL. Sus herramientas ya están creadas: al conectar el servidor, pasan a estar disponibles para tu agente. Se usan para llegar a sistemas propios de tu empresa, por ejemplo el stock de tu tienda o tu CRM privado.

Lógicas: nodos que controlan qué hace el agente y cómo avanza. Hay tres tipos: instrucción, condicional y bucle. Ahora se gestionan dentro de Capacidades (skills).

Cómo integrar y conectar un servicio externo

Paso 1: Integra el servicio al proyecto

Vincula la cuenta del servicio externo a tu proyecto. Este paso autoriza a Botmaker a usar ese servicio en tu nombre y deja la integración disponible para conectarla después a tus agentes. Se hace una sola vez por proyecto: si ya integraste Google Calendar, no necesitas repetirlo para cada agente.

Nota: otorgar permisos a un servicio externo implica autorizar el acceso a esa cuenta. Hazlo solo con cuentas propias del negocio y revisa los permisos que se solicitan.

Paso 2: Abre la pestaña Capacidades (skills) del agente

Ingresa al Agente de IA y abre la pestaña Capacidades (skills). Allí verás las integraciones, las MCP y las lógicas disponibles para ese agente. Que una integración aparezca en la lista significa que ya está vinculada al proyecto, no que el agente la esté usando: eso lo defines en el paso siguiente.

Paso 3: Conecta la integración y habilita sus acciones

Conecta la integración que vayas a usar y selecciona las acciones concretas que el agente podrá ejecutar, por ejemplo consultar disponibilidad o crear un evento. Después describe en qué casos debe usar cada una.

Esa descripción es lo que le permite al agente decidir cuándo recurrir a cada acción, así que conviene ser concreto: en lugar de “consulta la agenda”, escribe “úsala cuando el cliente pida un turno y ya haya indicado el día que prefiere”.

Nota: habilita solo las acciones que el agente realmente necesita para su proceso. Cuantas menos opciones tenga, más precisa es su decisión de cuál usar en cada momento.

Paso 4: Pruébalo

Prueba el comportamiento desde el botón Probar del orquestador y verifica, en el razonamiento, que el agente ejecute la acción externa cuando corresponde. El razonamiento te muestra qué herramienta eligió y con qué datos la llamó, así que si el agente no usa la acción que esperabas, ahí vas a ver por qué.

Nota: si vas a conectar una casilla de correo, la vinculación se realiza a través de Mailbot; luego vuelves a Agentes de IA para continuar.

Cómo conectar MCP a tu agente

Además de las integraciones listas para usar, dentro de Capacidades (skills) puedes sumarle a tu agente herramientas propias mediante MCP. Hay dos formas de hacerlo, y cada una resuelve una necesidad distinta:

• MCP internas: herramientas que creas y viven dentro de Botmaker, a partir de tus acciones de código en JavaScript o Python.
• MCP externas: herramientas que ya existen en un servidor MCP fuera de Botmaker y que conectas indicando su URL. Son el camino para que el agente consulte sistemas propios de tu empresa, como el stock de una tienda o un CRM privado.

La diferencia práctica es dónde vive la herramienta: en las internas el código es tuyo y corre dentro de Botmaker; en las externas el sistema ya está construido de tu lado y Botmaker solo se conecta a él.

Nota: en los dos casos, sumar la MCP es solo la primera mitad del trabajo. Después tienes que conectarla al agente desde Capacidades (skills) y describir cuándo debe usar cada herramienta, igual que con cualquier integración.

MCP internas: usa tus propias acciones de código

Ingresa al Agente de IA, abre la pestaña Capacidades (skills) y entra en MCP internas. Allí verás listadas las acciones de código que ya creaste dentro de tu proyecto, en JavaScript o en Python.

Cada acción de código es una función que escribiste tú para resolver algo puntual: calcular un descuento, validar un número de documento o armar un mensaje con datos de tu negocio. Al exponerlas como MCP interna, tu agente puede ejecutarlas durante la conversación.

Si todavía no tienes acciones de código creadas, esta sección aparecerá vacía. Primero necesitas crearlas en tu proyecto: para aprender a hacerlo, te recomendamos el curso “Acciones de código” de Botmaker Academy

Conecta la acción que quieras habilitar y describe en qué casos el agente debe usarla, con el mismo criterio que en las integraciones: cuanto más concreta sea la descripción, mejor decide el agente.

MCP externas: conecta un servidor MCP de tu empresa

En MCP externas conectas servidores MCP que ya existen fuera de Botmaker. Las herramientas no las creas aquí: ya están construidas en ese servidor y, al conectarlo, pasan a estar disponibles para tu agente.

Paso 1: Haz clic en Crear

Dentro de Capacidades (skills) → MCP externas, haz clic en Crear. Se abrirá el formulario de conexión.

Paso 2: Completa los datos del servidor MCP

Vas a encontrar cuatro campos. Complétalos así:

• URL del MCP: la dirección del servidor al que te quieres conectar. Es el dato que define a qué sistema llega tu agente, así que pídeselo al equipo técnico que administra ese servidor.
• Nombre: cómo vas a identificar esta MCP dentro de Botmaker. Usa un nombre que diga qué sistema es, por ejemplo “Stock tienda online” o “CRM interno”, para reconocerlo fácilmente cuando lo conectes a distintos agentes.
• Descripción: para qué sirve ese servidor y qué tipo de información o acciones ofrece. Escríbela pensando en el agente: cuanto más claro esté qué resuelve, mejor va a decidir cuándo usarlo.
• Tipo de autenticación: cómo Botmaker se identifica ante ese servidor para tener permiso de usarlo. Elige el que corresponda al servidor que estás conectando; si eliges uno distinto al que ese servidor espera, la conexión se rechaza.

Paso 3: Conecta la MCP al agente y habilita sus herramientas

Crear la MCP la deja disponible en el proyecto, pero todavía no la usa ningún agente. Vuelve a la pestaña Capacidades (skills) del Agente de IA, conéctala y selecciona las herramientas concretas que quieres habilitar, describiendo en qué casos debe usarlas.

Paso 4: Pruébalo

Prueba el comportamiento desde el botón Probar del orquestador y verifica, en el razonamiento, que el agente llame a la herramienta del MCP cuando corresponde y que la respuesta del servidor llegue completa.

Cómo usar las lógicas

Las lógicas controlan cómo avanza el proceso del agente y se gestionan dentro de Capacidades (skills). Hay tres tipos:

• Instrucción: indica al agente una tarea puntual, descrita en lenguaje natural.
• Condicional: abre distintos caminos según se cumpla o no una condición.
• Bucle: repite un conjunto de pasos, por ejemplo recorrer una lista, hasta cumplir una condición.

Además de gestionarlas en esta pestaña, puedes adicionar una lógica dentro de un estado del Funnel, desde la sección Instrucciones para el agente. Es el camino recomendado cuando la lógica solo aplica a un momento puntual del proceso y no a todo el agente.

Consideraciones importantes

• Integrar no es conectar: integrar vincula la cuenta al proyecto y se hace una sola vez; conectar habilita esa integración dentro de un agente puntual. Si el agente no ve una herramienta que ya integraste, casi siempre falta el paso de conectarla.
• Las integraciones dependen del servicio externo: si el servicio presenta una interrupción, el agente puede informar que no puede completar la acción de forma temporal. No es un error de configuración.
• Las MCP externas dependen de un sistema que no administra Botmaker: si el servidor está caído, cambia su URL o modifica sus herramientas, el agente tampoco podrá completar la acción. Ante un comportamiento raro, revisa primero el estado de ese servidor.
• Cuida los permisos y los datos: una MCP externa puede dar acceso a información sensible de tu negocio. Conecta solo servidores propios o de proveedores de confianza, y usa credenciales con los permisos mínimos necesarios.
• La descripción no es un detalle: tanto en integraciones como en MCP, la descripción de cuándo usar cada acción es lo que guía la decisión del agente. Si el agente no usa una herramienta que esperabas, empieza por revisarla.

Para conocer más sobre las acciones de código que se exponen como MCP internas, te compartimos el curso “Acciones de código” de Botmaker Academy.

Recuerda visitar nuestro Centro de Ayuda para mayor información