Saltar al contenido principal

Clientes MCP

El Model Context Protocol (MCP) es un estándar abierto para exponer herramientas a los modelos de IA. Muchos servicios incluyen un servidor MCP, y usted también puede crear el suyo. Un cliente MCP de IA conecta MonoChat con un servidor MCP, de modo que las herramientas que ofrece ese servidor puedan ponerse a disposición de sus nodos de IA y agentes de IA, junto con las funciones de tipo Herramienta de IA que usted escribe en MonoChat.

Los gestiona en Configuración › Automatización › Clientes MCP de AI.

Cómo funciona​

  1. Usted añade la dirección del servidor MCP y se conecta. MonoChat lee lo que ofrece el servidor: sus Herramientas, Recursos, Plantillas de recursos y Prompts.
  2. Al guardar, MonoChat conserva esa lista como contenido del cliente.
  3. En un nodo Crear respuesta de chat de IA o en un nodo Agente de IA elige las herramientas que desea que tenga ese nodo, y puede reescribir la descripción de cada herramienta para el modelo.
  4. Durante la conversación, el modelo decide cuándo llamar a una herramienta; MonoChat llama al servidor MCP y devuelve el resultado al modelo.

Solo las herramientas que añade a un nodo están disponibles para él, de modo que cada nodo ve únicamente lo que necesita.

Añadir un cliente MCP​

  1. Vaya a Configuración › Automatización › Clientes MCP de AI y haga clic en + (Crear).

  2. Rellene los campos:

    CampoDescripción
    NombreUn nombre para el servidor, que se muestra junto a cada una de sus herramientas en los paneles de los nodos.
    DescripciónNotas opcionales.
    VersiónLa versión del cliente que MonoChat anuncia al servidor al conectarse, por ejemplo 1.0.0.
    EndpointLa URL base del servidor MCP. MonoChat se conecta con el transporte SSE en <Endpoint>/sse, así que introduzca la dirección sin /sse.
    Tipo de autenticaciónNinguno, Basic (con Nombre de usuario y Contraseña) o Bearer (con Token). Las credenciales se guardan con el cliente.

  3. Haga clic en Conectar. MonoChat se conecta al servidor y muestra lo que ha encontrado en pestañas:

    • Información del servidor: el Nombre, la Versión, la Versión del protocolo y las Instrucciones del servidor.
    • Herramientas: el nombre y la descripción de cada herramienta.
    • Recursos, Plantillas de recursos y Prompts, si el servidor los ofrece.

  4. Si la lista es correcta, haga clic en Guardar. Para cambiar la dirección y volver a intentarlo, haga clic en el botón Desconectar situado junto a ella.

consejo

Si Conectar falla, compruebe que el endpoint sea accesible desde internet, que el servidor admita el transporte SSE y que la URL no termine ya en /sse.

Actualizar la lista de herramientas​

Cuando el servidor MCP añade o cambia herramientas, abra el cliente con Actualizar. MonoChat vuelve a conectarse y muestra el contenido actual; haga clic en Actualizar para guardar la nueva lista.

Eliminar un cliente también elimina su contenido, por lo que los nodos pierden las herramientas que procedían de él.

Dar herramientas a un nodo​

Nodo Crear respuesta de chat de IA​

  1. Abra el nodo y desplácese hasta Ajustes de herramientas de contenido del cliente MCP de IA.
  2. Haga clic en Configurar herramientas de contenido del cliente MCP de IA. El panel Herramientas de contenido del cliente MCP de IA enumera las herramientas ya añadidas a este nodo.
  3. Haga clic en + (Crear) y elija una herramienta en Herramientas de contenido del cliente MCP de IA. Las herramientas aparecen como <client name> - <tool name>.
  4. La Descripción se rellena con la descripción propia de la herramienta. Edítela si desea indicarle al modelo con más precisión cuándo usar la herramienta, por ejemplo "Use esto para buscar un pedido por su número". La descripción es obligatoria.
  5. Repita el proceso con cada herramienta y guarde el nodo.

En el mismo panel puede actualizar la descripción de una herramienta o quitarla del nodo.

Nodo Agente de IA​

El nodo Agente de IA tiene el mismo botón Configurar herramientas de contenido del cliente MCP de IA en su sección Ajustes de herramientas. Las herramientas MCP seleccionadas se ofrecen al agente junto con los ámbitos de IA y las herramientas de IA del nodo, en todos los harnesses. Consulte Agentes de IA.

información

Una ejecución de agente comprueba que todas las herramientas MCP del nodo sigan existiendo en su espacio de trabajo. Si elimina un cliente MCP que usa un nodo, las ejecuciones de ese nodo fallan con "An AI scope or MCP tool was not found in this workspace." hasta que quite la herramienta del nodo.

Permisos​

El acceso se controla con los permisos de rol Leer / Crear / Actualizar / Eliminar clientes MCP de IA en la automatización y Leer contenidos de clientes MCP de IA en la automatización. Consulte Roles.