# Conectar servidores MCP a tu bot Los servidores MCP permiten que tu bot de IA utilice herramientas de otro sistema durante conversaciones en vivo, sin que tengas que crear cada herramienta manualmente. Apuntas el bot a un servidor MCP una vez y cada herramienta que ofrece ese servidor queda disponible para el bot automáticamente. Si has utilizado Funciones personalizadas, es la misma idea, llevada un paso más allá: una función personalizada es una única herramienta que conectas tú mismo, mientras que un servidor MCP es un paquete de herramientas listo para usar que el bot puede descubrir y llamar por sí solo. --- ## ¿Qué es un servidor MCP? MCP (Model Context Protocol) es un estándar abierto para dar a los asistentes de IA acceso a herramientas externas. Muchas aplicaciones y servicios modernos publican ahora un "servidor MCP": una única dirección web que expone un conjunto de herramientas que la IA puede llamar: buscar algo, obtener un registro, ejecutar una consulta, crear un elemento. En lugar de describir cada herramienta al bot, le proporcionas a Your AI Connector la dirección del servidor y una clave de acceso. Your AI Connector le pregunta al servidor "¿qué puedes hacer?", obtiene la lista de herramientas y las pone a disposición de tu bot. Cuando el servidor añade una nueva herramienta, tu bot puede usarla sin necesidad de configuración adicional por tu parte. **Funciones personalizadas frente a servidores MCP: cuál usar:** | | Funciones personalizadas | Servidores MCP | | ------------------ | --------------------------------------------------- | -------------------------------------------------------------- | | **Lo que configuras** | Una herramienta a la vez, totalmente a mano (URL, entradas, mapeo de respuestas). | Una dirección de servidor: el bot descubre todas sus herramientas por ti. | | **Ideal para** | Una llamada única y específica a tu propio sistema. | Conectarse a un servicio que ya utiliza MCP y ofrece muchas herramientas. | | **Mantenimiento** | Actualizas la función cuando la herramienta cambia. | Las nuevas herramientas del servidor aparecen automáticamente. | Puedes usar ambas al mismo tiempo en el mismo Agente. --- ## Cómo funciona (la versión sencilla) 1. **Registras un servidor MCP** en la página de **Servidores MCP**: su dirección web y un encabezado de autorización (normalmente una clave API). 2. Your AI Connector **se conecta y descubre** las herramientas del servidor, y recuerda la lista. 3. **Habilitas el servidor en un Agente**. 4. Durante una conversación, cuando el cliente solicita algo que una herramienta puede responder, **el bot llama a la herramienta**, lee el resultado y responde de forma natural. El cliente nunca ve el mecanismo; simplemente recibe una respuesta respaldada por información real y actualizada. ### Cuánto cuesta una llamada a una herramienta MCP Una llamada a una herramienta desde un servidor MCP se factura exactamente igual que una llamada a una función personalizada, según el nivel de calidad de IA de su agente: | Nivel de calidad de IA | Créditos por llamada a herramienta MCP | Con su propia clave de Anthropic (BYOK) conectada | |---|---|---| | Pro | 1 crédito | 0 créditos: se ejecuta con su clave | | Economy (obsoleto) | 0,5 créditos | 0 créditos: se ejecuta con su clave | | Max | 0,25 créditos | sigue siendo 0,25 créditos, se factura incluso con su propia clave conectada, porque Max se ejecuta en nuestro propio modelo | | Mini | 0,15 créditos | sigue siendo 0,15 créditos, se factura incluso con su propia clave conectada, porque Mini se ejecuta en nuestro propio modelo | --- ## Añadir un servidor MCP (paso a paso) En la barra lateral principal, bajo **AI Studio**, haz clic en **Servidores MCP**. Luego haz clic en **+ Añadir servidor**. Rellene el formulario: | Campo | Qué introducir | Ejemplo | | -------------------- | ----------------------------------------------------------------------------- | --------------------------------- | | **Nombre** | Una etiqueta corta para el servidor (también usada para nombrar sus herramientas para el bot). | `Order System` | | **URL del servidor** | La dirección MCP del servidor (a veces llamada "endpoint"), empezando por `https://`. | `https://tools.mystore.com/mcp` | | **Nombre del encabezado de autenticación** | El encabezado que el servidor espera para la autenticación. Déjalo como `Authorization` a menos que la documentación del servidor indique lo contrario. | `Authorization` | | **Valor del encabezado de autenticación**| La credencial en sí, en el formato que el servidor espera. | `Bearer sk_live_abc123` | ### Elegir cómo iniciar sesión: clave de API u OAuth Your AI Connector admite dos formas de autenticarse con un servidor. Elige la que indique la documentación del servidor, utilizando la opción **Autenticación** en la parte superior del formulario: - **Clave API / encabezado:** el método original descrito anteriormente. Pegas una credencial fija (una clave API o token) en el campo **Valor del encabezado de autenticación**, y Your AI Connector la envía en cada solicitud. Es la mejor opción para servidores que te proporcionan una clave de larga duración. - **OAuth (iniciar sesión):** para servidores que te piden iniciar sesión en lugar de pegar una clave. Con OAuth no hay ninguna clave que copiar: apruebas el acceso iniciando sesión, de la misma forma que funciona "Iniciar sesión con Google" en otros sitios. **Para conectarse con OAuth:** 1. Elija **OAuth** como método de autenticación. Los campos de encabezado de autenticación (Auth Header) desaparecerán y serán reemplazados por una tarjeta **Conectar** (Connect); no necesitará una clave. 2. Rellena el **Nombre** y la **URL del servidor**, luego haz clic en **Guardar**. El servidor se añade a tu lista, pero aparece como **no conectado** por ahora. 3. Haz clic en **Conectar** en el servidor. Se abrirá una ventana de inicio de sesión segura donde deberás aprobar el acceso. 4. Aprueba y la ventana se cerrará sola. El servidor aparecerá ahora como conectado y Your AI Connector cargará sus herramientas. Eso es todo. Your AI Connector mantiene la conexión actualizada automáticamente en segundo plano, por lo que normalmente no tendrás que volver a tocarla. Si un servidor pierde la conexión (por ejemplo, si el inicio de sesión caduca o alguien lo revoca desde el lado del servidor), aparecerá como desconectado; simplemente haz clic en **Reconectar** e inicia sesión de nuevo. Si el servidor no se puede configurar automáticamente al hacer clic en Conectar, se le pedirá que pegue algunos detalles (una dirección de inicio de sesión y un ID de cliente) que proporciona la propia documentación del servidor, y luego Conectar finalizará el inicio de sesión. ### Probar la conexión Antes de guardar, haz clic en **Probar conexión**. Your AI Connector contactará con el servidor y te mostrará la lista de herramientas que ofrece. Esta es la forma más rápida de confirmar que tu URL y tu clave son correctas; si la conexión falla, verás el mensaje de error ahí mismo en lugar de descubrirlo a mitad de una conversación. Cuando la prueba tenga éxito, haga clic en **Guardar**. Su servidor aparecerá en la lista con un punto de estado verde y el número de herramientas que ofrece. ### Lectura de la lista de servidores Cada servidor de la lista muestra: - Un **punto de estado**: verde cuando la última conexión funcionó, rojo cuando el último intento falló (pase el ratón por encima para ver el error), gris antes de la primera conexión exitosa. - La **dirección del servidor** y cuántas herramientas ofrece actualmente. - Un **interruptor de encendido/apagado** para habilitar o deshabilitar rápidamente todo el servidor sin eliminarlo. Your AI Connector actualiza la lista de herramientas de cada servidor en segundo plano aproximadamente una vez al día, por lo que las nuevas herramientas aparecen por sí solas. Un servidor lento o temporalmente inaccesible nunca detendrá una conversación: el bot simplemente utiliza la última lista de herramientas conocida y recurre a una alternativa sin problemas si una llamada no puede completarse. ### Elegir qué herramientas puede usar el bot Un servidor suele ofrecer más herramientas de las que desea que el bot utilice. Puede activar o desactivar herramientas individuales sin desconectar todo el servidor. 1. Haga clic en el icono del **lápiz (editar)** en el servidor dentro de la lista. 2. Desplácese hasta la sección **Herramientas**: se enumeran todas las herramientas que ofrece el servidor, cada una con su propio interruptor de encendido/apagado. 3. Desactive cualquier herramienta que no desee que el bot utilice, o use **Habilitar todas** / **Deshabilitar todas** para configurarlas de una sola vez. 4. Haga clic en **Guardar cambios**. Solo las herramientas que deje activadas se ofrecerán al bot. Una herramienta desactivada es completamente invisible para el bot: no puede llamarla y no contará para el límite de 40 herramientas. Dos cosas que vale la pena saber: - **Las nuevas herramientas permanecen desactivadas hasta que las enciendes.** Una vez que has seleccionado las herramientas de un servidor, cualquier herramienta que el servidor añada más tarde llegará desactivada, por lo que nada nuevo estará disponible para el bot hasta que decidas habilitarlo. (Los servidores que nunca has seleccionado mantienen todas sus herramientas encendidas, exactamente como antes.) - **Esto es independiente de la elección del Agente a continuación.** Aquí decides qué herramientas de un servidor existen a nivel de cuenta; en el Agente decides a qué servidores puede acceder ese Agente y, si lo deseas, restringir sus herramientas aún más solo para ese Agente. ### Configuración de límites de ejecución por herramienta Junto al interruptor de encendido/apagado de cada herramienta, encontrará un control de **Límites**. Abre los mismos límites de ejecución que puede establecer en una [función personalizada](custom-functions.md#execution-limits), aplicados solo a esa herramienta; es útil cuando la herramienta de un servidor llama a un servicio externo de pago, o cuando una herramienta solo debe ejecutarse una vez por conversación. Todo aquí es opcional; déjelo vacío y la herramienta se comportará exactamente igual que antes. - **Solo lectura.** Algunos servidores declaran para cada herramienta si solo lee datos. **Automático (ajuste del servidor)** confía en esa declaración; puede anularla de cualquier manera: marque una herramienta como **Solo lectura** cuando sepa que nunca crea ni cambia nada (esto permite a la IA reintentar de forma segura una respuesta interrumpida en lugar de dejar al cliente sin respuesta), o como **No solo lectura** cuando no confíe en la afirmación del servidor. - **Servir resultado en caché en llamadas repetidas.** Cuando la IA llama a la herramienta de nuevo con las mismas entradas, se reutiliza el resultado anterior (hasta por 24 horas) en lugar de llamar al servidor nuevamente. - **Máximo de ejecuciones por conversación** y **máximo de ejecuciones por ventana de tiempo** funcionan exactamente igual que en las funciones personalizadas: solo ejecuciones exitosas, y cuando se alcanza un límite, se le informa a la IA el motivo y responde con la información que ya tiene; el cliente nunca se queda esperando. Las conversaciones de prueba están exentas. Una nota honesta sobre la confianza: los límites controlan si llamamos al servidor y con qué frecuencia, pero no pueden cambiar lo que el servidor hace internamente una vez que se le llama. Además, anular una herramienta de terceros a Solo lectura es una afirmación más fuerte que en su propia función personalizada, porque es código de otra persona; hágalo solo para herramientas que comprenda. --- ## Habilitar un servidor en un Agente Registrar un servidor lo hace disponible; tú sigues eligiendo qué Agentes pueden usarlo. 1. Abra el [Agente](../ai-agents/ai-agents.md) y vaya a su pestaña **Habilidades de IA** (AI Abilities). (Para una campaña que aún mantiene su propia configuración de IA directamente en lugar de a través de un Agente separado, la misma lista aparece en el paso **Habilidades de IA** de esa campaña). 2. Busque la sección **Servidores MCP**. 3. Active cada servidor que desee que el bot de este Agente pueda utilizar. 4. Haga clic en **Guardar cambios**: las selecciones solo se aplican una vez guardadas. Puedes habilitar hasta **5 servidores por Agente**. Solo los servidores que habilites estarán disponibles para el bot de ese Agente, lo que mantiene al bot enfocado en las herramientas que son relevantes. ### Elegir qué herramientas puede usar un Agente Una vez que un servidor está habilitado en un Agente, también puedes restringir **cuáles de sus herramientas** puede llamar ese Agente en particular; esto es útil cuando un Agente solo debe leer datos mientras que otro también puede crear registros. 1. En la pestaña **Habilidades de IA**, bajo el servidor habilitado, haz clic en la fila **"… herramientas habilitadas para este agente"** para expandir la lista de herramientas. 2. Desactiva cualquier herramienta que este Agente no deba usar, luego haz clic en **Guardar cambios**. Dos reglas mantienen esto predecible: - **Un Agente solo puede restringir, nunca ampliar.** Las herramientas que desactivaste a nivel de cuenta (en la página de Servidores MCP) no aparecen aquí y no pueden volver a habilitarse para un solo Agente. - **Los Agentes heredan por defecto.** Un Agente en el que no has tocado la lista de herramientas simplemente sigue la selección a nivel de cuenta, incluyendo las herramientas que habilites allí más tarde. Una vez que restringes la lista de un Agente, las nuevas herramientas permanecen desactivadas para ese Agente hasta que las habilites. --- ## Ejemplo listo para usar: Conectar una tienda Shopify Cada tienda Shopify viene con un servidor MCP integrado; no hay ninguna aplicación que instalar ni ninguna clave que crear. Shopify lo aloja en la propia dirección web de la tienda con `/api/mcp` añadido al final. Lo que el bot obtiene de él: - **Búsqueda de productos**: encuentre productos describiendo lo que el cliente quiere ("una chaqueta de running cálida por menos de 100 $"), con precios, variantes y existencias en tiempo real. - **Detalles del producto**: información completa sobre un producto específico, incluidas las opciones y la disponibilidad. - **Políticas de la tienda y preguntas frecuentes**: respuestas a preguntas sobre envíos, devoluciones, reembolsos y privacidad, extraídas de las propias páginas de la tienda. - **Carrito**: cree un carrito para el cliente y facilítele un enlace de pago. Para conectar una, añada un servidor con: | Campo | Qué introducir | |---|---| | **Nombre** | `Shopify Store` (o el nombre de la tienda) | | **URL del servidor** | La dirección web de la tienda más `/api/mcp`; por ejemplo, `https://mystore.com/api/mcp`. La dirección técnica de la tienda también funciona: `https://mystore.myshopify.com/api/mcp`. | | **Autenticación** | Deje seleccionada la opción **API key / header** y deje vacío el campo **Auth Header Value**; este servidor no necesita ninguna clave. | Guarde, haga clic en **Test Connection** y habilite el servidor en su agente; esa es toda la configuración. Dos cosas que debe saber: - **Los pedidos no están en este servidor.** Shopify mantiene deliberadamente los datos de los pedidos fuera de este punto de conexión público. Para preguntas del tipo "¿dónde está mi pedido?", combine este servidor con una función personalizada; consulte el [ejemplo de estado de pedido de Shopify](custom-functions.md#complete-example-shopify-order-status). - **Funciona para cualquier tienda Shopify**, incluida la tienda de un cliente si usted gestiona cuentas para otros. Todo lo que necesita es la dirección web de la tienda. --- ## Seguridad: solo conecte servidores en los que confíe Un servidor MCP que usted conecte puede ser llamado por su bot y puede devolver texto que el bot lee y sobre el que actúa. Trátelo como cualquier otra integración que posea una clave de acceso a sus sistemas: - **Registre únicamente servidores que controle o en los que confíe plenamente.** La descripción de una herramienta la escribe quien administra el servidor, y el bot lee esas descripciones para decidir cuándo usar una herramienta. - **Utilice una clave de API dedicada y limitada**, no una credencial de administrador. Su clave se almacena de forma segura y nunca se muestra en las exportaciones de datos. Lo mismo se aplica a los inicios de sesión mediante OAuth: los tokens de acceso se almacenan de forma segura y se omiten en cualquier exportación. - **La URL debe ser una dirección `https://` pública.** Las direcciones internas, localhost y de redes privadas se rechazan por motivos de seguridad. - **Desactive un servidor en el momento en que deje de confiar en él**: desactívelo o elimínelo, y desaparecerá de todos los Agentes inmediatamente. --- ## Solución de problemas - **Punto de estado rojo / error de conexión:** Vuelva a abrir el servidor y haga clic en **Test Connection** para ver el error exacto. Las causas más comunes son una clave incorrecta o caducada, un error tipográfico en la URL o que el servidor requiera un nombre de encabezado distinto a `Authorization`. - **Un servidor OAuth dejó de funcionar / le pide volver a conectarse:** Los inicios de sesión OAuth pueden ser revocados o caducar en el lado del servidor. Abra el servidor y haga clic en **Connect** de nuevo para volver a iniciar sesión. Tenga en cuenta que los inicios de sesión OAuth nunca se copian entre cuentas, por lo que los servidores de un Agente o campaña copiados deben volver a conectarse en la cuenta a la que los copió. - **El bot no está usando una herramienta:** Primero verifique que la herramienta esté activada en la sección **Tools** del servidor (edite el servidor para ver la lista); una herramienta desactivada es invisible para el bot. Luego, asegúrese de que el servidor esté habilitado en ese Agente específico y que la solicitud del cliente coincida claramente con lo que hace la herramienta. Al igual que con las funciones personalizadas, los nombres y descripciones claros de las herramientas en el lado del servidor ayudan al bot a elegir correctamente. - **Una herramienta que ofrece el servidor no aparece para el bot:** Si ha seleccionado las herramientas de este servidor, recuerde que cualquier herramienta añadida después de su selección llega desactivada. Edite el servidor, abra la sección **Tools** y actívela. - **¿El conector maneja sesiones HTTP MCP?** Sí. Si su servidor emite un encabezado `mcp-session-id` cuando se establece la conexión, lo almacenamos y lo enviamos de vuelta en cada solicitud posterior, junto con el encabezado `MCP-Protocol-Version`. Los servidores con estado funcionan sin ninguna configuración adicional por su parte. - **Se omitió una herramienta:** Un Agente puede usar como máximo 5 servidores y 40 herramientas MCP a la vez. Si un servidor ofrece una gran cantidad de herramientas, es posible que algunas no se carguen; desactive las herramientas que no necesite en la sección **Tools** del servidor o mantenga cada servidor enfocado en las herramientas que realmente utiliza. --- ## Requisitos del plan Los servidores MCP forman parte del conjunto de herramientas para desarrolladores, junto con las funciones personalizadas. Si no ve **Servidores MCP** en la sección AI Studio de la barra lateral, su plan actual no lo incluye; actualice a un plan con herramientas para desarrolladores para activarlo. --- ## Próximos pasos - [Funciones personalizadas](custom-functions.md) — configure una herramienta individual manualmente en lugar de conectar un servidor completo. - [Agentes de IA](../ai-agents/ai-agents.md) — donde se habilitan los servidores MCP para un bot. - [Agentes de IA](../ai-agents/ai-agents.md) — la página principal del grupo AI Studio donde residen los Servidores MCP.