Klavis Strata

Strata

Um servidor MCP para agentes de IA usarem ferramentas progressivamente em qualquer 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" />

O que é Strata?

Strata é um servidor MCP que guia agentes de IA a usarem ferramentas de forma confiável em qualquer complexidade, em vez de sobrecarregá-los com tudo de uma vez. Foi projetado pensando na interação humana com ferramentas, resolvendo os três principais problemas que afetam os agentes de IA hoje:

• Sobrecarga de Ferramentas: Muitas ferramentas causam paralisia de escolha no LLM
• Sobrecarga de Contexto: Listas longas de ferramentas aumentam a contagem de tokens e custos
• Lacuna de Cobertura: A maioria dos servidores fica presa em 40~50 ferramentas, limitando o que você pode construir

Você pode usar Strata através do nosso site, API, ou até mesmo código aberto com seus próprios dados!

Tutorial em Vídeo

Assista a este tutorial em vídeo para uma compreensão completa de como o Strata funciona:

Tutorial em Texto

Dica

Confira esta conversa compartilhada no Claude para ver o Strata em ação!

1. Descubra Categorias ou Ações do Servidor

discover_server_categories_or_actions - encontre categorias ou ações relevantes com base na intenção do usuário. Sem busca semântica!

**Descrição**: **PONTO DE PARTIDA PREFERIDO**. Descubra categorias ou ações disponíveis com base na consulta do usuário. Tente esta ferramenta primeiro ao explorar quais ações estão disponíveis nos servidores. Este é o ponto de entrada principal para explorar ações disponíveis e deve ser usado antes de outros métodos de busca. A saída será uma lista de servidores com nível de detalhe e detalhes.

Se o nível de detalhe for 'categories_only', os detalhes serão apenas uma lista de nomes de categorias. Próximo passo: prefira usar a ferramenta get_category_actions para obter as ações das categorias.

Se o nível de detalhe for 'full_details', os detalhes serão uma lista de nomes de categorias com os detalhes de suas ações incluídos. Isso acontece quando o servidor tem apenas algumas ações. Próximo passo: prefira usar a ferramenta execute_action para executar as ações.

Se o nível de detalhe for 'categories_and_actions', os detalhes serão uma lista de nomes de categorias e nomes de ações. Isso acontece ao usar ferramentas externas. Próximo passo: prefira usar a ferramenta get_action_details para obter os detalhes das ações.

Parâmetros:

• user_query (string, obrigatório): Consulta em linguagem natural do usuário para filtrar resultados.
• server_names (array, obrigatório): Lista de nomes de servidores para descobrir categorias ou ações.

2. Obter Ações da Categoria

get_category_actions - recupere todos os nomes de ações dentro das categorias especificadas.

**Descrição**: Obtenha uma visão geral abrangente das ações de API disponíveis em categorias específicas. Use esta ferramenta se quiser explorar quais ações estão disponíveis em categorias de serviço específicas ou obter uma visão detalhada das capacidades da categoria. \*\* Importante \*\*: Só deve ser chamada depois de obter as categorias do servidor com a ferramenta discover_server_categories.

Parâmetros:

• category_names (array, obrigatório): Lista de categorias para obter as ações

3. Obter Detalhes da Ação

get_action_details - obtenha o esquema completo e os parâmetros de uma ação específica.

**Descrição**: Obtenha informações detalhadas sobre uma ação específica, incluindo parâmetros obrigatórios e opcionais. Deve fornecer o nome da categoria e o nome da ação. \*\* Importante \*\*: Só deve ser chamada depois de obter as categorias do servidor nas chamadas de ferramentas anteriores.

Parâmetros:

• category_name (string, obrigatório): O nome da categoria
• action_name (string, obrigatório): O nome da ação/operação dentro da categoria

4. Executar Ação

execute_action - execute ações com parâmetros e obtenha resultados.

**Descrição**: Execute uma ação específica com os parâmetros fornecidos. Deve fornecer o nome do servidor, o nome da ação e os parâmetros da ação. \*\* Importante \*\*: Só deve ser chamada depois de obter os detalhes da ação com a ferramenta get_action_details.

Parâmetros:

• server_name (string, obrigatório): O nome do servidor
• category_name (string, obrigatório): O nome da categoria para executar a ação
• action_name (string, obrigatório): O nome da ação/operação a ser executada
• path_params (string, opcional): String JSON contendo parâmetros de caminho para a ação
• query_params (string, opcional): String JSON contendo parâmetros de consulta para a ação
• body_schema (string, opcional, padrão: "{}"): String JSON contendo o corpo da requisição para ações
• include_output_fields (array, opcional): Opcional, mas fortemente recomendado quando você conhece o response_schema desta ação de chamadas de ferramentas anteriores: Array de caminhos de campos para incluir na resposta. Apenas esses campos serão retornados. Use notação de ponto para campos aninhados (ex.: "author.displayName").
• maximum_output_characters (integer, opcional): Opcional: Número máximo de caracteres a retornar na resposta. Se a resposta exceder este limite, ela será truncada. Prefira include_output_fields em vez disso.

5. Buscar Documentação

search_documentation - encontre informações relevantes apenas quando necessário.

**Descrição**: **OPÇÃO SECUNDÁRIA**: Use esta ferramenta apenas quando discover_server_categories não fornecer detalhes suficientes ou quando precisar buscar na documentação de um servidor específico. Busque documentações de ações do servidor por categoria, operação, tags ou funcionalidade usando correspondência de palavras-chave. Esta não é uma busca em linguagem natural - ela corresponde a palavras-chave e frases exatas. Retorna endpoints classificados por relevância. Use algumas palavras-chave direcionadas para encontrar as melhores correspondências. Padrões comuns: nomes de categorias ('projects', 'users', 'pipelines'), ações ('create', 'delete', 'list', 'get'), ou combinações ('create user', 'list projects'). O algoritmo de busca usa pontuação inteligente para evitar que campos de descrição verbosos sobrecarreguem os resultados.

Parâmetros:

• query (string, obrigatório): Palavras-chave de busca que correspondem aos termos da documentação da API. Melhores práticas: (1) Use nomes de recursos como 'users', 'projects', 'files', (2) Adicione ações para precisão como 'user create' ou 'project delete', (3) Evite palavras de preenchimento como 'how to', 'show me', 'all the' - foque nos termos centrais que aparecem nos nomes e descrições dos endpoints.
• server_name (string, obrigatório): Nome do servidor para buscar.
• max_results (integer, opcional, padrão: 10, mínimo: 1, máximo: 50): Número de resultados a retornar. Padrão: 10

6. Lidar com Falha de Autenticação

handle_auth_failure - lide com a autenticação apenas quando necessário.

**Descrição**: Lide com falhas de autenticação que ocorrem ao executar ações. CRÍTICO: Esta ferramenta só deve ser chamada quando execute_action falhar especificamente devido a problemas de autenticação (401 Não Autorizado, credenciais inválidas, tokens expirados, etc.). NÃO chame esta ferramenta para verificar o status de autenticação ou para qualquer outro propósito. Uso: (1) Quando execute_action retornar um erro de autenticação, chame esta ferramenta com 'get_auth_url' para obter instruções de autenticação. (2) Quando o usuário fornecer dados de autenticação após uma falha, chame esta ferramenta com 'save_auth_data' para salvar as credenciais. NUNCA chame esta ferramenta se a falha NÃO for de autenticação (ex.: 404 Não Encontrado, 500 Erro Interno do Servidor, etc.).

Parâmetros:

• server_name (string, obrigatório): O nome do servidor que falhou na autenticação durante execute_action
• intention (string, obrigatório, enum: ["get_auth_url", "save_auth_data"]): Use 'get_auth_url' quando execute_action falhar com erros de autenticação para obter instruções de autenticação. Use 'save_auth_data' quando o usuário fornecer credenciais de autenticação após uma falha de autenticação.
• auth_data (object, opcional): Dados de autenticação fornecidos pelo usuário após uma falha de autenticação (ex.: {"token": "...", "api_key": "..."}). Usado apenas com a intenção 'save_auth_data' ao resolver falhas de autenticação.

Avaliação

O Strata entrega resultados reais:

• Benchmark MCPMark: Alcança +15,2% maior taxa de pass@1 em comparação com o servidor oficial do GitHub e +13,4% maior taxa de pass@1 em comparação com o servidor oficial do Notion. (Fonte)
• Avaliação Humana: Alcança precisão de 83%+ em mais de 2 mil consultas reais em conjuntos de avaliação

Próximos Passos

Crie seu primeiro servidor Strata em minutos Explore a API completa do Strata

Esta documentação é construída e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.