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

# Autenticação MCP

> Autentique conexões MCP com Bearer tokens e gerencie o escopo do workspace.

## Método de Autenticação

O Canal 3 usa **autenticação Bearer token**. Passe sua chave de API do Alana como Bearer token ao configurar seu cliente MCP.

```
Authorization: Bearer sk_live_sua_chave_api
```

## Escopos Necessários

| Categoria de Ferramenta   | Escopo Necessário        |
| ------------------------- | ------------------------ |
| Ferramentas de catálogo   | `mcp:read`               |
| Ferramentas de otimização | `mcp:read`               |
| Ferramentas de analytics  | `mcp:read`               |
| Ferramentas de feed       | `mcp:read`, `feed:write` |

## Contexto de Workspace

Todas as chamadas de ferramentas MCP são limitadas ao workspace associado à sua chave de API.

## Criando Chaves de API

1. Abra seu workspace no Alana
2. Acesse **Configurações → Chaves de API**
3. Clique em **Nova Chave de API**
4. Habilite o escopo `mcp:read`
5. Copie a chave — ela é exibida apenas uma vez

## Matriz de Escopos

| Ferramenta                 | Escopo Necessário | Descrição                |
| -------------------------- | ----------------- | ------------------------ |
| `search_products`          | `mcp:read`        | Buscar catálogo          |
| `get_product`              | `mcp:read`        | Detalhes do produto      |
| `list_catalogs`            | `mcp:read`        | Listar catálogos         |
| `get_catalog_stats`        | `mcp:read`        | Estatísticas do catálogo |
| `optimize_product`         | `mcp:read`        | Otimizar conteúdo        |
| `batch_optimize`           | `mcp:read`        | Otimização em lote       |
| `get_score`                | `mcp:read`        | Score de otimização      |
| `compare_scores`           | `mcp:read`        | Comparar scores          |
| `get_search_analytics`     | `mcp:read`        | Analytics de busca       |
| `get_query_performance`    | `mcp:read`        | Performance de consultas |
| `get_recommendation_stats` | `mcp:read`        | Stats de recomendações   |
| `generate_description`     | `mcp:read`        | Geração de descrição     |
| `enhance_images`           | `mcp:read`        | Melhoria de imagens      |
| `get_brand_context`        | `mcp:read`        | Contexto de marca        |

## Segurança do Token

* Nunca incorpore chaves de API diretamente em código client-side
* Rotacione chaves regularmente em **Configurações → Chaves de API**
* Use o escopo mínimo necessário para cada integração
* Revogue chaves comprometidas imediatamente pelo painel