Einschränkungen & FAQ

Was der Avonni-MCP-Server und die Skills nicht abdecken, sowie Lösungen für häufige Einrichtungsprobleme.

🚧 Frühzugang. Build with AI wird schrittweise eingeführt und mit jedem Release verbessert. Etwas unklar, fehlt etwas oder ist etwas kaputt? Sag es uns: Dein Feedback beeinflusst direkt, was wir als Nächstes verbessern.

Einschränkungen

Diese Tools sind fokussiert und bewusst eng begrenzt. Zu wissen, wo sie aufhören, bewahrt Sie davor, Dinge zu erwarten, für die sie nie gebaut wurden.

• Nur Avonni-Komponenten, nicht die Website selbst. Die Skills fügen Avonni-Komponenten zu bestehenden Seiten der Site hinzu und konfigurieren sie. Sie erstellen weder die Site noch ihre Seiten, Routen, Themes oder Navigation: Erstellen Sie diese zuerst in Experience Builder und bringen Sie dann die Avonni-Bausteine zurück zu diesen Skills.
• Nichts wird bereitgestellt. Jeder Skill schreibt oder bearbeitet Dateien lokal und hört dort auf. Er überträgt nie in eine Org. Die Bereitstellung der Änderung und das Veröffentlichen der Site liegen in Ihrer Verantwortung, mithilfe der Salesforce CLI oder Ihres üblichen Bereitstellungsprozesses.
• Der MCP-Server ist eine zwingende Voraussetzung. Die Skills verweigern den Betrieb ohne ihn, statt zu raten. Es gibt keinen Offline-Modus: Wenn der Server nicht erreichbar ist, stoppt der Skill und fordert Sie auf, ihn zu verbinden.
• Der MCP-Server dokumentiert die neueste Version, die Ihrer installierten Paketversion voraus sein kann. Der Dokumentationsdienst aktualisiert sich automatisch mit jeder Avonni-Paketveröffentlichung. Wenn Ihre Org eine ältere Paketversion verwendet, kann der Assistent möglicherweise selbstbewusst eine Komponente oder Eigenschaft nutzen, die Sie noch nicht haben. Halten Sie Ihre installierten Avonni-Pakete auf dem neuesten Stand, um synchron zu bleiben.
• Node.js und eine authentifizierte Salesforce CLI sind in jedem Client die Arbeitsgrundlage. Die Skills führen lokale Skripte aus, die Node.js 18+ erfordern, und die Salesforce CLI verbindet sie mit Ihrer Org für Dokumentationsabfragen, Abfragen von Komponentenversionen sowie das Abrufen und Speichern von Site-Inhalten. Ohne diese Grundlage kann der Assistent Dokumentation lesen, aber nichts Brauchbares erzeugen, auch nicht in der Claude-Desktop-App.
• Der Architect koordiniert drei Artefakt-Skills, nicht alle vier. avonni-architect koordiniert die Skills Experience, Flow und Dynamic Component. avonni-lwc-components ist ein Direktbearbeitungs-Workflow, den Sie eigenständig aufrufen.

Fehlerbehebung

Problem	Ursache	Lösung
Der Skill wird nicht aktiviert	Die Skills sind nicht im Assistenten oder Projekt installiert, das Sie geöffnet haben. Der npx skills add avonni/skills Befehl installiert nur in das aktuelle Projekt.	Führen Sie den Installationsbefehl erneut aus dem geöffneten Projekt aus, kopieren Sie die Skill-Ordner in das Skills-Verzeichnis Ihres Assistenten (.claude/skills/ für Claude Code), oder fügen Sie sie erneut über die Skills-Einstellungen Ihres Assistenten hinzu.
Der Skill wird nicht aktiviert	Die Eingabeaufforderung ist zu vage, um den richtigen Skill auszulösen.	Benennen Sie ausdrücklich, was Sie erstellen ("Avonni-Komponente", "Experience-Site-Seite"), oder rufen Sie den Skill beim Namen auf. In Claude geben Sie /avonni-experience-components.
Der Assistent rät Attribute, statt sie nachzuschlagen	Der MCP-Server ist nicht verbunden.	Prüfen Sie den MCP-Status Ihres Assistenten (in Claude Code führen Sie claude mcp list) und überprüfen Sie die Server-URL. Dann testen Sie mit "Listen Sie die verfügbaren Avonni Experience-Komponenten auf."
Der Skill läuft, kann aber keine Org-Daten speichern oder nachschlagen	Node.js fehlt, oder die Salesforce CLI ist nicht installiert oder nicht bei Ihrer Org authentifiziert.	Installieren Sie Node.js 18+, installieren Sie die Salesforce CLI, und führen Sie dann sf org login web aus und versuchen Sie es erneut.
Die MCP-Verbindung schlägt fehl	Falsche URL, falsches Transportprotokoll oder der Server wurde einem anderen Projekt hinzugefügt. Der claude mcp add Befehl registriert ihn nur für das aktuelle Projekt.	Bestätigen Sie, dass die URL https://mcp.avonnicomponents.com über das HTTP-Transportprotokoll lautet. Führen Sie den Befehl im richtigen Projekt erneut aus, oder fügen Sie ihn mit einem größeren Geltungsbereich hinzu (in Claude Code, claude mcp add --scope user …).
Der Assistent kann eine Komponente, von der ich weiß, dass sie existiert, nicht finden	Ein ?toolsets= Filter schließt das Paket der Komponente aus. Mit ?toolsets=experiencesind Flow-, Dynamic- und LWC-Komponenten unsichtbar.	Entfernen Sie den Filter oder fügen Sie das fehlende Paket der Liste hinzu.
Eine Multi-Artefakt-Anfrage hat nur einen Teil erstellt	Die avonni-architect Der Skill ist nicht installiert, daher hat ein Einzelartefakt-Skill nur seinen eigenen Teil bearbeitet.	Stellen Sie sicher, avonni-architect ist zusammen mit den anderen Skills installiert.