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.
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-serverConfiguration
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> # optionnelOutils 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_recommendations | Recommandations : LIKYLY choisit la stratégie |
| get_popular_recommendations | Tendances, sans historique |
| get_cold_start_recommendations | Similaires à un contenu, sans compte |
| get_collaborative_recommendations | Filtrage collaboratif pour un utilisateur |
| get_hybrid_recommendations | Contenu + 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_event | Enregistre 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_types | Types de sources disponibles (CSV, JSON, API REST, Shopify, WooCommerce, webhook) |
| create_data_source | Crée une source de catalogue · écriture |
| update_data_source | Modifie une source existante (nouvelle URL, autre catalogue) · écriture |
| delete_data_source | Supprime une source ; les produits déjà importés restent · écriture |
| push_items | Envoie des produits à une source « webhook » : catalogue en local ou hors d’atteinte de LIKYLY · écriture |
| rotate_push_secret | Renouvelle le secret d’envoi d’une source « webhook » · écriture |
| test_data_source | Teste la connexion à la source |
| preview_data_source | Aperçu des éléments lus |
| configure_field_mapping | Correspondance des champs (essai à blanc possible) · écriture |
| sync_data_source | Synchronise la source : importe les éléments dans le catalogue · écriture |
| get_sync_status | Historique des synchronisations |
| list_data_sources | Sources configurées |
| get_catalog_stats | Statistiques du catalogue importé |
Emplacements et vérification de l’intégration
Clé MCP (placements:read / placements:write) ou clé secrète| create_placement | Crée un emplacement de recommandations · écriture |
| update_placement | Modifie stratégie, filtres et règles · écriture |
| delete_or_disable_placement | Désactive ou supprime un emplacement · écriture |
| list_placements | Emplacements configurés |
| get_placement | Détail d’un emplacement |
| get_placement_requirements | Signaux nécessaires à un emplacement |
| preview_placement | Aperçu des recommandations d’un emplacement |
| get_integration_recipe | Marche à suivre pour intégrer l’emplacement dans votre code |
| get_tracking_requirements | Événements à transmettre |
| get_placement_health | Santé de l’intégration (données brutes) |
| get_recent_integration_events | Derniers événements reçus |
| validate_integration | Vérifie l’intégration : ✓ / ⚠ / ✗ avec les étapes suivantes |
| purge_recommendation_cache | Vide le cache des recommandations anonymes (un emplacement ou tous) · écriture |