Créateur de schéma d’outil MCP

Définissez un outil et obtenez le JSON Schema, avec les exigences du mode strict appliquées.

Les définitions d’outils décrivent vos systèmes internes. Tout est construit dans le navigateur et rien n’est envoyé.

Vérifier une définition existante

À propos de Schéma d'outil MCP

Une définition d'outil a deux missions, et une seule est du JSON. Le schéma dit quelle forme prennent les arguments ; les descriptions disent à quoi sert l'outil et ce que signifie chaque argument. Un schéma peut être parfaitement valide et produire malgré tout un outil appelé au mauvais moment avec des absurdités plausibles dedans, parce que rien dans le JSON n'explique ce qu'est quoi. Ce créateur écrit le schéma et vérifie les deux moitiés : la structure, et si quoi que ce soit est réellement décrit. Le mode strict est également traité comme il se doit : il exige que chaque propriété figure comme requise et interdit les propriétés supplémentaires, ce qui surprend car le schéma est sinon inchangé.

Fonctionnalités

• Paramètres avec types, descriptions et ensembles de valeurs fermés facultatifs
• La règle « tout requis » du mode strict appliquée, non découverte plus tard
• additionalProperties correctement posé quand le mode strict est actif
• Les tableaux reçoivent automatiquement un schéma items
• Avertit sur un paramètre sans description
• Attrape les noms de paramètre en double
• Note un énuméré à valeur unique, qui est une constante
• Produit la définition entière, pas seulement le schéma

Comment utiliser Schéma d'outil MCP

1. Nommez l’outil et décrivez quand l’utiliser
2. Ajoutez chaque paramètre avec son type et une description
3. Marquez les requis, ou activez le mode strict
4. Copiez la définition dans votre tableau d’outils

Exemple

Entrée

"strict": true

Sortie

Error: strict mode requires every property to be listed as required

Le mode strict n’admet pas de propriétés facultatives : autorisez null à la place.

Erreurs courantes et dépannage

• Le mode strict est refusé. — Il exige toutes les propriétés requises et additionalProperties à false. Marquez les facultatives comme requises en autorisant null, ou désactivez le mode strict.
• L’outil est appelé avec de mauvais arguments. — Souvent des paramètres sans description. Un nom seul laisse le sens à la déduction, et « id » pourrait être n’importe quoi.
• L’outil est appelé au mauvais moment. — C’est la description de l’outil, pas le schéma. Dites quand y recourir et ce qu’il renvoie, pas seulement ce qu’il fait.
• Un paramètre tableau est refusé. — Les tableaux ont besoin d’un schéma items disant ce qu’ils contiennent. Il est ajouté automatiquement ici.

Foire aux questions

Que change réellement le mode strict ?

Il garantit que les arguments valident exactement contre le schéma. Le prix : chaque propriété doit figurer comme requise et aucune propriété supplémentaire n’est admise, donc un argument vraiment facultatif doit être modélisé comme requis mais annulable.

Quel niveau de détail pour une description de paramètre ?

Assez pour qu’une personne lisant seulement le schéma sache quoi mettre : le format, les unités, d’où vient la valeur. « L’adresse courriel du client sous laquelle la commande a été passée » vaut bien plus que « courriel ».

Quand utiliser un énuméré ?

Quand l’ensemble des valeurs valides est réellement fermé et court. Cela élimine toute une classe de réponses fausses. Un énuméré à valeur unique est signalé parce que c’est une constante.

Cela vaut-il pour les outils MCP et API ?

Le schéma est le même sous-ensemble de JSON Schema dans les deux cas. L’enveloppe diffère un peu, mais le schéma d’entrée — la partie facile à rater — est identique.

Qu’est-ce qu’une bonne description d’outil ?

Trois choses en deux phrases : ce qu’il fait, quand y recourir, ce qu’il renvoie. La dernière est la plus souvent omise et la plus utile, car elle dit si un seul appel suffira.

Outils associés

• Vérificateur de schéma — Collez une définition et découvrez pourquoi elle est rejetée ou mal appelée.
• Configuration de serveur MCP — Générez une entrée de serveur MCP pour stdio, HTTP ou SSE.
• Exemples few-shot — Transformez des paires entrée/sortie en exemples balisés, JSON ou chat.
• Linter de prompt système — Trouvez contradictions, instructions mortes et marqueurs non remplis.
• Générateur de sous-agents — Créez le fichier de définition d'un sous-agent, outils et modèle compris.
• Visionneuse de flux SSE — Collez une réponse en streaming et récupérez texte, appels et consommation.

Plus d’outils IA et agents

• Générateur de skills — Écrivez un SKILL.md dont le frontmatter est vérifié à la frappe.
• Linter de skills — Collez un SKILL.md et voyez ce qui empêche son association à une tâche.
• Générateur de sous-agents — Créez le fichier de définition d'un sous-agent, outils et modèle compris.
• Générateur de commandes — Créez une commande personnalisée, avec arguments et liste d'outils.
• Instructions du projet — Rédigez un CLAUDE.md qui mérite sa place dans chaque session.
• Manifeste de plugin — Générez un plugin.json et voyez l'arborescence qu'il suppose.
• Générateur de hooks — Créez des hooks settings.json et repérez les matchers qui ne se déclenchent jamais.
• Testeur de règles de permission — Testez les règles autoriser, demander et refuser sur de vraies commandes.
• Configuration de serveur MCP — Générez une entrée de serveur MCP pour stdio, HTTP ou SSE.
• Vérificateur de schéma — Collez une définition et découvrez pourquoi elle est rejetée ou mal appelée.
• Remplissage de gabarits — Déployez un prompt sur un tableau de lignes et voyez ce qui manque.
• Linter de prompt système — Trouvez contradictions, instructions mortes et marqueurs non remplis.
• Comparateur de prompts — Comparez deux versions mot à mot, avec l'écart en tokens.
• Exemples few-shot — Transformez des paires entrée/sortie en exemples balisés, JSON ou chat.
• Sections XML du prompt — Enveloppez les sections dans des balises dont le contenu ne peut sortir.
• Visionneuse et validateur JSONL — Lisez, filtrez et vérifiez un fichier JSONL ligne par ligne.
• Convertisseur de transcriptions — Transformez un tableau de messages en transcription lisible, et l'inverse.
• Validateur de jeux de données — Vérifiez un JSONL de chat pour les erreurs qui font échouer un entraînement.
• Visionneuse de flux SSE — Collez une réponse en streaming et récupérez texte, appels et consommation.
• Planificateur de contexte — Répartissez la fenêtre entre prompt, outils, historique et réponse.
• Planificateur de cache — Ordonnez les blocs pour que le préfixe cachable soit le plus long possible.
• Découpeur de texte — Découpez un document en morceaux chevauchants qui coupent aux vraies frontières.
• Coût d'une boucle d'agent — Chiffrez tour par tour, historique renvoyé et cache appliqué.
• Générateur de lots — Transformez un tableau de lignes en travail par lots, avec des ids uniques.

Voir tous les outils IA et agents · Tous les outils