Klavis Strata

oficial

Un servidor MCP para que agentes de IA utilicen cualquier herramienta de manera confiable a cualquier escala.

¿Qué puedes hacer con Klavis Strata MCP?

  • Descubrir herramientas relevantes por intención — Pide al asistente que encuentre categorías o acciones coincidentes entre servidores usando discover_server_categories_or_actions con una consulta en lenguaje natural.
  • Explorar acciones dentro de categorías — Solicita una lista de todos los nombres de acciones para categorías de servicio específicas mediante get_category_actions.
  • Inspeccionar esquemas de acciones — Obtén detalles completos de parámetros para una acción específica proporcionando su categoría y nombre de acción con get_action_details.
  • Ejecutar acciones de API — Ejecuta una acción del servidor con parámetros de ruta, consulta o cuerpo, y opcionalmente filtra campos de salida, usando execute_action.
  • Buscar documentación del servidor — Pide búsquedas de documentación basadas en palabras clave dentro de un servidor para encontrar endpoints relevantes usando search_documentation.
  • Resolver fallos de autenticación — Maneja errores 401 recuperando URLs de autenticación o guardando credenciales proporcionadas por el usuario con handle_auth_failure.

Documentación

Strata

Un servidor MCP para que los agentes de IA usen herramientas de forma progresiva a cualquier escala

<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é es Strata?

Strata es un servidor MCP que guía a los agentes de IA para que usen herramientas de manera confiable a cualquier nivel de complejidad, en lugar de abrumarlos con todo a la vez. Fue diseñado pensando en cómo los humanos interactúan con las herramientas, resolviendo los tres grandes problemas que afectan a los agentes de IA hoy en día:

  • Sobrecarga de herramientas: Demasiadas herramientas causan parálisis de elección en los LLM
  • Sobrecarga de contexto: Las listas largas de herramientas disparan los conteos de tokens y los costos
  • Brecha de cobertura: La mayoría de los servidores se quedan en 40~50 herramientas, limitando lo que puedes construir

Puedes usar Strata a través de nuestro sitio web, API, o incluso código abierto con tus propios datos.

Video Tutorial

Mira este video tutorial para una comprensión completa de cómo funciona Strata:

Tutorial de Texto

Consejo

¡Revisa esta conversación compartida de Claude para ver Strata en acción!

1. Descubre Categorías o Acciones del Servidor

discover_server_categories_or_actions - encuentra categorías o acciones relevantes según la intención del usuario. ¡Sin búsqueda semántica!

**Descripción**: **PUNTO DE PARTIDA PREFERIDO**. Descubre categorías o acciones disponibles según la consulta del usuario. Prueba esta herramienta primero al explorar qué acciones están disponibles en los servidores. Este es el punto de entrada principal para explorar acciones disponibles y debe usarse antes que otros métodos de búsqueda. La salida será una lista de servidores con nivel de detalle y detalles.

Si el nivel de detalle es 'categories_only', los detalles serán solo una lista de nombres de categorías. Como siguiente paso, prefiere usar la herramienta get_category_actions para obtener las acciones de las categorías.

Si el nivel de detalle es 'full_details', los detalles serán una lista de nombres de categorías con sus detalles de acciones incluidos. Esto ocurre cuando el servidor tiene solo unas pocas acciones. Como siguiente paso, prefiere usar la herramienta execute_action para ejecutar las acciones.

Si el nivel de detalle es 'categories_and_actions', los detalles serán una lista de nombres de categorías y nombres de acciones. Esto ocurre cuando se usan herramientas externas. Como siguiente paso, prefiere usar la herramienta get_action_details para obtener los detalles de las acciones.

Parámetros:

  • user_query (string, obligatorio): Consulta de lenguaje natural del usuario para filtrar resultados.
  • server_names (array, obligatorio): Lista de nombres de servidores para descubrir categorías o acciones.

2. Obtener Acciones de Categoría

get_category_actions - recupera todos los nombres de acciones dentro de categorías específicas.

**Descripción**: Obtén una visión general completa de las acciones de API disponibles dentro de categorías específicas. Usa esta herramienta si quieres explorar qué acciones están disponibles en categorías de servicio particulares u obtener una vista detallada de las capacidades de la categoría. \*\* Importante \*\*: Solo debe llamarse después de obtener las categorías del servidor con la herramienta discover_server_categories.

Parámetros:

  • category_names (array, obligatorio): Lista de categorías para obtener acciones

3. Obtener Detalles de Acción

get_action_details - obtén el esquema completo y los parámetros de una acción específica.

**Descripción**: Obtén información detallada sobre una acción específica, incluidos los parámetros obligatorios y opcionales. Debes proporcionar el nombre de la categoría y el nombre de la acción. \*\* Importante \*\*: Solo debe llamarse después de obtener las categorías del servidor de llamadas anteriores a herramientas.

Parámetros:

  • category_name (string, obligatorio): El nombre de la categoría
  • action_name (string, obligatorio): El nombre de la acción/operación dentro de la categoría

4. Ejecutar Acción

execute_action - ejecuta acciones con parámetros y obtén resultados.

**Descripción**: Ejecuta una acción específica con los parámetros proporcionados. Debes proporcionar el nombre del servidor, el nombre de la acción y los parámetros de la acción. \*\* Importante \*\*: Solo debe llamarse después de obtener los detalles de la acción con la herramienta get_action_details.

Parámetros:

  • server_name (string, obligatorio): El nombre del servidor
  • category_name (string, obligatorio): El nombre de la categoría para ejecutar la acción
  • action_name (string, obligatorio): El nombre de la acción/operación a ejecutar
  • path_params (string, opcional): Cadena JSON que contiene parámetros de ruta para la acción
  • query_params (string, opcional): Cadena JSON que contiene parámetros de consulta para la acción
  • body_schema (string, opcional, predeterminado: "{}"): Cadena JSON que contiene el cuerpo de la solicitud para acciones
  • include_output_fields (array, opcional): Opcional pero muy recomendado cuando conoces el response_schema de esta acción de llamadas anteriores a herramientas: Array de rutas de campos para incluir en la respuesta. Solo se devolverán estos campos. Usa notación de puntos para campos anidados (por ejemplo, "author.displayName").
  • maximum_output_characters (integer, opcional): Opcional: Número máximo de caracteres a devolver en la respuesta. Si la respuesta excede este límite, se truncará. Prefiere include_output_fields sobre esto.

5. Buscar Documentación

search_documentation - encuentra información relevante solo cuando sea necesario.

**Descripción**: **OPCIÓN SECUNDARIA**: Usa esta herramienta solo cuando discover_server_categories no proporcione suficiente detalle o cuando necesites buscar dentro de la documentación de un servidor específico. Busca documentación de acciones del servidor por categoría, operación, etiquetas o funcionalidad usando coincidencia de palabras clave. Esto no es una búsqueda de lenguaje natural: coincide con palabras clave y frases exactas. Devuelve endpoints clasificados por relevancia. Usa algunas palabras clave específicas para encontrar las mejores coincidencias. Patrones comunes: nombres de categorías ('projects', 'users', 'pipelines'), acciones ('create', 'delete', 'list', 'get'), o combinaciones ('create user', 'list projects'). El algoritmo de búsqueda usa puntuación inteligente para evitar que los campos de descripción extensos abrumen los resultados.

Parámetros:

  • query (string, obligatorio): Palabras clave de búsqueda que coinciden con términos de documentación de API. Mejores prácticas: (1) Usa nombres de recursos como 'users', 'projects', 'files', (2) Agrega acciones para precisión como 'user create' o 'project delete', (3) Evita palabras de relleno como 'how to', 'show me', 'all the': concéntrate en los términos centrales que aparecen en nombres de endpoints y descripciones.
  • server_name (string, obligatorio): Nombre del servidor en el que buscar.
  • max_results (integer, opcional, predeterminado: 10, mínimo: 1, máximo: 50): Número de resultados a devolver. Predeterminado: 10

6. Manejar Fallo de Autenticación

handle_auth_failure - maneja la autenticación solo cuando sea necesario.

**Descripción**: Maneja fallos de autenticación que ocurren al ejecutar acciones. CRÍTICO: Esta herramienta solo debe llamarse cuando execute_action falla específicamente debido a problemas de autenticación (401 No autorizado, credenciales inválidas, tokens expirados, etc.). NO llames a esta herramienta para verificar el estado de autenticación ni para ningún otro propósito. Uso: (1) Cuando execute_action devuelve un error de autenticación, llama a esta herramienta con 'get_auth_url' para obtener instrucciones de autenticación. (2) Cuando el usuario proporciona datos de autenticación después de un fallo, llama a esta herramienta con 'save_auth_data' para guardar las credenciales. NUNCA llames a esta herramienta si el fallo NO es de autenticación (por ejemplo, 404 No encontrado, 500 Error interno del servidor, etc.).

Parámetros:

  • server_name (string, obligatorio): El nombre del servidor que falló la autenticación durante execute_action
  • intention (string, obligatorio, enum: ["get_auth_url", "save_auth_data"]): Usa 'get_auth_url' cuando execute_action falla con errores de autenticación para obtener instrucciones de autenticación. Usa 'save_auth_data' cuando el usuario proporciona credenciales de autenticación después de un fallo de autenticación.
  • auth_data (object, opcional): Datos de autenticación proporcionados por el usuario después de un fallo de autenticación (por ejemplo, {"token": "...", "api_key": "..."}). Solo se usa con la intención 'save_auth_data' al resolver fallos de autenticación.

Evaluación

Strata ofrece resultados reales:

  • Benchmark MCPMark: Logra una tasa de pass@1 +15.2% más alta vs el servidor oficial de GitHub y una tasa de pass@1 +13.4% más alta vs el servidor oficial de Notion. (Fuente)
  • Evaluación Humana: Alcanza precisión del 83%+ en conjuntos de evaluación de más de 2k consultas del mundo real

Próximos Pasos

Crea tu primer servidor Strata en minutos Explora la API completa de Strata

Esta documentación está construida y alojada en Mintlify, una plataforma de documentación para desarrolladores.