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

# Integrações

> Conecte Alana Shopping a plataformas de e-commerce e fontes de dados externas.

## Visão geral

Alana Shopping integra com plataformas de e-commerce e provedores de dados para sincronizar dados de produtos bidirecionalmente. Integrações usam OAuth para autorização segura e suportam cronogramas de sincronização automática.

## Conectando uma plataforma

<Steps>
  <Step title="Autorizar">
    Inicie o fluxo OAuth para conectar sua conta de e-commerce:

    ```bash theme={null}
    curl -X POST "https://app.alana.shopping/api/integrations/authorize" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"platform": "shopify", "workspaceId": "ws_..."}'
    ```

    Isso retorna uma URL de autorização. Redirecione o usuário para completar OAuth.
  </Step>

  <Step title="Callback">
    Após autorização, a plataforma redireciona para nossa URL de callback com credenciais que são armazenadas com segurança.
  </Step>

  <Step title="Sincronizar">
    Acione uma sincronização inicial para puxar produtos da plataforma conectada:

    ```bash theme={null}
    curl -X POST "https://app.alana.shopping/api/integrations/sync" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"workspaceId": "ws_...", "platform": "shopify"}'
    ```
  </Step>
</Steps>

## Verificando status de integração

```bash theme={null}
curl "https://app.alana.shopping/api/integrations/status" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Retorna o status da conexão, horário da última sincronização e quaisquer erros para cada integração configurada.

## Monitoramento de sincronização

Após acionar uma sincronização, monitore seu progresso:

```bash theme={null}
curl "https://app.alana.shopping/api/integrations/sync/status" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Integração MCP

Para integrações avançadas, Alana Shopping suporta o **Model Context Protocol (MCP)**:

* **Inbound** — receba lotes de produtos via `/api/mcp/inbound`
* **Assinaturas de feed** — assine feeds de produtos via `/api/mcp/feed/{platform}`
* **Busca** — consulte através de fontes integradas via `/api/mcp/search`