Klavis Strata

officiel

Un serveur MCP permettant aux agents IA d'utiliser n'importe quels outils de manière fiable, à n'importe quelle échelle.

Que pouvez-vous faire avec Klavis Strata MCP ?

  • Découvrir les actions pertinentes — Demandez à votre assistant de trouver des catégories ou des actions sur des serveurs nommés à partir d’une intention formulée en langage naturel avec discover_server_categories_or_actions.
  • Lister les actions d’une catégorie — Récupérez tous les noms d’action dans des catégories spécifiques avec get_category_actions avant d’examiner les détails.
  • Examiner les schémas des actions — Obtenez les paramètres obligatoires et facultatifs d’une action spécifique via get_action_details en indiquant une catégorie et un nom d’action.
  • Exécuter des actions — Exécutez une action avec des paramètres de chemin, de requête et de corps via execute_action, en limitant éventuellement les champs renvoyés avec include_output_fields.
  • Rechercher dans la documentation du serveur — Recherchez des points de terminaison par mot-clé dans la documentation d’un serveur avec search_documentation lorsque la découverte manque de détails.
  • Résoudre les échecs d’authentification — Obtenez des instructions d’authentification ou enregistrez des identifiants après une erreur d’authentification avec handle_auth_failure.

Documentation

Strata

Un serveur MCP pour permettre aux agents IA d’utiliser des outils progressivement, quelle que soit l’échelle

Strata Hero - Progressive tool discovery for AI agents

Qu’est-ce que Strata ?

Strata est un serveur MCP qui guide les agents IA pour utiliser des outils de manière fiable, quelle que soit la complexité, au lieu de les submerger en leur présentant tout d’un coup. Il a été conçu en s’inspirant de la façon dont les humains interagissent avec les outils, afin de résoudre les trois principaux problèmes qui affectent aujourd’hui les agents IA :

  • Surcharge d’outils : un trop grand nombre d’outils paralyse le choix du LLM
  • Surcharge du contexte : les longues listes d’outils font exploser le nombre de jetons et les coûts
  • Lacunes de couverture : la plupart des serveurs sont limités à 40~50 outils, ce qui restreint les possibilités

Vous pouvez utiliser Strata via notre site web, notre API, ou même en open source avec vos propres données !

Tutoriel vidéo

Regardez ce tutoriel vidéo pour comprendre pleinement le fonctionnement de Strata :

Strata

Tutoriel textuel

[!TIP]

Consultez cette conversation Claude partagée pour voir Strata en action !

1. Découvrir les catégories ou les actions du serveur

discover_server_categories_or_actions - trouver les catégories ou les actions pertinentes en fonction de l’intention de l’utilisateur. Sans recherche sémantique !

[accordion] Détails de l’outil

Description : POINT DE DÉPART À PRIVILÉGIER. Découvrez les catégories ou les actions disponibles en fonction de la requête de l’utilisateur. Essayez d’abord cet outil pour explorer les actions disponibles sur les différents serveurs. C’est le point d’entrée principal pour explorer les actions disponibles et il doit être utilisé avant les autres méthodes de recherche. Le résultat est une liste de serveurs avec leur niveau de détail et les détails correspondants.

Si le niveau de détail est 'categories_only', les détails ne contiendront que la liste des noms de catégories. À l’étape suivante, privilégiez l’outil get_category_actions pour obtenir les actions des catégories.

Si le niveau de détail est 'full_details', les détails contiendront les noms des catégories ainsi que les détails de leurs actions. Cela se produit lorsque le serveur ne comporte que quelques actions. À l’étape suivante, privilégiez l’outil execute_action pour exécuter les actions.

Si le niveau de détail est 'categories_and_actions', les détails contiendront les noms des catégories et des actions. Cela se produit lors de l’utilisation d’outils externes. À l’étape suivante, privilégiez l’outil get_action_details pour obtenir les détails des actions.

Paramètres :

  • user_query (string, required) : requête en langage naturel de l’utilisateur pour filtrer les résultats.
  • server_names (array, required) : liste des noms de serveurs pour lesquels découvrir des catégories ou des actions.

2. Obtenir les actions d’une catégorie

get_category_actions - récupérer tous les noms d’action des catégories spécifiées.

[accordion] Détails de l’outil

Description : Obtenez un aperçu complet des actions d’API disponibles dans des catégories spécifiques. Utilisez cet outil pour explorer les actions disponibles dans certaines catégories de services ou obtenir une vue détaillée des fonctionnalités d’une catégorie. ** Important ** : il ne doit être appelé qu’après avoir récupéré les catégories du serveur avec l’outil discover_server_categories.

Paramètres :

  • category_names (array, required) : liste des catégories dont vous souhaitez obtenir les actions

3. Obtenir les détails d’une action

get_action_details - obtenir le schéma complet et les paramètres d’une action spécifique.

[accordion] Détails de l’outil

Description : Obtenez des informations détaillées sur une action spécifique, notamment ses paramètres obligatoires et facultatifs. Vous devez fournir le nom de la catégorie et celui de l’action. ** Important ** : cet outil ne doit être appelé qu’après avoir récupéré les catégories du serveur lors d’appels précédents.

Paramètres :

  • category_name (string, required) : nom de la catégorie
  • action_name (string, required) : nom de l’action/de l’opération dans la catégorie

4. Exécuter une action

execute_action - exécuter des actions avec des paramètres et obtenir les résultats.

[accordion] Détails de l’outil

Description : Exécutez une action spécifique avec les paramètres fournis. Vous devez fournir le nom du serveur, le nom de l’action et les paramètres de l’action. ** Important ** : cet outil ne doit être appelé qu’après avoir récupéré les détails de l’action avec l’outil get_action_details.

Paramètres :

  • server_name (string, required) : nom du serveur
  • category_name (string, required) : nom de la catégorie dans laquelle exécuter l’action
  • action_name (string, required) : nom de l’action/de l’opération à exécuter
  • path_params (string, optional) : chaîne JSON contenant les paramètres de chemin de l’action
  • query_params (string, optional) : chaîne JSON contenant les paramètres de requête de l’action
  • body_schema (string, optional, default: "{}") : chaîne JSON contenant le corps de la requête pour les actions
  • include_output_fields (array, optional) : facultatif, mais fortement recommandé si vous connaissez le response_schema de cette action grâce à des appels précédents : tableau de chemins de champs à inclure dans la réponse. Seuls ces champs seront renvoyés. Utilisez la notation par points pour les champs imbriqués (par exemple, "author.displayName").
  • maximum_output_characters (integer, optional) : facultatif : nombre maximal de caractères à renvoyer dans la réponse. Si la réponse dépasse cette limite, elle sera tronquée. Privilégiez include_output_fields.

5. Rechercher dans la documentation

search_documentation - trouver les informations pertinentes uniquement lorsque nécessaire.

[accordion] Détails de l’outil

Description : OPTION SECONDAIRE : utilisez cet outil uniquement si discover_server_categories ne fournit pas suffisamment de détails ou si vous devez effectuer une recherche dans la documentation d’un serveur spécifique. Recherchez la documentation des actions du serveur par catégorie, opération, balise ou fonctionnalité à l’aide de mots-clés. Il ne s’agit pas d’une recherche en langage naturel : l’outil fait correspondre des mots-clés et des expressions exacts. Les points de terminaison sont classés par pertinence. Utilisez quelques mots-clés ciblés pour trouver les meilleurs résultats. Exemples courants : noms de catégories ('projects', 'users', 'pipelines'), actions ('create', 'delete', 'list', 'get') ou combinaisons ('create user', 'list projects'). L’algorithme de recherche utilise un système de notation intelligent pour éviter que les champs de description trop verbeux ne dominent les résultats.

Paramètres :

  • query (string, required) : mots-clés correspondant aux termes de la documentation de l’API. Bonnes pratiques : (1) utilisez des noms de ressources comme 'users', 'projects', 'files', (2) ajoutez des actions pour plus de précision, comme 'user create' ou 'project delete', (3) évitez les mots de remplissage comme 'how to', 'show me', 'all the' : concentrez-vous sur les termes essentiels présents dans les noms et les descriptions des points de terminaison.
  • server_name (string, required) : nom du serveur dans lequel effectuer la recherche.
  • max_results (integer, optional, default: 10, minimum: 1, maximum: 50) : nombre de résultats à renvoyer. Valeur par défaut : 10

6. Gérer les échecs d’authentification

handle_auth_failure - gérer l’authentification uniquement lorsque nécessaire.

[accordion] Détails de l’outil

Description : Gérez les échecs d’authentification qui surviennent lors de l’exécution d’actions. CRITIQUE : cet outil doit être appelé UNIQUEMENT si execute_action échoue spécifiquement en raison d’un problème d’authentification (401 Unauthorized, identifiants invalides, jetons expirés, etc.). N’appelez PAS cet outil pour vérifier l’état de l’authentification ni à d’autres fins. Utilisation : (1) lorsque execute_action renvoie une erreur d’authentification, appelez cet outil avec 'get_auth_url' pour obtenir les instructions d’authentification. (2) Lorsque l’utilisateur fournit des données d’authentification après un échec, appelez cet outil avec 'save_auth_data' pour enregistrer les identifiants. N’appelez JAMAIS cet outil si l’échec n’est PAS dû à un problème d’authentification (par exemple, 404 Not Found, 500 Internal Server Error, etc.).

Paramètres :

  • server_name (string, required) : nom du serveur dont l’authentification a échoué lors de execute_action
  • intention (string, required, enum: ["get_auth_url", "save_auth_data"]) : utilisez 'get_auth_url' lorsque execute_action échoue en raison d’erreurs d’authentification pour obtenir les instructions d’authentification. Utilisez 'save_auth_data' lorsque l’utilisateur fournit des identifiants d’authentification après un échec d’authentification.
  • auth_data (object, optional) : données d’authentification fournies par l’utilisateur après un échec d’authentification (par exemple, {"token": "...", "api_key": "..."}). Utilisé uniquement avec l’intention 'save_auth_data' pour résoudre les échecs d’authentification.

Évaluation

Strata produit des résultats concrets :

  • Benchmark MCPMark : obtient un taux de réussite +15.2% supérieur pour pass@1 par rapport au serveur GitHub officiel et un taux de réussite +13.4% supérieur pour pass@1 par rapport au serveur Notion officiel. (Source)
  • Évaluation humaine : atteint une précision de 83%+ sur des ensembles d’évaluation comprenant plus de 2k requêtes réelles

Étapes suivantes

[card] Bien démarrer

Créez votre premier serveur Strata en quelques minutes

[card] Référence de l’API

Explorez l’API Strata dans son intégralité

Cette documentation est créée et hébergée sur Mintlify, une plateforme de documentation pour développeurs.