Wix Bookings MCP Server

Serveur MCP (Model Context Protocol) exposant les outils de l'API Wix Bookings pour la gestion des cours et la recherche de participants.

Outils

Related MCP server: Moodle MCP Server

Règles de correspondance des formations

Les outils list_courses et get_formation_participants utilisent la même logique pour rattacher les réservations Wix à un cours :

1. correspondance directe par serviceId ;

2. à défaut, correspondance par scheduleId du cours Wix ;

3. à défaut uniquement pour les anciennes réservations orphelines, correspondance conservatrice par titre normalisé + dates de session.

Les dates seules ne sont jamais considérées comme une clé fiable, car plusieurs formations peuvent partager les mêmes dates. Si Wix ne fournit pas assez d'information pour distinguer deux cours, la réservation n'est pas rattachée plutôt que de risquer de renvoyer les participants d'une autre formation.

participantCount correspond au nombre de participants confirmés dédupliqués (contact, email, téléphone, puis nom). rawCount correspond au nombre brut de réservations confirmées avant déduplication.

Identifiants

Les identifiants Wix sont passés de deux façons selon le mode :

• Mode stdio : via les variables d'environnement WIX_API_TOKEN et WIX_SITE_ID.

• Mode HTTP : via les en-têtes HTTP X-Wix-Api-Token et X-Wix-Site-Id.

Modes de transport

Stdio (par défaut avec --stdio)

WIX_API_TOKEN=xxx WIX_SITE_ID=yyy npx -y github:mateotiedra/wix-formation-mcp --stdio

HTTP

docker run -p 3000:3000 wix-bookings-mcp

Le serveur écoute sur le port 3000 (configurable via PORT).

Exemple de configuration client MCP (HTTP) :

{
  "mcpServers": {
    "wix-bookings": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "X-Wix-Api-Token": "votre-token",
        "X-Wix-Site-Id": "votre-site-id"
      }
    }
  }
}

Développement

# Installer les dépendances
npm install

# Lancer en mode développement (HTTP)
npm run dev

# Compiler
npm run build

# Lancer les tests
npm test