Maintenant que nous avons construit notre serveur MCP, récapitulons les trois primitives fondamentales du serveur et comprenons quand utiliser chacune d'elles. L'idée clé est que chaque primitive est contrôlée par une partie différente de votre pile applicative.
Outils : contrôlés par le modèle
Les outils sont entièrement contrôlés par Claude. Le modèle d'IA décide quand appeler ces fonctions, et les résultats sont utilisés directement par Claude pour accomplir des tâches.
Utilisez les outils lorsque vous souhaitez donner à Claude des capacités supplémentaires. Par exemple, si vous demandez à Claude de calculer la racine carrée de 3 en utilisant JavaScript, Claude décidera automatiquement d'utiliser un outil d'exécution JavaScript pour fournir la réponse.
La décision d'utiliser l'outil était entièrement contrôlée par le modèle - Claude a reconnu qu'il devait exécuter du code et a choisi l'outil approprié sans aucune incitation de l'application ou de l'utilisateur.
Ressources : contrôlées par l'application
Les ressources sont contrôlées par le code de votre application. Votre application décide quand récupérer les données de ressources et comment les utiliser, généralement à des fins d'interface utilisateur ou pour ajouter du contexte aux conversations.
Utilisez les ressources lorsque vous avez besoin de faire entrer des données dans votre application. Les exemples courants incluent :
- Remplir les options d'autocomplétion dans votre interface utilisateur
- Récupérer des documents à afficher dans un sélecteur de fichiers
- Ajouter du contexte aux messages avant de les envoyer à Claude
Dans l'interface web de Claude, la fonctionnalité « Ajouter depuis Google Drive » illustre parfaitement cela. L'application récupère une liste de documents disponibles et les affiche dans l'interface utilisateur, puis injecte le contenu du document sélectionné dans le contexte de la conversation.
Invites : contrôlées par l'utilisateur
Les invites sont contrôlées par les utilisateurs. Ils décident quand déclencher ces workflows prédéfinis par des actions directes comme cliquer sur des boutons, sélectionner des options de menu ou utiliser des commandes slash.
Utilisez les invites lorsque vous souhaitez mettre en œuvre des workflows prédéfinis auxquels les utilisateurs peuvent facilement accéder. Dans l'interface de Claude, vous verrez des boutons de workflow sous le champ de saisie du chat qui permettent aux utilisateurs de démarrer rapidement des tâches courantes comme l'écriture, l'apprentissage ou le codage.
Choisir la bonne primitive
Lorsque vous construisez votre serveur MCP, réfléchissez à qui doit contrôler chaque élément de fonctionnalité :
- Besoin d'étendre les capacités de Claude ? Utilisez les outils
- Besoin de faire entrer des données dans l'interface utilisateur de votre application ? Utilisez les ressources
- Besoin d'offrir aux utilisateurs des workflows prédéfinis ? Utilisez les invites
Ce sont des directives générales pour vous aider à choisir la bonne primitive en fonction de votre cas d'usage spécifique. Chacune sert une partie différente de la pile applicative - les outils servent le modèle, les ressources servent l'application, et les invites servent les utilisateurs.