Aller au contenu de la page
Documentation
Documentation de Make Agent Fast

Vos propres outils (MCP)

Connectez un serveur MCP distant et choisissez les outils que les clients peuvent utiliser via votre agent.

En un coup d’œil

Connectez un serveur MCP distant et choisissez les outils que les clients peuvent utiliser via votre agent.

Connecter et découvrir#

Ouvrez Agent → Actions → Vos outils (MCP). Connectez votre serveur distant à l'aide de son flux OAuth ou d'un identifiant bearer, ou utilisez une connexion MCP existante. Choisissez Découvrir pour lire le catalogue d'outils. Examinez la description, les paramètres et les annotations de chaque outil avant de l'activer. La découverte n'exécute aucun outil ; les outils nouvellement découverts sont désactivés.

Vous pouvez configurer trois serveurs d'outils et activer 20 outils au total. Les identifiants restent côté serveur. La suppression d'un mappage d'outil arrête ce mappage, mais ne révoque pas la connexion de connaissances partagée ni son autorisation OAuth ; gérez cette connexion séparément. Le serveur MCP de gestion propriétaire de Make Agent Fast ne peut pas être exposé comme serveur d'outils pour les clients. Pour gérer vos agents depuis Claude, consultez Utiliser Claude et ChatGPT.

Choisir lecture ou écriture#

EffetComportement
LectureAppelle directement l'outil et traite le texte ou les données structurées renvoyés comme des données métier non fiables
ÉcritureCrée une proposition ; le client doit confirmer les entrées exactes à l'aide des boutons de la carte avant l'exécution

La lecture n'est disponible que si le serveur déclare readOnlyHint: true et ne déclare pas destructiveHint: true, et si vous conservez l'outil classé en lecture. Sinon, traitez-le comme une écriture. Vérifiez ce que le serveur fait réellement ; les annotations ne constituent pas un système d'autorisation.

Par défaut, les écritures exigent à chaque fois l'approbation du propriétaire. Vous pouvez choisir de n'exiger aucune approbation supplémentaire du propriétaire, ou une approbation au-delà d'une limite portant sur un paramètre numérique. La confirmation du client reste requise dans tous les modes. L'approbation du propriétaire utilise la liste des approbations et les reçus existants. Les paramètres sont enregistrés automatiquement. La répétition côté propriétaire n'appelle jamais le serveur distant.

Associer le client connecté#

Par défaut, les outils exigent un client vérifié. Utilisez l'identité client signée sur votre site web ; un identifiant saisi dans le chat ne constitue pas une vérification. Pour les enregistrements propres à un client, choisissez le paramètre de type chaîne de l'outil qui identifie le client. Le serveur le renseigne à partir de l'identifiant client vérifié et le retire des entrées du modèle. Les paramètres de type enum ne peuvent pas être utilisés pour cette association.

Par exemple, associez customer_id sur un outil qui lit une commande. Le modèle peut fournir la référence de commande déclarée, mais ne peut pas substituer l'identifiant d'un autre client. Le serveur distant doit tout de même vérifier que la commande appartient bien à ce client. Exiger la connexion sans association de paramètre ne limite pas, à lui seul, tous les enregistrements auxquels l'outil distant peut accéder.

Limites et résultats incertains#

Les schémas pris en charge sont des objets plats comportant jusqu'à dix paramètres de type chaîne, nombre, entier, booléen ou enum. Les objets imbriqués, les tableaux et les règles de schéma non prises en charge restent indisponibles. Les chaînes sont limitées à 200 caractères ; les appels distants ont un délai d'expiration de 10 secondes et les résultats visibles par le modèle sont plafonnés à 4 Ko. Le contenu d'un résultat est une donnée, jamais une instruction pour l'agent.

MCP n'offre aucune garantie générale d'idempotence. Une écriture n'est appelée qu'une seule fois après confirmation ou approbation. Si son résultat est inconnu, Make Agent Fast ne réessaie pas automatiquement et en informe le propriétaire. Vérifiez le système distant avant de créer une autre proposition. Modifier la configuration d'un outil déjà examiné invalide toute proposition plus ancienne.

Testez chaque lecture et chaque écriture prévues avec votre propre serveur avant que les clients ne les utilisent.