Klavis Strata

официальный

Один MCP-сервер для AI-агентов, позволяющий надёжно использовать любые инструменты в любом масштабе.

Что можно делать с Klavis Strata MCP?

  • Discover relevant tools by intent — Ask the assistant to find matching categories or actions across servers using discover_server_categories_or_actions with a natural language query.
  • Explore actions within categories — Request a list of all action names for specific service categories via get_category_actions.
  • Inspect action schemas — Get full parameter details for a specific action by providing its category and action name with get_action_details.
  • Execute API actions — Run a server action with path, query, or body parameters, and optionally filter output fields, using execute_action.
  • Search server documentation — Ask for keyword-based documentation lookups within a server to find relevant endpoints using search_documentation.
  • Resolve authentication failures — Handle 401 errors by retrieving auth URLs or saving user-provided credentials with handle_auth_failure.

Документация

Strata

Один MCP-сервер, который позволяет AI-агентам прогрессивно использовать инструменты любого масштаба

<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" />

Что такое Strata?

Strata — это один MCP-сервер, который помогает AI-агентам надёжно использовать инструменты любой сложности, не перегружая их всем сразу. Он был спроектирован с учётом того, как человек взаимодействует с инструментами, и решает три главные проблемы, которые сегодня мешают AI-агентам:

  • Перегрузка инструментами: Слишком много инструментов вызывает паралич выбора у LLM
  • Перегрузка контекста: Длинные списки инструментов раздувают количество токенов и затраты
  • Пробел в покрытии: Большинство серверов застревают на 40–50 инструментах, ограничивая то, что можно создать

Вы можете использовать Strata через наш веб-сайт, API или даже открытый исходный код на собственных данных!

Видеоурок

Посмотрите этот видеоурок, чтобы полностью понять, как работает Strata:

Текстовый учебник

Совет

Ознакомьтесь с этим общим разговором в Claude, чтобы увидеть Strata в действии!

1. Обнаружение категорий сервера или действий

discover_server_categories_or_actions — найдите релевантные категории или действия на основе намерения пользователя. Без семантического поиска!

**Описание**: **ПРЕДПОЧТИТЕЛЬНАЯ ТОЧКА СТАРТА**. Обнаружение доступных категорий или действий на основе запроса пользователя. Попробуйте этот инструмент первым при изучении доступных действий на серверах. Это основная точка входа для изучения доступных действий, и её следует использовать перед другими методами поиска. Результатом будет список серверов с уровнем детализации и подробностями.

Если уровень детализации — 'categories_only', подробности будут представлять собой только список названий категорий. На следующем шаге предпочтительнее использовать инструмент get_category_actions для получения действий по категориям.

Если уровень детализации — 'full_details', подробности будут представлять собой список названий категорий с включёнными описаниями действий. Это происходит, когда на сервере всего несколько действий. На следующем шаге предпочтительнее использовать инструмент execute_action для выполнения действий.

Если уровень детализации — 'categories_and_actions', подробности будут представлять собой список названий категорий и названий действий. Это происходит при использовании внешних инструментов. На следующем шаге предпочтительнее использовать инструмент get_action_details для получения подробностей о действиях.

Параметры:

  • user_query (строка, обязательный): Естественно-языковой запрос пользователя для фильтрации результатов.
  • server_names (массив, обязательный): Список названий серверов для обнаружения категорий или действий.

2. Получение действий категории

get_category_actions — получите все названия действий в указанных категориях.

**Описание**: Получите комплексный обзор действий API, доступных в конкретных категориях. Используйте этот инструмент, если хотите изучить, какие действия доступны в определённых категориях сервисов, или получить подробное представление о возможностях категорий. \*\* Важно \*\*: Его следует вызывать только после получения категорий сервера из инструмента discover_server_categories.

Параметры:

  • category_names (массив, обязательный): Список категорий для получения действий

3. Получение подробностей о действии

get_action_details — получите полную схему и параметры для конкретного действия.

**Описание**: Получите подробную информацию о конкретном действии, включая обязательные и необязательные параметры. Необходимо указать название категории и название действия. \*\* Важно \*\*: Его следует вызывать только после получения категорий сервера из предыдущих вызовов инструментов.

Параметры:

  • category_name (строка, обязательный): Название категории
  • action_name (строка, обязательный): Название действия/операции в рамках категории

4. Выполнение действия

execute_action — запустите действия с параметрами и получите результаты.

**Описание**: Выполните конкретное действие с предоставленными параметрами. Необходимо указать название сервера, название действия и параметры действия. \*\* Важно \*\*: Его следует вызывать только после получения подробностей о действии из инструмента get_action_details.

Параметры:

  • server_name (строка, обязательный): Название сервера
  • category_name (строка, обязательный): Название категории, для которой выполняется действие
  • action_name (строка, обязательный): Название действия/операции для выполнения
  • path_params (строка, необязательный): JSON-строка, содержащая параметры пути для действия
  • query_params (строка, необязательный): JSON-строка, содержащая параметры запроса для действия
  • body_schema (строка, необязательный, по умолчанию: "{}"): JSON-строка, содержащая тело запроса для действий
  • include_output_fields (массив, необязательный): Необязательно, но настоятельно рекомендуется, если вы знаете response_schema этого действия из предыдущих вызовов инструментов: Массив путей полей для включения в ответ. Будут возвращены только эти поля. Используйте точечную нотацию для вложенных полей (например, "author.displayName").
  • maximum_output_characters (целое число, необязательный): Необязательно: Максимальное количество символов для возврата в ответе. Если ответ превышает этот лимит, он будет обрезан. Предпочтительнее использовать include_output_fields вместо этого.

5. Поиск по документации

search_documentation — находите релевантную информацию только при необходимости.

**Описание**: **ВТОРОЙ ВАРИАНТ**: Используйте этот инструмент только тогда, когда discover_server_categories не даёт достаточной детализации или когда нужно искать в документации конкретного сервера. Поиск документации действий сервера по категории, операции, тегам или функциональности с использованием сопоставления ключевых слов. Это не естественно-языковой поиск — он сопоставляет точные ключевые слова и фразы. Возвращает конечные точки, ранжированные по релевантности. Используйте несколько целевых ключевых слов для поиска наилучших совпадений. Распространённые шаблоны: названия категорий ('projects', 'users', 'pipelines'), действия ('create', 'delete', 'list', 'get') или комбинации ('create user', 'list projects'). Алгоритм поиска использует умную оценку, чтобы подробные поля описаний не перегружали результаты.

Параметры:

  • query (строка, обязательный): Ключевые слова поиска, соответствующие терминам документации API. Рекомендации: (1) Используйте названия ресурсов, такие как 'users', 'projects', 'files', (2) Добавляйте действия для точности, например 'user create' или 'project delete', (3) Избегайте слов-паразитов, таких как 'how to', 'show me', 'all the' — сосредоточьтесь на основных терминах, которые встречаются в названиях конечных точек и описаниях.
  • server_name (строка, обязательный): Название сервера, в котором выполняется поиск.
  • max_results (целое число, необязательный, по умолчанию: 10, минимум: 1, максимум: 50): Количество возвращаемых результатов. По умолчанию: 10

6. Обработка сбоя аутентификации

handle_auth_failure — обрабатывайте аутентификацию только при необходимости.

**Описание**: Обработка сбоев аутентификации, возникающих при выполнении действий. КРИТИЧЕСКИ ВАЖНО: Этот инструмент следует вызывать ТОЛЬКО тогда, когда execute_action завершается сбоем именно из-за проблем с аутентификацией (401 Unauthorized, недействительные учётные данные, истёкшие токены и т. д.). НЕ вызывайте этот инструмент для проверки статуса аутентификации или для любых других целей. Использование: (1) Когда execute_action возвращает ошибку аутентификации, вызовите этот инструмент с 'get_auth_url', чтобы получить инструкции по аутентификации. (2) Когда пользователь предоставляет данные аутентификации после сбоя, вызовите этот инструмент с 'save_auth_data', чтобы сохранить учётные данные. НИКОГДА не вызывайте этот инструмент, если сбой НЕ связан с аутентификацией (например, 404 Not Found, 500 Internal Server Error и т. д.).

Параметры:

  • server_name (строка, обязательный): Название сервера, у которого произошёл сбой аутентификации во время execute_action
  • intention (строка, обязательный, enum: ["get_auth_url", "save_auth_data"]): Используйте 'get_auth_url', когда execute_action завершается сбоем с ошибками аутентификации, чтобы получить инструкции по аутентификации. Используйте 'save_auth_data', когда пользователь предоставляет учётные данные аутентификации после сбоя аутентификации.
  • auth_data (объект, необязательный): Данные аутентификации, предоставленные пользователем после сбоя аутентификации (например, {"token": "...", "api_key": "..."}). Используется только с намерением 'save_auth_data' при разрешении сбоев аутентификации.

Оценка

Strata даёт реальные результаты:

  • Бенчмарк MCPMark: Достигает +15,2% более высокого показателя pass@1 по сравнению с официальным сервером GitHub и +13,4% более высокого показателя pass@1 по сравнению с официальным сервером Notion. (Источник)
  • Оценка человеком: Достигает точности 83%+ на наборах оценки из более чем 2 тысяч реальных запросов

Следующие шаги

Создайте свой первый сервер Strata за считанные минуты Изучите полный API Strata

Эта документация создана и размещена на Mintlify, платформе документации для разработчиков.