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

# Integrations

> Connect Alana Shopping to e-commerce platforms and external data sources.

## Overview

Alana Shopping integrates with e-commerce platforms and data providers to sync product data bidirectionally. Integrations use OAuth for secure authorization and support automatic sync schedules.

## Connecting a platform

<Steps>
  <Step title="Authorize">
    Start the OAuth flow to connect your e-commerce account:

    ```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_..."}'
    ```

    This returns an authorization URL. Redirect the user to complete OAuth.
  </Step>

  <Step title="Callback">
    After authorization, the platform redirects to our callback URL with credentials that are stored securely.
  </Step>

  <Step title="Sync">
    Trigger an initial sync to pull products from the connected platform:

    ```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>

## Checking integration status

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

Returns the connection status, last sync time, and any errors for each configured integration.

## Sync monitoring

After triggering a sync, monitor its progress:

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

## MCP Integration

For advanced integrations, Alana Shopping supports the **Model Context Protocol (MCP)**:

* **Inbound** — receive product batches via `/api/mcp/inbound`
* **Feed subscriptions** — subscribe to product feeds via `/api/mcp/feed/{platform}`
* **Search** — query across integrated sources via `/api/mcp/search`