Serveurs MCP

Modifier en ligne

Vous pouvez importer des outils externes à partir de serveurs Model Context Protocol (MCP) et les ajouter à vos agents pour améliorer la capacité de l'agent à accomplir des tâches.

À propos des serveurs MCP

MCP est une norme qui permet aux agents d'interagir de manière sûre et flexible avec des outils et des sources de données externes par l'intermédiaire de serveurs MCP. MCP permet aux agents de découvrir, de se connecter et de démarrer des outils externes fournis par des serveurs MCP. Ces serveurs fonctionnent comme des intermédiaires, présentant diverses fonctionnalités (telles que la recherche sur le web, l'interrogation d'une base de données, l'envoi de courrier électronique ou l'extraction de contenu web) d'une manière normalisée. Ce processus ne nécessite pas la création d'API personnalisées ou la mise en place manuelle de connexions, ce qui en fait une méthode plus simple et plus efficace pour les agents d'utiliser des outils externes.

Avec MCP, les agents peuvent découvrir et utiliser ces outils externes pendant l'exécution, améliorant ainsi leurs capacités au-delà de leurs caractéristiques inhérentes. Toutes les interactions avec les outils externes sont gérées par un protocole unique, ce qui simplifie les connexions et améliore l'efficacité. En outre, le MCP facilite la collaboration et le partage d'outils entre les agents de différents fournisseurs ou plates-formes.

Les outils peuvent être importés à partir d'un serveur MCP local ou d'un serveur MCP distant. watsonx Orchestrate permet l'installation et l'exécution de serveurs MCP Node et Python, généralement des serveurs qui utilisent les commandes npx et uvx .

Un serveur MCP local peut être installé et exécuté sur votre propre système ou réseau. En général, il peut être téléchargé à partir de GitHub référentiels et exécuté sur votre système. Un serveur MCP distant est hébergé sur un serveur externe et accessible via Internet.

MCP prend en charge plusieurs types d'authentification, notamment l'authentification par nom d'utilisateur et mot de passe ( OAuth ), l'authentification par nom d'utilisateur et mot de passe avec authentification par mot de passe ( 2.0 ), l'authentification par jeton Bearer, l'authentification par clé API et l'authentification de base, ainsi que les flux SSO ou OBO. Vous pouvez sélectionner le type d'authentification requis sur la page Connexions lors de la configuration d'un serveur MCP. Pour plus d'informations sur l'authentification et la connexion, consultez la section Gestion des connexions et des informations d'identification des applications.

Suivez ces étapes avant d'importer des outils à partir d'un serveur MCP local ou distant :

  1. Identifiez un serveur MCP local ou distant à utiliser.

Pour le serveur MCP local :

  1. Recherchez le serveur MCP local que vous prévoyez d'utiliser. En général, les serveurs MCP locaux se trouvent sur des référentiels d' GitHub, tels que https://github.com/appcypher/awesome-mcp-servers et https://github.com/modelcontextprotocol/servers.

  2. Repérez les instructions d'installation dans la documentation du serveur MCP local ou dans le fichier Lisez-moi.

    • En général, vous trouverez des instructions sur la manière de démarrer le serveur MCP local à l'aide de Node ou Python. Par exemple, npx -y time-mcp.

    • Certains serveurs MCP locaux nécessitent la configuration de clés API ou d'autres variables d'environnement pour communiquer avec des services distants. Par exemple, une clé API "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>" .

  3. Veillez à ce que les outils soient décrits. Chaque outil du serveur MCP local doit inclure une description. La description aide le modèle linguistique sous-jacent à comprendre l'objectif de l'outil et la manière dont il est utilisé. La description est également nécessaire pour importer avec succès l'outil dans watsonx Orchestrate. Les descriptions d'outils manquantes entraînent des erreurs.

  1. Assurez-vous que le serveur MCP est légitime et que vos agents peuvent l'utiliser en toute sécurité.

Installation d'un serveur MCP nécessitant des variables d'environnement

Pour installer des serveurs MCP qui nécessitent des variables d'environnement, vous devez ajouter les variables requises dans un site AppID/Connection en utilisant des paires clé-valeur. Par exemple, pour utiliser la clé API "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>" , vous devez ajouter une paire clé-valeur avec GITHUB_PERSONAL_ACCESS_TOKEN comme clé et votre jeton personnel comme valeur.

Les serveurs MCP récupèrent les variables d'environnement lorsqu'ils démarrent, il est donc important de définir les variables avant d'importer ou de démarrer un serveur MCP.

Ajout de serveurs MCP

Vous pouvez ajouter des serveurs MCP directement dans IBM watsonx Orchestrate ou en utilisant le kit de développement de l'agent (ADK).

Pour importer des serveurs MCP, voir Importation d'outils à partir d'un serveur MCP.

Si vous utilisez l'ADK, les serveurs MCP sont importés en tant que boîte à outils. Pour en savoir plus, consultez la section « Gestion des boîtes à outils ».

Limites

Les fonctionnalités suivantes ne sont pas prises en charge dans l'intégration du serveur MCP :

  • Actualisation ou mise à jour de la liste des outils

Les outils importés depuis un serveur MCP ne peuvent pas être actualisés ou mis à jour automatiquement dans le catalogue du locataire. Toute modification apportée à la liste des outils côté serveur nécessite de réimporter manuellement les outils.

  • OAuth 2.1 et l'enregistrement dynamique des clients

OAuth 2.1 et DCR ne sont pas pris en charge. Seuls les types de connexion existants suivants sont pris en charge : OAuth2.0, clé API, Basic, Bearer Token, ainsi que SSO ou OBO.

  • Annulation de l'exécution d'un outil

Une fois qu'un outil commence à s'exécuter, il doit s'exécuter automatiquement jusqu'à la fin. Les utilisateurs ne peuvent ni interrompre ni annuler l'exécution.

  • Importation des ressources et invites du serveur MCP

Les ressources telles que les invites prédéfinies ou les ressources côté serveur ne peuvent pas être importées et utilisées dans le générateur de flux. Seuls les outils peuvent être ajoutés.

  • images Docker

Les instances de serveur MCP conteneurisées ne sont pas prises en charge pour l'importation ou l'exécution dans Flow Builder.

  • Sondage et annotation

L'élicitation est le processus qui consiste à recueillir de manière interactive des informations auprès des utilisateurs pendant l'exécution d'un outil afin d'affiner les données saisies ou d'orienter la prise de décision. L'annotation est le processus qui consiste à ajouter des métadonnées, des étiquettes ou des commentaires aux résultats d'un outil en vue d'une analyse ou d'une intégration ultérieure. Les outils ne prennent pas en charge l'élicitation et l'annotation.

Importation à partir d'un serveur MCP

Vous pouvez importer des outils externes à partir de serveurs Model Context Protocol (MCP) et les ajouter à vos agents pour améliorer la capacité de l'agent à accomplir des tâches.