Klavis Strata

Strata

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

<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-сервер, который помогает ИИ-агентам надежно использовать инструменты при любой сложности, вместо того чтобы перегружать их всем сразу. Он был разработан с учетом того, как человек взаимодействует с инструментами, и решает три основные проблемы, с которыми сегодня сталкиваются ИИ-агенты:

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

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

Видеоурок

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

Текстовое руководство Посмотрите этот [общий диалог с Claude](https://claude.ai/share/9b44a192-9f2d-46e2-a875-ef905c457070), чтобы увидеть 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 (строка, обязательно, перечисление: ["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