Filtragem de Ferramentas

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:

Grupo	Ferramentas Incluídas
`catalog`	`search_products`, `get_product`, `list_catalogs`, `get_catalog_stats`
`optimization`	`optimize_product`, `batch_optimize`, `get_score`, `compare_scores`
`media`	`generate_description`, `enhance_images`, `get_brand_context`
`analytics`	`get_search_analytics`, `get_query_performance`, `get_recommendation_stats`
`feed`	Ferramentas de geração e status de feed
`search`	Ferramentas 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ção	Ferramentas	Custo Aproximado em Tokens
Todas as ferramentas (padrão)	22	~4.200 tokens
Apenas grupo `catalog`	4	~760 tokens
Ferramenta única	1	~190 tokens

Filtrar para as ferramentas necessárias pode economizar mais de 3.000 tokens por conversa — significativo para sessões longas de agentes.

Última modificação em 18 de março de 2026

⌘I

Visão Geral

Workspace

Membros

Marcas

Dashboards

Catálogos

Produtos

Surfaces

Serviços de IA

Faturamento

Chaves de API

Integrações

Reference

Search API v1

Platform Adapters

Analytics

Feed API

MCP Tools

Data Pipeline

Marketplace Hub

Guias de Plataforma

Por que Filtrar Ferramentas?

Variáveis de Ambiente

ALANA_MCP_GROUPS

ALANA_MCP_TOOLS

Exemplos de Configuração

Agente de catálogo (somente leitura)

Agente de otimização de conteúdo

Agente de analytics

Agente de ferramenta única

Aplicando na Configuração do Cliente MCP

Claude Desktop

Impacto na Janela de Contexto

​Por que Filtrar Ferramentas?

​Variáveis de Ambiente

​ALANA_MCP_GROUPS

​ALANA_MCP_TOOLS

​Exemplos de Configuração

​Agente de catálogo (somente leitura)

​Agente de otimização de conteúdo

​Agente de analytics

​Agente de ferramenta única

​Aplicando na Configuração do Cliente MCP

​Claude Desktop

​Impacto na Janela de Contexto

Por que Filtrar Ferramentas?

Variáveis de Ambiente

ALANA_MCP_GROUPS

ALANA_MCP_TOOLS

Exemplos de Configuração

Agente de catálogo (somente leitura)

Agente de otimização de conteúdo

Agente de analytics

Agente de ferramenta única

Aplicando na Configuração do Cliente MCP

Claude Desktop

Impacto na Janela de Contexto