Klavis Strata

oficial

Um servidor MCP para agentes de IA usarem qualquer ferramenta de forma confiável em qualquer escala.

O que você pode fazer com Klavis Strata MCP?

  • Descobrir ações relevantes — Peça ao seu assistente para encontrar categorias ou ações em servidores nomeados com base em uma intenção expressa em linguagem natural usando discover_server_categories_or_actions.
  • Listar ações de uma categoria — Recupere todos os nomes de ações em categorias específicas com get_category_actions antes de consultar os detalhes.
  • Inspecionar esquemas de ações — Obtenha os parâmetros obrigatórios e opcionais de uma ação específica por meio de get_action_details, usando o nome de uma categoria e de uma ação.
  • Executar ações — Execute uma ação com parâmetros de caminho, consulta e corpo por meio de execute_action, limitando opcionalmente os campos retornados com include_output_fields.
  • Pesquisar a documentação do servidor — Encontre endpoints por palavra-chave na documentação de um servidor usando search_documentation quando a descoberta não fornecer detalhes suficientes.
  • Resolver falhas de autenticação — Obtenha instruções de autenticação ou salve credenciais após um erro de autenticação usando handle_auth_failure.

Documentação

Strata

Um servidor MCP para agentes de IA usarem ferramentas progressivamente em qualquer escala

Strata Hero - Progressive tool discovery for AI agents

O que é Strata?

Strata é um servidor MCP que orienta agentes de IA a usar ferramentas de forma confiável, independentemente da complexidade, em vez de sobrecarregá-los com tudo de uma vez. Ele foi projetado com base na forma como as pessoas interagem com ferramentas, para resolver os três principais problemas que afetam os agentes de IA atualmente:

  • Sobrecarga de ferramentas: ferramentas demais causam paralisia na escolha do LLM
  • Sobrecarga de contexto: listas longas de ferramentas aumentam o número de tokens e os custos
  • Lacuna de cobertura: a maioria dos servidores está limitada a 40~50 ferramentas, restringindo o que você pode criar

Você pode usar o Strata pelo nosso site, API ou até mesmo como código aberto com seus próprios dados!

Tutorial em vídeo

Assista a este tutorial em vídeo para entender completamente como o Strata funciona:

Strata

Tutorial em texto

[!TIP]

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

1. Descobrir 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!

[accordion] Detalhes da ferramenta

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

Se o nível de detalhe for 'categories_only', os detalhes serão uma lista contendo apenas os nomes das categorias. Como próxima etapa, 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 das ações incluídos. Isso ocorre quando o servidor tem poucas ações. Como próxima etapa, 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 ações. Isso ocorre ao usar ferramentas externas. Como próxima etapa, 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 os 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 nas categorias especificadas.

[accordion] Detalhes da ferramenta

Descrição: Obtenha uma visão geral abrangente das ações de API disponíveis em categorias específicas. Use esta ferramenta para explorar as ações disponíveis em determinadas categorias de serviço ou obter uma visão detalhada dos recursos de uma categoria. ** Importante **: ela só deve ser chamada depois que você obtiver as categorias do servidor usando a ferramenta discover_server_categories.

Parâmetros:

  • category_names (array, obrigatório): Lista de categorias para as quais obter 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.

[accordion] Detalhes da ferramenta

Descrição: Obtenha informações detalhadas sobre uma ação específica, incluindo parâmetros obrigatórios e opcionais. É necessário fornecer o nome da categoria e o nome da ação. ** Importante **: ela só deve ser chamada depois que você obtiver as categorias do servidor em chamadas anteriores à ferramenta.

Parâmetros:

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

4. Executar ação

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

[accordion] Detalhes da ferramenta

Descrição: Execute uma ação específica com os parâmetros fornecidos. É necessário fornecer o nome do servidor, o nome da ação e os parâmetros da ação. ** Importante **: ela só deve ser chamada depois que você obtiver os detalhes da ação usando 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 a qual executar a ação
  • action_name (string, obrigatório): O nome da ação/operação a executar
  • 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 solicitação para as ações
  • include_output_fields (array, opcional): Opcional, mas fortemente recomendado quando você conhece o response_schema desta ação de chamadas anteriores à ferramenta: matriz de caminhos de campos a incluir na resposta. Somente esses campos serão retornados. Use a notação de ponto para campos aninhados (por exemplo, "author.displayName").
  • maximum_output_characters (integer, opcional): Opcional: número máximo de caracteres a retornar na resposta. Se a resposta exceder esse limite, ela será truncada. Prefira include_output_fields a esta opção.

5. Pesquisar documentação

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

[accordion] Detalhes da ferramenta

Descrição: OPÇÃO SECUNDÁRIA: use esta ferramenta somente quando discover_server_categories não fornecer detalhes suficientes ou quando precisar pesquisar a documentação de um servidor específico. Pesquise a documentação das 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 específicas 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 uma pontuação inteligente para evitar que campos de descrição prolixos dominem os resultados.

Parâmetros:

  • query (string, obrigatório): Palavras-chave de busca que correspondem aos termos da documentação da API. Práticas recomendadas: (1) use nomes de recursos como 'users', 'projects', 'files'; (2) adicione ações para obter mais precisão, como 'user create' ou 'project delete'; (3) evite palavras de preenchimento como 'how to', 'show me', 'all the' — concentre-se nos termos principais que aparecem nos nomes e nas descrições dos endpoints.
  • server_name (string, obrigatório): Nome do servidor no qual pesquisar.
  • 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 somente quando necessário.

[accordion] Detalhes da ferramenta

Descrição: Lide com falhas de autenticação que ocorram durante a execução de ações. CRÍTICO: esta ferramenta deve ser chamada SOMENTE quando execute_action falhar especificamente devido a problemas de autenticação (401 Unauthorized, credenciais inválidas, tokens expirados etc.). NÃO chame esta ferramenta para verificar o status da autenticação nem para qualquer outra finalidade. 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 (por exemplo, 404 Not Found, 500 Internal Server Error etc.).

Parâmetros:

  • server_name (string, obrigatório): O nome do servidor cuja autenticação falhou 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 (por exemplo, {"token": "...", "api_key": "..."}). Usado somente com a intenção 'save_auth_data' ao resolver falhas de autenticação.

Avaliação

Strata oferece resultados reais:

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

Próximas etapas

[card] Começar

Crie seu primeiro servidor Strata em minutos

[card] Referência da API

Explore a API completa do Strata

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