Pular para o conteúdo principal

​
Por que Filtrar Ferramentas?

Cada ferramenta MCP ativa consome contexto na janela de conversa do agente. Carregar todas as 22 ferramentas quando seu agente precisa apenas de busca de catálogo desperdiça tokens e pode confundir o modelo com opções irrelevantes. A filtragem de ferramentas permite carregar apenas as ferramentas relevantes para seu caso de uso — reduzindo o tamanho do contexto e melhorando o foco.

​
Variáveis de Ambiente

​
ALANA_MCP_GROUPS

Carregue uma categoria inteira de ferramentas pelo nome do grupo: 
ALANA_MCP_GROUPS=catalog,search
Grupos disponíveis:
GrupoFerramentas Incluídas
catalogsearch_products, get_product, list_catalogs, get_catalog_stats
optimizationoptimize_product, batch_optimize, get_score, compare_scores
mediagenerate_description, enhance_images, get_brand_context
analyticsget_search_analytics, get_query_performance, get_recommendation_stats
feedFerramentas de geração e status de feed
searchFerramentas de busca avançada e recomendações

​
ALANA_MCP_TOOLS

Carregue ferramentas específicas pelo nome exato: 
ALANA_MCP_TOOLS=search_products,get_product,optimize_product

​
Exemplos de Configuração

​
Agente de catálogo (somente leitura)

ALANA_MCP_GROUPS=catalog
Carrega 4 ferramentas: search_products, get_product, list_catalogs, get_catalog_stats.

​
Agente de otimização de conteúdo

ALANA_MCP_GROUPS=catalog,optimization,media
Carrega 11 ferramentas cobrindo descoberta, otimização e geração de conteúdo.

​
Agente de analytics

ALANA_MCP_GROUPS=analytics
Carrega 3 ferramentas — mínimo contexto para fluxos de relatório.

​
Agente de ferramenta única

ALANA_MCP_TOOLS=search_products
Carrega exatamente 1 ferramenta — máximo foco para integrações específicas de busca.

​
Aplicando na Configuração do Cliente MCP

​
Claude Desktop

{
  "mcpServers": {
    "alana-catalogo": {
      "url": "https://app.alana.shopping/api/mcp/sse",
      "headers": {
        "Authorization": "Bearer sk_live_sua_chave_api",
        "X-MCP-Groups": "catalog,search"
      }
    }
  }
}

​
Impacto na Janela de Contexto

ConfiguraçãoFerramentasCusto Aproximado em Tokens
Todas as ferramentas (padrão)22~4.200 tokens
Apenas grupo catalog4~760 tokens
Ferramenta única1~190 tokens
Filtrar para as ferramentas necessárias pode economizar mais de 3.000 tokens por conversa — significativo para sessões longas de agentes.
Last modified on March 18, 2026