← Documentation

Serveur MCP

Pour piloter LIKYLY directement depuis Claude Code, Claude Desktop, Cursor ou tout client compatible MCP - sans écrire de code d’intégration, avec un prompt.

Le plus simple : laissez l’assistant d’installation le configurer
npx @likyly/wizard mcp add

Écrit la configuration pour Claude Code, Cursor ou VS Code, sans jamais y mettre de clé. Détails

Ce que vous pouvez demander à votre assistant

Pas de commande à retenir : écrivez votre demande en langage courant dans Claude Code, Cursor ou VS Code. L’assistant enchaîne les outils ci-dessous et termine par un récapitulatif : ce qui marche, ce qui a changé dans votre code, où vérifier, et la prochaine action.

« Installe LIKYLY : relie mon catalogue et ajoute des recommandations sur mes fiches produits »Tout le parcours : catalogue, emplacement, code, suivi, vérification
« Mon catalogue a changé, resynchronise-le »Synchronise la source, ou renvoie les produits si le site est en local
« Vérifie mon intégration LIKYLY »Lance la vérification et donne la liste ✓ / ⚠ / ✗
« Mes recommandations ne se mettent pas à jour, vide le cache LIKYLY »Vide le cache des recommandations anonymes
« Affiche 6 produits au lieu de 4 et exclus les ruptures de stock »Modifie l’emplacement

Pour être précis, trois commandes dans Claude Code, installées par le wizard : /likyly (la skill, pour lancer l’intégration) et /likyly-clear-cache [emplacement] (vide le cache, sans passer par l’IA ; dans un terminal : npx @likyly/wizard cache clear), et /likyly-uninstall (retire Likyly du projet après confirmation ; dans un terminal : npx @likyly/wizard uninstall).

Installation manuelle

npm install -g @likyly/mcp-server

Configuration

Avec ta clé publique (sur ton compte), l’assistant obtient des recommandations et transmet des événements. Pour qu’il gère aussi ton catalogue et tes emplacements, donne-lui une clé MCP aux droits limités (sources, emplacements), et seulement dans un environnement de confiance : ton poste, ta CI. Jamais la clé secrète dans un contexte partagé.

Avec le wizard, rien à faire : à la connexion à votre compte, il récupère une clé MCP et la range dans .likyly/credentials.env, un dossier qui s’exclut lui-même de git. Les fichiers de configuration (.mcp.json, .cursor/mcp.json, .vscode/mcp.json) ne contiennent jamais la clé : le serveur la lit dans LIKYLY_DEVELOPER_KEY si elle est exportée, sinon dans ce fichier.

{
  "mcpServers": {
    "likyly": {
      "command": "likyly-mcp-server",
      "env": {
        "LIKYLY_API_KEY": "votre-clé-publique-restreinte",
        "LIKYLY_BASE_URL": "https://api.likyly.com",
        "LIKYLY_PRODUCT_TYPE": "votre-catalogue"
      }
    }
  }
}

Service MCP hébergéÀ venir

Le même jeu d’outils, exposé par URL en MCP « Streamable HTTP » : ton assistant IA s’y connecte directement, sans rien installer. Chaque requête porte ta clé publique restreinte ; le service ne stocke aucun secret et ne peut pas faire plus que la clé elle-même. Le service est prêt côté code et en cours de déploiement.

POST https://mcp.likyly.com/mcp
Authorization: Bearer <ta-clé-publique-restreinte>
X-Likyly-Product-Type: <ton-catalogue>   # optionnel

Outils disponibles

34 outils. Vous ne les appelez pas vous-même : votre assistant choisit l’outil d’après ce que vous lui demandez. Le catalogue arrive par une source de données synchronisée ; quand LIKYLY ne peut pas l’atteindre (site en local), l’assistant envoie les produits lui-même avec push_items.

Recommandations et événements

Clé publique
get_recommendationsRecommandations : LIKYLY choisit la stratégie
get_popular_recommendationsTendances, sans historique
get_cold_start_recommendationsSimilaires à un contenu, sans compte
get_collaborative_recommendationsFiltrage collaboratif pour un utilisateur
get_hybrid_recommendationsContenu + comportement, poids alpha réglable
get_session_recommendationsÀ partir des derniers contenus vus
get_user_session_recommendationsÀ partir des vues enregistrées d’un utilisateur
track_eventEnregistre un événement (vue, clic, panier, achat, type personnalisé…)

Catalogue : sources de données

Clé MCP (sources:read / sources:write) ou clé secrète
list_source_typesTypes de sources disponibles (CSV, JSON, API REST, Shopify, WooCommerce, webhook)
create_data_sourceCrée une source de catalogue · écriture
update_data_sourceModifie une source existante (nouvelle URL, autre catalogue) · écriture
delete_data_sourceSupprime une source ; les produits déjà importés restent · écriture
push_itemsEnvoie des produits à une source « webhook » : catalogue en local ou hors d’atteinte de LIKYLY · écriture
rotate_push_secretRenouvelle le secret d’envoi d’une source « webhook » · écriture
test_data_sourceTeste la connexion à la source
preview_data_sourceAperçu des éléments lus
configure_field_mappingCorrespondance des champs (essai à blanc possible) · écriture
sync_data_sourceSynchronise la source : importe les éléments dans le catalogue · écriture
get_sync_statusHistorique des synchronisations
list_data_sourcesSources configurées
get_catalog_statsStatistiques du catalogue importé

Emplacements et vérification de l’intégration

Clé MCP (placements:read / placements:write) ou clé secrète
create_placementCrée un emplacement de recommandations · écriture
update_placementModifie stratégie, filtres et règles · écriture
delete_or_disable_placementDésactive ou supprime un emplacement · écriture
list_placementsEmplacements configurés
get_placementDétail d’un emplacement
get_placement_requirementsSignaux nécessaires à un emplacement
preview_placementAperçu des recommandations d’un emplacement
get_integration_recipeMarche à suivre pour intégrer l’emplacement dans votre code
get_tracking_requirementsÉvénements à transmettre
get_placement_healthSanté de l’intégration (données brutes)
get_recent_integration_eventsDerniers événements reçus
validate_integrationVérifie l’intégration : ✓ / ⚠ / ✗ avec les étapes suivantes
purge_recommendation_cacheVide le cache des recommandations anonymes (un emplacement ou tous) · écriture