Servidores MCP

Editar en línea

Puede importar herramientas externas desde servidores de Protocolo de Contexto de Modelo (MCP) y añadirlas a sus agentes para mejorar la capacidad del agente para realizar tareas.

Acerca de los servidores MCP

MCP es un estándar que permite a los agentes interactuar de forma segura y flexible con herramientas y fuentes de datos externas a través de servidores MCP. MCP permite a los agentes descubrir, conectarse e iniciar herramientas externas proporcionadas por servidores MCP. Estos servidores actúan como intermediarios, presentando diversas capacidades (como buscar en la web, consultar una base de datos, enviar correo electrónico o recuperar contenidos web) de forma estandarizada. Este proceso no requiere la creación de API personalizadas ni la configuración manual de conexiones, lo que lo convierte en un método más sencillo y eficaz para que los agentes utilicen herramientas externas.

Con MCP, los agentes pueden descubrir y utilizar estas herramientas externas durante el tiempo de ejecución, mejorando sus capacidades más allá de sus características inherentes. Todas las interacciones con herramientas externas se gestionan a través de un único protocolo, lo que simplifica las conexiones y mejora la eficacia. Además, MCP facilita la colaboración y el uso compartido de herramientas entre agentes de distintos proveedores o plataformas.

Las herramientas se pueden importar desde un servidor MCP local o desde un servidor MCP remoto. watsonx Orchestrate permite la instalación y ejecución de servidores MCP Node y Python, normalmente servidores que utilizan los comandos npx y uvx .

Se puede instalar y ejecutar un servidor MCP local en su propio sistema o red. Normalmente, se puede descargar desde GitHub repositorios y ejecutarlos en su sistema. Un servidor MCP remoto está alojado en un servidor externo y es accesible a través de Internet.

MCP admite varios tipos de autenticación, entre ellos OAuth 2.0, Bearer Token, clave de API y autenticación básica, así como flujos de SSO u OBO. Puede seleccionar el tipo de autenticación requerido en la página Conexiones al configurar un servidor MCP. Para obtener más información sobre la autenticación y la conexión, consulte Administración de conexiones y credenciales de aplicaciones.

Siga estos pasos antes de importar herramientas desde un servidor MCP local o remoto:

  1. Identifique un servidor MCP local o remoto que desee utilizar.

Para el servidor MCP local:

  1. Busque el servidor MCP local que desea utilizar. Por lo general, los servidores MCP locales se encuentran en repositorios de GitHub, como https://github.com/appcypher/awesome-mcp-servers y https://github.com/modelcontextprotocol/servers.

  2. Busque las instrucciones de instalación en la documentación del servidor MCP local o en el archivo Léame.

    • Por lo general, puedes encontrar instrucciones sobre cómo iniciar el servidor MCP local utilizando Node o Python. Por ejemplo, npx -y time-mcp.

    • Algunos servidores MCP locales requieren que se configuren claves API u otras variables de entorno para comunicarse con servicios remotos. Por ejemplo, una clave API "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>" .

  3. Asegúrese de que las herramientas tienen una descripción. Cada herramienta del servidor MCP local debe incluir una descripción. La descripción ayuda al modelo lingüístico subyacente a comprender la finalidad de la herramienta y cómo se utiliza. La descripción también es necesaria para importar correctamente la herramienta en watsonx Orchestrate. Si faltan descripciones de las herramientas se producen errores.

  1. Asegúrese de que el servidor MCP es legítimo y seguro para que lo utilicen sus agentes.

Instalación de un servidor MCP que requiere variables de entorno

Para instalar servidores MCP que requieren variables de entorno, debe añadir las variables necesarias en un AppID/Connection utilizando pares clave-valor. Por ejemplo, para utilizar la clave de la API "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>" , debe añadir un par clave-valor con GITHUB_PERSONAL_ACCESS_TOKEN como clave y su token personal como valor.

Los servidores MCP obtienen las variables de entorno cuando se inician, por lo que es importante establecer las variables antes de importar o iniciar un servidor MCP.

Añadir servidores MCP

Puede añadir servidores MCP directamente en IBM watsonx Orchestrate o utilizando el Kit de Desarrollo de Agentes (ADK).

Para importar servidores MCP, consulte Importar herramientas desde un servidor MCP.

Si se utiliza el ADK, los servidores MCP se importan como un conjunto de herramientas. Para obtener más información, consulta «Gestión de kits de herramientas ».

Limitaciones

Las siguientes funciones no son compatibles con la integración del servidor MCP:

  • Actualizar o renovar la lista de herramientas

Las herramientas importadas desde un servidor MCP no se pueden actualizar ni renovar automáticamente en el catálogo del inquilino. Cualquier cambio en la lista de herramientas del lado del servidor requiere volver a importar las herramientas manualmente.

  • OAuth 2.1 y el registro dinámico de clientes

OAuth 2.1 y DCR no son compatibles. Solo se admiten los siguientes tipos de conexión: OAuth, 2.0, clave API, Basic, Bearer Token y SSO u OBO.

  • Cancelar ejecución de herramienta

Una vez que una herramienta comienza a ejecutarse, debe completarse automáticamente. Los usuarios no pueden detener ni cancelar la ejecución.

  • Importación de recursos y mensajes del servidor MCP

Los recursos como las indicaciones predefinidas o los activos del lado del servidor no se pueden importar ni utilizar en el generador de flujos. Solo se pueden añadir las herramientas.

  • imágenes de Docker

Las instancias de servidor MCP en contenedores Docker no son compatibles con la importación ni la ejecución en Flow Builder.

  • Obtención y anotación

La obtención es el proceso de recopilar información de los usuarios de forma interactiva durante la ejecución de la herramienta para perfeccionar las entradas o guiar la toma de decisiones. La anotación es el proceso de añadir metadatos, etiquetas o comentarios a los resultados de las herramientas para su posterior análisis o integración. Las herramientas no admiten la obtención y anotación.

Importación desde un servidor MCP

Puede importar herramientas externas desde servidores de Protocolo de Contexto de Modelo (MCP) y añadirlas a sus agentes para mejorar la capacidad del agente para realizar tareas.