Añade tu propio servidor MCP

Conecta un servidor MCP remoto por URL y elige qué puede hacer el Agente de Runner con cada una de sus herramientas.

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

Abre tu proyecto y selecciona Agente → Herramientas.
En la fila Añade tu propio servidor MCP, selecciona Añadir servidor.
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.
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.
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.
Qué agentes pueden usarlo muestra Todos los agentes. Puedes cambiarlo por agente más adelante.
Selecciona Confío en este servidor.
Selecciona Conectar y buscar herramientas. Runner se conecta al servidor y muestra sus herramientas.
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.