--- lastModified: 2026-11-13 title: Añade tu propio servidor MCP description: Conecta un servidor MCP remoto por URL y elige qué puede hacer el Agente de Runner con cada una de sus herramientas. seo: description: "Conecta tu propio servidor MCP remoto a Runner por URL, con o sin clave de API, y pon cada herramienta en Permitir, Preguntar antes o Desactivado antes de que el Agente pueda usarla." --- Si un servicio que usas tiene un servidor MCP, puedes dar sus herramientas al Agente de Runner. Pega la URL del servidor. Runner encuentra las herramientas del servidor. Después eliges qué puede hacer el Agente con cada herramienta. Úsalo para un servicio que no está en **Conecta tus herramientas**, como tu propio ERP, un sistema de inventario o una herramienta que gestiona tu equipo. ## Antes de empezar **Ruta de entrada:** **Proyecto → Agente → Herramientas → Añade tu propio servidor MCP** Necesitas: - el rol de propietario de la tienda o de administrador. Los demás miembros no pueden añadir, cambiar ni quitar un servidor; - la URL de un servidor MCP remoto, como `https://example.com/mcp`; y - la clave de API y el nombre de su cabecera, si el servidor necesita una clave. El servidor debe cumplir estas condiciones: - Debe estar en internet público. Runner no se conecta a `localhost` ni a una dirección de red privada. - Debe usar el transporte HTTP de MCP (Streamable HTTP). Runner no ejecuta por ti un servidor local de línea de comandos (stdio). - Debe funcionar sin inicio de sesión o con una clave de API en una cabecera de la solicitud. **OAuth** aún no está disponible. Una tienda puede tener hasta 10 servidores MCP. Runner guarda hasta 100 herramientas de cada servidor. **Importante:** Runner no puede comprobar qué hace un servidor propio con tus datos. Añade solo servidores que gestionas o conoces bien. ## Añadir un servidor 1. Abre tu proyecto y selecciona **Agente → Herramientas**. 2. En la fila **Añade tu propio servidor MCP**, selecciona **Añadir servidor**. 3. Introduce la **URL del servidor**. O pega la configuración JSON de la documentación del servidor en **Pegar configuración JSON**. Runner rellena la URL y la cabecera de la clave a partir de la configuración. 4. Opcional: introduce un **Nombre**. Si lo dejas vacío, Runner usa el nombre del propio servidor. Runner muestra este nombre en el chat cuando usa una herramienta. 5. En **Cómo inicia sesión Runner**, selecciona **Sin inicio de sesión** o **Clave de API**. Para **Clave de API**, introduce el **Nombre de la cabecera** y la **Clave**, como `Authorization` y `Bearer sk-…`. Runner guarda la clave cifrada. Nadie, ni siquiera tú, puede volver a leerla. 6. **Qué agentes pueden usarlo** muestra **Todos los agentes**. Puedes cambiarlo por agente más adelante. 7. Selecciona **Confío en este servidor**. 8. Selecciona **Conectar y buscar herramientas**. Runner se conecta al servidor y muestra sus herramientas. 9. Elige una regla para cada herramienta. Después selecciona **Añadir** seguido del nombre del servidor. Cuando el servidor se añade, aparece en **Conectadas** con la etiqueta **MCP propio**. ## Elegir qué puede hacer cada herramienta Cada herramienta tiene una de tres reglas: - **Permitir:** el Agente usa la herramienta sin preguntarte. - **Preguntar antes:** el Agente te muestra la llamada en el chat. La herramienta solo se ejecuta cuando la apruebas. - **Desactivado:** el Agente no puede usar la herramienta. Runner deduce una regla inicial a partir del nombre de cada herramienta y agrupa las herramientas según esa regla: | Grupo | Regla inicial | Nombres de herramientas que Runner pone aquí | | --- | --- | --- | | **Lee datos** | **Permitir** | Nombres que empiezan con una palabra de lectura, como `list`, `get` o `search`. También todo nombre que Runner no reconoce. | | **Cambia datos** | **Preguntar antes** | Nombres que contienen `send`, `reply`, `remove`, `publish`, `pay`, `charge`, `refund` o `price`. | | **Borra datos** | **Desactivado** | Nombres que contienen `delete` o `trash`. | **Comprueba la regla de cada herramienta antes de añadir el servidor.** Runner solo lee el nombre de la herramienta, no lo que hace. Una herramienta como `update_inventory` o `create_customer` empieza en **Permitir** dentro de **Lee datos**, así que el Agente podría cambiar datos sin preguntarte. Pon herramientas como estas en **Preguntar antes** o **Desactivado**. Puedes cambiar la regla de cualquier herramienta antes de añadir el servidor. Más adelante, cámbiala en **Lo que cualquier agente puede hacer** en la página del servidor. Una herramienta que el servidor añada más tarde empieza en **Preguntar antes**, o en **Desactivado** si su nombre contiene `delete` o `trash`. Las reglas se aplican a todos los chats de este proyecto. Runner las comprueba en cada llamada a una herramienta. ## Gestionar un servidor Abre el servidor desde **Conectadas** en **Agente → Herramientas**. Su página tiene estos controles: | Control o dato | Qué hace | | --- | --- | | URL del servidor y botón de copiar | En **Conexión**. **Copiar URL del servidor** copia la URL. | | **Estado** | Muestra cuándo respondió el servidor por última vez, o **Aún sin comprobar**. | | **Inicio de sesión** | Muestra **Sin inicio de sesión** o los cuatro últimos caracteres de la clave. **Añadir clave** o **Reemplazar** cambia la clave. | | **Probar conexión** o **Actualizar herramientas** | Vuelve a conectarse al servidor y obtiene su lista actual de herramientas. Las herramientas nuevas empiezan en **Preguntar antes**, o en **Desactivado** si son herramientas de borrado. | | **Quitar servidor** | Quita el servidor. Los agentes pierden sus herramientas y se borran sus reglas. Puedes volver a añadirlo más tarde. | ## Si algo sale mal | Mensaje | Qué hacer | | --- | --- | | **Introduce la URL completa del servidor, como https://example.com/mcp.** | Introduce la URL completa, incluida la ruta. | | **Runner solo puede acceder a servidores públicos. Esta URL apunta a una red privada.** | Usa una URL a la que se pueda acceder desde internet. | | **Esta URL respondió, pero no como un servidor MCP. Revisa la ruta.** | Busca la ruta MCP en la documentación del servidor. Suele terminar en `/mcp`. | | **Runner no puede acceder a este servidor. Revisa la URL y que esté en línea.** | Asegúrate de que el servidor está en marcha y de que la URL es correcta. | | **El servidor rechazó la clave. Revisa el nombre de la cabecera y la clave.** | Revisa ambos valores. Algunos servidores necesitan `Bearer ` delante de la clave. | | **El servidor respondió, pero no tiene herramientas.** | El servidor no tiene herramientas para esta clave. Revisa la configuración del servidor. | | **Esta tienda ya tiene el máximo de servidores MCP. Quita uno primero.** | Quita un servidor que no uses. | En **Conectadas**, un servidor que ha dejado de funcionar muestra **Sin conexión** o **Clave rechazada**. Selecciona **Arreglar** para abrir el servidor y, después, reemplaza la clave o revisa el servidor. ## Guías relacionadas - [Conectar y controlar aplicaciones de agente](./agent-apps) - [Descripción general de aplicaciones e integraciones](../apps-and-integrations) - [Solucionar problemas de conexión de una aplicación](./troubleshooting)