> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alana.shopping/llms.txt
> Use this file to discover all available pages before exploring further.

# Filtragem de Ferramentas

> Carregue apenas as ferramentas MCP necessárias usando ALANA_MCP_GROUPS e ALANA_MCP_TOOLS.

## 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:

```bash theme={null}
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:

```bash theme={null}
ALANA_MCP_TOOLS=search_products,get_product,optimize_product
```

## Exemplos de Configuração

### Agente de catálogo (somente leitura)

```bash theme={null}
ALANA_MCP_GROUPS=catalog
```

Carrega 4 ferramentas: `search_products`, `get_product`, `list_catalogs`, `get_catalog_stats`.

### Agente de otimização de conteúdo

```bash theme={null}
ALANA_MCP_GROUPS=catalog,optimization,media
```

Carrega 11 ferramentas cobrindo descoberta, otimização e geração de conteúdo.

### Agente de analytics

```bash theme={null}
ALANA_MCP_GROUPS=analytics
```

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

### Agente de ferramenta única

```bash theme={null}
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

```json theme={null}
{
  "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.