Serveur MCP

Lodwave dans Claude Desktop, Cursor & co.

Branche les outils Lodwave (scoring produit, générateur de pubs, calcul de marge, détection de tendances) dans n'importe quel client compatible MCP.

C'est quoi ?

Le package @xlab-ecom/mcp est un petit serveur stdio qui permet aux clients MCP (Claude Desktop, Cursor, Continue, Claude Code) d'appeler notre API REST avec une vraie sémantique d'outils. Ta clé reste sur ta machine — on ne voit pas la conversation.

Installer le serveur

Installe-le globalement pour que les clients MCP puissent spawn le binaire `xlab-mcp`.

npm install -g @xlab-ecom/mcp

Obtenir une clé API

  1. Ouvre le dashboard des clés API.
  2. Clique sur "Créer la clé" et donne-lui un nom (ex. "Mon Mac").
  3. Copie la valeur xlab_pk_live_… — elle n'est affichée qu'une fois.
Ouvrir le dashboard

Claude Desktop

Ouvre le fichier de config (chemin macOS ci-dessous ; sous Windows c'est %APPDATA%\Claude\claude_desktop_config.json) et ajoute une entrée sous mcpServers :

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "xlab-ecom": {
      "command": "xlab-mcp",
      "env": {
        "XLAB_API_KEY": "xlab_pk_live_..."
      }
    }
  }
}

Redémarre Claude Desktop après modification. Les outils apparaissent dans le menu slash.

Cursor

Même forme de config, autre fichier :

~/.cursor/mcp.json

{
  "mcpServers": {
    "xlab-ecom": {
      "command": "xlab-mcp",
      "env": {
        "XLAB_API_KEY": "xlab_pk_live_..."
      }
    }
  }
}

Claude Code

Ajoute le serveur depuis le CLI :

claude mcp add xlab-ecom \
  --command xlab-mcp \
  --env XLAB_API_KEY=xlab_pk_live_...

Continue.dev

Ouvre ~/.continue/config.json et fusionne l'extrait :

{
  "models": [],
  "mcpServers": {
    "xlab-ecom": {
      "command": "xlab-mcp",
      "env": {
        "XLAB_API_KEY": "xlab_pk_live_..."
      }
    }
  }
}

Outils exposés

Huit outils sont enregistrés dès que le serveur démarre.

  • xlab_chat

    Send a message to the Lodwave agent and stream back a reply.

  • xlab_score_product

    Score a product on 10 weighted criteria (margin, wow factor, etc.).

  • xlab_generate_ad_copy

    Meta + TikTok ad variants with hooks, headlines, CTAs.

  • xlab_calculate_profit

    Unit + monthly profit + break-even and target ROAS.

  • xlab_generate_email_sequence

    Welcome / abandon-cart / post-purchase / win-back templates.

  • xlab_detect_trends

    Trending brands + ads in a niche via BrandSearch.

  • xlab_list_brands

    List the caller's brand workspaces.

  • xlab_usage

    Current API usage and plan limits.

Résolution de problèmes

Les outils n'apparaissent pas dans Claude Desktop
Redémarre l'app après modification de la config. Lance `xlab-mcp` en terminal — il devrait attendre sur stdio. S'il crashe, l'erreur affichée est le coupable.
Chaque appel renvoie 401 invalid_api_key
Ta clé a peut-être été révoquée ou la variable d'env n'a pas été propagée. Vérifie XLAB_API_KEY dans la config du client et recrée une clé si besoin.
Les appels renvoient 402 plan_required
Ton compte est sur un plan sans accès API (Free ou Pro Trial). Passe au Founding 50, Pro, Agency ou Enterprise pour activer l'API.

Support

Bugs, demandes de features ou cas tordus côté MCP — hello@xlab-ecom.com.