Servidores MCP

Qué conseguirá

Un agente podrá usar las herramientas de un servidor MCP (Model Context Protocol): consultar datos, crear registros, enviar mensajes, lo que ofrezca el servidor. Usted conecta el servidor una vez, marca las herramientas que quiere y se las da a cualquier agente como cualquier otra herramienta.

Requisitos previos

• Un servidor MCP accesible desde internet por https y su dirección (suele terminar en /mcp). El servicio que quiere usar la muestra en sus ajustes de desarrollador o de MCP.
• La clave que pide el servidor, si pide alguna: un token de acceso o una clave de API. Los servidores que le hacen iniciar sesión en una ventana del navegador (OAuth) todavía no se pueden conectar.
• Debe ser propietario o administrador. Los miembros pueden ver los servidores y probar sus herramientas, pero no cambiarlos.

Configuración paso a paso

1. Abra Tools y después la pestaña MCP servers.
2. Elija Connect server.
3. Pegue la Server address.
4. Elija How does it sign you in?: Access token (Authorization: Bearer) para la mayoría de los servidores, Key in a header I choose si el servicio indica una cabecera (entonces escriba el Header name, por ejemplo X-API-Key), o No key.
5. Escriba el Access token o la Key. Ponga un Name si quiere uno propio.
6. Elija Connect. Phynxa se conecta, pregunta al servidor qué ofrece y lo guarda. Si no puede conectarse, el cuadro de diálogo explica por qué y no se guarda nada.

Elegir las herramientas

Bajo el servidor, elija Show tools. Cada herramienta muestra qué hace y qué rellenará el agente (un signo de interrogación significa opcional). Marque las que quiera y elija Add tool. Ya aparecen en Tools, API tools, como cualquier otra herramienta, y puede cambiarles el nombre, la descripción y el tiempo de espera.

Una herramienta marcada como Can't be used by an agent necesita algo que un agente no puede darle, y se muestra el motivo.

Dar las herramientas a un agente

Abra el agente, pestaña Tools, Add tool, y elija MCP. Elija el servidor, marque sus herramientas y elija Add tool, después Save en el agente. En un agente de WhatsApp, haga lo mismo en su pestaña Tools (consulte Crear un agente de WhatsApp).

En una llamada el agente espera la respuesta, salvo que active Run in the background en la página de la herramienta. En WhatsApp siempre espera.

Nota. Un agente de WhatsApp responde a todos los clientes, así que dele solo herramientas que no le importe que cualquier cliente provoque.

Gestionar un servidor

• El interruptor apaga y enciende un servidor. Mientras está apagado sus herramientas no se ejecutan y el agente lo sabe.
• Reconnect vuelve a conectar y a listar las herramientas. Úselo cuando el servicio añada o cambie herramientas. Las herramientas ya añadidas reciben los nuevos datos de entrada; los nombres y descripciones que usted escribió se conservan.
• Edit cambia el nombre, la dirección o la clave. Una clave que deje vacía se conserva.
• Remove elimina el servidor y todas las herramientas creadas con él. Los agentes que las usaban las pierden.

Un aviso rojo en el servidor muestra el último problema y un botón Reconnect. El estado también cambia solo: una llamada que falla porque el servidor está caído lo marca, y la siguiente que funcione lo limpia.

Qué conviene saber

• Su clave es privada. Se guarda cifrada, solo se envía al servidor al que pertenece y no se vuelve a mostrar, ni siquiera a usted. Algunos servicios ponen la clave en la propia dirección (?key=...): también se guarda cifrada y la página muestra la dirección sin ella.
• El servidor es un tercero. Sus descripciones y respuestas se tratan como información para el agente, nunca como instrucciones, y se le indica al agente que repita los datos antes de hacer algo irreversible.
• Solo servidores públicos. Se rechaza una dirección que apunte a una red privada.
• Límites. Hasta 20 servidores por espacio de trabajo. Una respuesta se corta en unos 6.000 caracteres, y las imágenes y el audio de una respuesta no se pasan al agente. Una herramienta que pide un objeto o una lista lo recibe como texto JSON, que el agente escribe por usted. Una herramienta que se detiene para hacer una pregunta al usuario no la puede usar un agente.
• Repeticiones. Si un agente pide el mismo cambio dos veces en una llamada, se hace una sola vez. Las herramientas que el servidor marca como de solo lectura no se frenan.

Pruebas

Abra la herramienta (Tools, y su nombre), rellene los datos de entrada en Test y ejecútela. Llama al servidor de verdad, igual que el agente, y muestra la respuesta y cuánto tardó. Después pruebe el Chat del agente.

Resultado esperado

El servidor aparece como Connected con sus herramientas, el Test de la herramienta devuelve la respuesta del servidor y el agente usa la herramienta en un chat o en una llamada.

Solución de problemas

Guías relacionadas

• Resumen de herramientas
• Herramientas de aplicaciones conectadas
• Probar y solucionar problemas de herramientas