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 des outils pertinents par intention — Demandez à l'assistant de trouver des catégories ou actions correspondantes sur les serveurs à l'aide de discover_server_categories_or_actions avec une requête en langage naturel.
  • Explorer les actions au sein des catégories — Demandez une liste de tous les noms d'actions pour des catégories de services spécifiques via get_category_actions.
  • Inspecter les schémas d'actions — Obtenez les détails complets des paramètres pour une action spécifique en fournissant sa catégorie et son nom d'action avec get_action_details.
  • Exécuter des actions API — Lancez une action serveur avec des paramètres de chemin, de requête ou de corps, et filtrez éventuellement les champs de sortie, en utilisant execute_action.
  • Rechercher dans la documentation du serveur — Demandez des recherches documentaires par mots-clés dans un serveur pour trouver des points de terminaison pertinents à l'aide de search_documentation.
  • Résoudre les échecs d'authentification — Gérez les erreurs 401 en récupérant les URL d'authentification ou en enregistrant les identifiants fournis par l'utilisateur avec handle_auth_failure.

Documentation

Strata

Un serveur MCP unique permettant aux agents IA d'utiliser des outils progressivement, à n'importe quelle é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 unique qui guide les agents IA vers une utilisation fiable des outils, quelle que soit la complexité, sans les submerger 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 du choix pour les LLM
  • Surcharge de contexte : Les longues listes d'outils font exploser les compteurs de jetons et les coûts
  • Fossé de couverture : La plupart des serveurs sont limités à 40~50 outils, ce qui restreint 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 texte

Astuce

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

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

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écouvrir les catégories ou actions disponibles en fonction de la requête utilisateur. Essayez cet outil en premier lors de l'exploration des 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 un niveau de détail et des 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 consiste à 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 détails d'actions inclus. Cela se produit lorsque le serveur n'a que quelques actions. L'étape suivante consiste à 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 consiste à utiliser l'outil get_action_details pour obtenir les détails des actions.

Paramètres :

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

2. Obtenir les actions des catégories

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

**Description** : Obtenir 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 des catégories. \*\* Important \*\* : Il ne doit être appelé qu'après avoir obtenu les catégories de serveurs via l'outil discover_server_categories.

Paramètres :

  • category_names (tableau, obligatoire) : Liste des catégories pour lesquelles 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.

**Description** : Obtenir des informations détaillées sur une action spécifique, y compris les paramètres obligatoires et facultatifs. Le nom de la catégorie et le nom de l'action doivent être fournis. \*\* Important \*\* : Il ne doit être appelé qu'après avoir obtenu les catégories de serveurs lors des appels d'outils précédents.

Paramètres :

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

4. Exécuter une action

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

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

Paramètres :

  • server_name (chaîne, obligatoire) : Le nom du serveur
  • category_name (chaîne, obligatoire) : Le nom de la catégorie pour laquelle exécuter l'action
  • action_name (chaîne, obligatoire) : Le nom de l'action/opération à exécuter
  • path_params (chaîne, facultatif) : Chaîne JSON contenant les paramètres de chemin pour l'action
  • query_params (chaîne, facultatif) : Chaîne JSON contenant les paramètres de requête pour l'action
  • body_schema (chaîne, facultatif, défaut : "{}") : Chaîne JSON contenant le corps de la requête pour les actions
  • include_output_fields (tableau, facultatif) : Facultatif mais fortement recommandé lorsque vous connaissez le response_schema de cette action lors d'appels d'outils 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 (entier, facultatif) : Facultatif : Nombre maximal de caractères à renvoyer dans la réponse. Si la réponse dépasse cette limite, elle sera tronquée. Préférez include_output_fields à ce paramètre.

5. Rechercher dans la documentation

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

**Description** : **OPTION SECONDAIRE** : Utilisez cet outil uniquement lorsque discover_server_categories ne fournit pas suffisamment de détails ou lorsque vous devez rechercher dans la documentation d'un serveur spécifique. Recherchez les documentations d'actions du serveur par catégorie, opération, balises ou fonctionnalité à l'aide de la correspondance de mots-clés. Il ne s'agit pas d'une recherche en langage naturel - elle correspond à des mots-clés et expressions exacts. Renvoie 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, obligatoire) : Mots-clés de recherche correspondant aux termes de la documentation 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 qui apparaissent dans les noms de points de terminaison et les descriptions.
  • server_name (chaîne, obligatoire) : Nom du serveur dans lequel effectuer la recherche.
  • max_results (entier, facultatif, défaut : 10, minimum : 1, maximum : 50) : Nombre de résultats à renvoyer. Défaut : 10

6. Gérer les échecs d'authentification

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

**Description** : Gérer les échecs d'authentification qui se produisent lors de l'exécution d'actions. CRITIQUE : Cet outil ne doit être appelé QUE lorsque execute_action échoue spécifiquement en raison de problèmes d'authentification (401 Non autorisé, identifiants invalides, jetons expirés, etc.). NE PAS appeler cet outil pour vérifier le statut d'authentification ou à toute autre fin. Utilisation : (1) Lorsque execute_action renvoie 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 Introuvable, 500 Erreur interne du serveur, etc.).

Paramètres :

  • server_name (chaîne, obligatoire) : Le nom du serveur qui a échoué à l'authentification lors de execute_action
  • intention (chaîne, obligatoire, énumération : ["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, facultatif) : Données d'authentification fournies par l'utilisateur après un échec d'authentification (par exemple, {"token": "...", "api_key": "..."}). Uniquement utilisé avec l'intention 'save_auth_data' lors de la résolution des échecs d'authentification.

Évaluation

Strata offre des résultats concrets :

  • Référence MCPMark : Atteint un taux de pass@1 supérieur de +15,2 % par rapport au serveur GitHub officiel et un taux de pass@1 supérieur de +13,4 % par rapport au serveur Notion officiel. (Source)
  • Évaluation humaine : Atteint une précision de 83 %+ sur plus de 2 000 ensembles d'évaluation de requêtes réelles

Prochaines étapes

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

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