Limitations et FAQ

Ce que le serveur Avonni MCP et les compétences ne couvrent pas, ainsi que les corrections pour les problèmes de configuration courants.

🚧 Accès anticipé. Build with AI est déployé progressivement et s'améliore à chaque version. Quelque chose n'est pas clair, manque ou ne fonctionne pas ? Dites-le-nous: vos retours déterminent directement ce que nous améliorerons ensuite.

Limitations

Ces outils sont ciblés et volontairement limités. Savoir où ils s'arrêtent vous évite d'attendre d'eux des choses pour lesquelles ils n'ont jamais été conçus.

• Uniquement les composants Avonni, pas le site lui-même. Les compétences ajoutent et configurent des composants Avonni sur des pages de site existantes. Elles ne créent pas le site, ses pages, routes, thèmes ni sa navigation : créez d'abord cela dans Experience Builder, puis ramenez les éléments Avonni dans ces compétences.
• Rien n'est déployé. Chaque compétence écrit ou modifie des fichiers en local et s'arrête là. Elle n'envoie jamais rien vers une organisation. Le déploiement de la modification et la publication du site relèvent de votre responsabilité, à l'aide de Salesforce CLI ou de votre processus de déploiement habituel.
• Le serveur MCP est une dépendance incontournable. Les compétences refusent de s'exécuter sans lui plutôt que de deviner. Il n'existe pas de mode hors ligne : si le serveur est inaccessible, la compétence s'arrête et vous demande de le connecter.
• Le serveur MCP documente la dernière version, qui peut être en avance sur le paquet que vous avez installé. Le service de documentation se met à jour automatiquement à chaque version du package Avonni. Si votre organisation utilise une version de package plus ancienne, l'assistant peut utiliser avec assurance un composant ou une propriété que vous n'avez pas encore. Gardez vos packages Avonni installés à jour pour rester synchronisé.
• Node.js et un Salesforce CLI authentifié constituent la base de fonctionnement, dans tous les clients. Les compétences exécutent des scripts locaux qui nécessitent Node.js 18+, et Salesforce CLI les connecte à votre organisation pour les recherches dans la documentation, les requêtes sur les versions de composants, ainsi que la récupération et l'enregistrement du contenu du site. Sans cette base, l'assistant peut lire la documentation mais ne peut rien produire d'utilisable, y compris dans l'application de bureau Claude.
• L'architecte coordonne trois compétences d'artefact, pas les quatre. avonni-architect orchestre les compétences Experience, Flow et Dynamic Component. avonni-lwc-components est un flux de travail de modification directe que vous invoquez seul.

Dépannage

Problème	Cause	Correction
La compétence ne s'active pas	Les compétences ne sont pas installées dans l'assistant ou le projet que vous avez ouvert. La npx skills add avonni/skills commande s'installe uniquement dans le projet actuel.	Relancez la commande d'installation depuis le projet ouvert, copiez les dossiers de compétences dans le répertoire des compétences de votre assistant (.claude/skills/ pour Claude Code), ou ajoutez-les à nouveau depuis les paramètres Skills de votre assistant.
La compétence ne s'active pas	L'invite est trop vague pour déclencher la bonne compétence.	Nommez explicitement ce que vous construisez (« composant Avonni », « page de site Experience »), ou invoquez la compétence par son nom. Dans Claude, tapez /avonni-experience-components.
L'assistant devine les attributs au lieu de les rechercher	Le serveur MCP n'est pas connecté.	Vérifiez l'état MCP de votre assistant (dans Claude Code, exécutez claude mcp list) et vérifiez l'URL du serveur. Puis testez avec "Liste les composants Experience Avonni disponibles."
La compétence s'exécute mais ne peut pas enregistrer ni rechercher des données d'organisation	Node.js est manquant, ou Salesforce CLI n'est pas installé ou n'est pas authentifié auprès de votre organisation.	Installez Node.js 18+, installez Salesforce CLI, puis exécutez sf org login web et réessayez.
La connexion MCP échoue	URL incorrecte, transport incorrect, ou le serveur a été ajouté à un autre projet. La claude mcp add commande l'enregistre uniquement pour le projet actuel.	Confirmez que l'URL est https://mcp.avonnicomponents.com via le transport HTTP. Relancez la commande depuis le bon projet, ou ajoutez-la à une portée plus large (dans Claude Code, claude mcp add --scope user …).
L'assistant ne trouve pas un composant dont je sais qu'il existe	Un ?toolsets= filtre exclut le package du composant. Avec ?toolsets=experience, les composants flow, dynamic et LWC sont invisibles.	Supprimez le filtre ou ajoutez le package manquant à la liste.
Une demande multi-artefact n'a généré qu'une seule partie	La avonni-architect la compétence n'est pas installée, donc une compétence à artefact unique n'a traité que sa propre partie.	Assurez-vous que avonni-architect est installée en même temps que les autres compétences.