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

# Visão Geral das Ferramentas MCP

> Canal 3 — Conecte agentes de IA ao seu catálogo com 22 ferramentas MCP em 6 categorias.

## O que é o Canal 3?

O Canal 3 é o servidor MCP (Model Context Protocol) do Alana. Ele expõe seu catálogo de produtos como um conjunto de ferramentas que agentes de IA — Claude, GPT-4, Cursor, Windsurf e qualquer cliente MCP compatível — podem chamar diretamente durante uma conversa ou fluxo de trabalho.

Ao contrário da API REST (Canal 2), as ferramentas MCP são projetadas para **consumo por agentes**: entradas estruturadas, saídas estruturadas, sem boilerplate de paginação.

## 22 Ferramentas em 6 Categorias

| Categoria          | Ferramentas | Descrição                                 |
| ------------------ | ----------- | ----------------------------------------- |
| **Catálogo**       | 4           | Buscar e navegar por produtos             |
| **Otimização**     | 4           | Otimização de conteúdo com IA             |
| **Busca**          | 3           | Busca avançada e recomendações            |
| **Mídia/Contexto** | 3           | Ferramentas de imagem e contexto de marca |
| **Analytics**      | 3           | Métricas de performance e consultas       |
| **Feed**           | 3           | Geração e status de feeds                 |

## Transporte

O Canal 3 usa transporte **SSE (Server-Sent Events)** sobre HTTPS:

```
https://app.alana.shopping/api/mcp/sse
```

## Quando Usar MCP vs REST

| Caso de uso                                                   | Recomendado            |
| ------------------------------------------------------------- | ---------------------- |
| Agente de IA precisa de dados de produto durante uma conversa | **MCP (Canal 3)**      |
| Sincronização em lote agendada para plataforma externa        | **Feed API (Canal 1)** |
| Dashboard ou integração de app personalizado                  | **API REST (Canal 2)** |
| Feed nativo de plataforma (Google, Meta)                      | **Feed API (Canal 1)** |

## Início Rápido

1. Obtenha uma chave de API em **Configurações → Chaves de API** com escopo `mcp:read`
2. Configure seu cliente MCP com o endpoint SSE e Bearer token
3. Chame ferramentas como `search_products` ou `optimize_product` do seu agente

Consulte [Conectando Agentes](/pt/api-reference/mcp/connecting-agents) para instruções específicas de cada cliente.

## Filtragem de Ferramentas

Carregar todas as 22 ferramentas adiciona contexto a cada conversa do agente. Use variáveis de ambiente para carregar apenas as ferramentas necessárias:

```bash theme={null}
ALANA_MCP_GROUPS=catalog,search    # Carregar apenas ferramentas de catálogo + busca
ALANA_MCP_TOOLS=search_products    # Carregar apenas uma ferramenta específica
```

Consulte [Filtragem de Ferramentas](/pt/api-reference/mcp/tool-filtering) para detalhes completos.