Wix Bookings Server

БесплатноНе проверен

Enables managing Wix Bookings courses and searching participants through the Wix Bookings API with tools to list services, list formations with participants, ge

автор: mateotiedra

GitHub Embed

Описание

Enables managing Wix Bookings courses and searching participants through the Wix Bookings API with tools to list services, list formations with participants, get formation participants, and search bookings by name, email, or phone.

README

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

Outils

Outil	Description
`list_courses`	Lister les cours/formations avec métadonnées (ID, nom, type, prix, capacité) et données d'inscription (lieu, nombre de participants). Utiliser pour découvrir les IDs nécessaires à `get_formation_participants`.
`get_formation_participants`	Obtenir la liste détaillée des participants d'un cours (noms, emails, statuts) avec `participantCount` dédupliqué et `rawCount` brut.
`search_bookings`	Rechercher des réservations par nom, email ou téléphone.

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 :

correspondance directe par serviceId ;
à défaut, correspondance par scheduleId du cours Wix ;
à 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

from github.com/mateotiedra/wix-formation-mcp

Установка Wix Bookings Server

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/mateotiedra/wix-formation-mcp

FAQ