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 disponibles sur tous les serveurs — Demandez à votre IA de trouver les outils pertinents en décrivant ce que vous souhaitez faire, en utilisant discover_server_categories_or_actions comme point de départ privilégié.
  • Explorer les actions d'une catégorie — Récupérez tous les noms d'actions d'une catégorie de service spécifique avec get_category_actions après avoir découvert les catégories disponibles.
  • Obtenir les schémas de paramètres d'une action — Récupérez les détails complets des entrées d'une action spécifique avec get_action_details avant de l'exécuter.
  • Exécuter une action API — Lancez une action découverte avec les paramètres requis via execute_action, en filtrant éventuellement les champs de sortie pour réduire la taille de la réponse.
  • Rechercher dans la documentation du serveur par mot-clé — Utilisez search_documentation avec des termes ciblés comme "créer un utilisateur" ou "lister les projets" lorsque la découverte par catégorie nécessite plus de précision.
  • Résoudre les échecs d'authentification — Appelez handle_auth_failure pour obtenir des instructions d'authentification ou enregistrer des identifiants lorsqu'une action échoue avec une erreur 401.

Documentation

Strata

Un serveur MCP pour que les agents IA utilisent des outils progressivement à toute échelle

<img src="https://mintcdn.com/klavisai/7Siw7A5JJSHURM5d/images/concepts/strata_hero.png?fit=max&auto=format&n=7Siw7A5JJSHURM5d&q=85&s=b581fdb821699a32b260d124789396bd" alt="Strata Hero - Progressive tool discovery for AI agents" className="w-full rounded-lg" style={{ maxWidth: '100%', height: 'auto' }} width="2533" height="496" data-path="images/concepts/strata_hero.png" />

Qu'est-ce que Strata ?

Strata est un serveur MCP qui guide les agents IA pour utiliser des outils de manière fiable à toute complexité, au lieu de les submerger avec tout d'un coup. Il a été conçu en pensant à l'interaction humaine avec les outils, résolvant les trois problèmes majeurs qui affectent les agents IA aujourd'hui :

  • Surcharge d'outils : Trop d'outils provoquent une paralysie de choix chez le LLM
  • Surcharge de contexte : De longues listes d'outils font exploser le nombre de tokens et les coûts
  • Écart de couverture : La plupart des serveurs sont limités à 40~50 outils, limitant ce que vous pouvez construire

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

Tutoriel vidéo

Regardez ce tutoriel vidéo pour une compréhension complète du fonctionnement de Strata :

Tutoriel textuel Consultez cette [conversation Claude partagée](https://claude.ai/share/9b44a192-9f2d-46e2-a875-ef905c457070) pour voir Strata en action !

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

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

**Description** : **POINT DE DÉPART PRÉFÉRÉ**. Découvrez les catégories ou actions disponibles en fonction de la requête de l'utilisateur. Essayez d'abord cet outil pour explorer les actions disponibles sur les serveurs. C'est le point d'entrée principal pour explorer les actions disponibles et doit être utilisé avant les autres méthodes de recherche. La sortie sera une liste de serveurs avec le niveau de détail et les détails.

Si le niveau de détail est 'categories_only', les détails seront une liste de noms de catégories uniquement. L'étape suivante préfère utiliser l'outil get_category_actions pour obtenir les actions des catégories.

Si le niveau de détail est 'full_details', les détails seront une liste de noms de catégories avec leurs actions détaillées incluses. Cela se produit lorsque le serveur n'a que quelques actions. L'étape suivante préfère utiliser l'outil execute_action pour exécuter les actions.

Si le niveau de détail est 'categories_and_actions', les détails seront une liste de noms de catégories et de noms d'actions. Cela se produit lors de l'utilisation d'outils externes. L'étape suivante préfère utiliser l'outil get_action_details pour obtenir les détails des actions.

Paramètres :

  • user_query (chaîne, requis) : Requête utilisateur en langage naturel pour filtrer les résultats.
  • server_names (tableau, requis) : Liste des noms de serveurs pour découvrir les catégories ou actions.

2. Obtenir les actions de la catégorie

get_category_actions - récupérer tous les noms d'actions dans les catégories spécifiées.

**Description** : Obtenez un aperçu complet des actions API disponibles dans des catégories spécifiques. Utilisez cet outil si vous souhaitez explorer les actions disponibles dans des catégories de services particulières ou obtenir une vue détaillée des capacités de la catégorie. \*\* Important \*\* : Il ne doit être appelé qu'après avoir obtenu les catégories de serveur à partir de l'outil discover_server_categories.

Paramètres :

  • category_names (tableau, requis) : Liste des catégories pour lesquelles obtenir les actions

3. Obtenir les détails de l'action

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

**Description** : Obtenez des informations détaillées sur une action spécifique, y compris les paramètres requis et optionnels. Doit fournir le nom de la catégorie et le nom de l'action. \*\* Important \*\* : Il ne doit être appelé qu'après avoir obtenu les catégories de serveur à partir des appels d'outils précédents.

Paramètres :

  • category_name (chaîne, requis) : Le nom de la catégorie
  • action_name (chaîne, requis) : Le nom de l'action/opération dans la catégorie

4. Exécuter l'action

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

**Description** : Exécutez une action spécifique avec les paramètres fournis. Doit fournir le nom du serveur, le nom de l'action et les paramètres de l'action. \*\* Important \*\* : Il ne doit être appelé qu'après avoir obtenu les détails de l'action à partir de l'outil get_action_details.

Paramètres :

  • server_name (chaîne, requis) : Le nom du serveur
  • category_name (chaîne, requis) : Le nom de la catégorie pour laquelle exécuter l'action
  • action_name (chaîne, requis) : Le nom de l'action/opération à exécuter
  • path_params (chaîne, optionnel) : Chaîne JSON contenant les paramètres de chemin pour l'action
  • query_params (chaîne, optionnel) : Chaîne JSON contenant les paramètres de requête pour l'action
  • body_schema (chaîne, optionnel, par défaut : "{}") : Chaîne JSON contenant le corps de la requête pour les actions
  • include_output_fields (tableau, optionnel) : Optionnel mais fortement recommandé lorsque vous connaissez le response_schema de cette action à partir d'appels d'outils précédents : Tableau des chemins de champs à inclure dans la réponse. Seuls ces champs seront retournés. Utilisez la notation par points pour les champs imbriqués (par exemple, "author.displayName").
  • maximum_output_characters (entier, optionnel) : Optionnel : Nombre maximum de caractères à retourner dans la réponse. Si la réponse dépasse cette limite, elle sera tronquée. Préférez include_output_fields à cela.

5. Rechercher dans la documentation

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

**Description** : **OPTION SECONDAIRE** : Utilisez cet outil uniquement lorsque discover_server_categories ne fournit pas suffisamment de détails ou lorsque vous devez effectuer une recherche dans la documentation d'un serveur spécifique. Recherchez les documentations d'actions de serveur par catégorie, opération, balises ou fonctionnalité en utilisant la correspondance de mots-clés. Ce n'est pas une recherche en langage naturel - elle correspond à des mots-clés et des phrases exacts. Retourne les points de terminaison classés par pertinence. Utilisez quelques mots-clés ciblés pour trouver les meilleures correspondances. Modèles courants : noms de catégories ('projects', 'users', 'pipelines'), actions ('create', 'delete', 'list', 'get'), ou combinaisons ('create user', 'list projects'). L'algorithme de recherche utilise une notation intelligente pour empêcher les champs de description verbeux de submerger les résultats.

Paramètres :

  • query (chaîne, requis) : Mots-clés de recherche qui correspondent aux termes de la documentation API. Meilleures 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 principaux qui apparaissent dans les noms et descriptions des points de terminaison.
  • server_name (chaîne, requis) : Nom du serveur dans lequel effectuer la recherche.
  • max_results (entier, optionnel, par défaut : 10, minimum : 1, maximum : 50) : Nombre de résultats à retourner. Par défaut : 10

6. Gérer l'échec d'authentification

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

**Description** : Gérez les échecs d'authentification qui se produisent lors de l'exécution d'actions. CRITIQUE : Cet outil doit être appelé UNIQUEMENT lorsque execute_action échoue spécifiquement en raison de problèmes d'authentification (401 Non autorisé, identifiants invalides, jetons expirés, etc.). N'appelez PAS cet outil pour vérifier l'état de l'authentification ou à toute autre fin. Utilisation : (1) Lorsque execute_action retourne une erreur d'authentification, appelez cet outil avec 'get_auth_url' pour obtenir des 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 un échec d'authentification (par exemple, 404 Non trouvé, 500 Erreur interne du serveur, etc.).

Paramètres :

  • server_name (chaîne, requis) : Le nom du serveur qui a échoué à l'authentification lors de execute_action
  • intention (chaîne, requis, enum : ["get_auth_url", "save_auth_data"]) : Utilisez 'get_auth_url' lorsque execute_action échoue avec des erreurs d'authentification pour obtenir des instructions d'authentification. Utilisez 'save_auth_data' lorsque l'utilisateur fournit des identifiants d'authentification après un échec d'authentification.
  • auth_data (objet, optionnel) : 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' lors de la résolution des échecs d'authentification.

Évaluation

Strata fournit des résultats réels :

  • Benchmark MCPMark : Atteint un taux de réussite +15,2 % plus élevé en pass@1 par rapport au serveur GitHub officiel et un taux de réussite +13,4 % plus élevé en pass@1 par rapport au serveur Notion officiel. (Source)
  • Évaluation humaine : Atteint une précision de 83 % ou plus sur plus de 2 000 ensembles d'évaluation de requêtes du monde réel

Prochaines étapes

Créez votre premier serveur Strata en quelques minutes Explorez l'API Strata complète