> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/mit-ki-erstellen/setup.md). # Einrichtung {% hint style="warning" %} 🚧 **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](/experience-cloud/experience-cloud-de/hilfe/how-do-i-contact-support.md): Dein Feedback beeinflusst direkt, was wir als Nächstes verbessern. {% endhint %} Zwei Dinge zu verbinden: die **Avonni Skills** und den **Avonni MCP-Server**. Zuerst ein Satz an Voraussetzungen, dann wählen Sie Ihren Client. ## Voraussetzungen Die Skills schreiben Dateien auf Ihrem Rechner und arbeiten mit Ihrer Salesforce-Organisation, daher benötigt jeder Client dieselbe Grundlage, einschließlich der Claude-Desktop-App: * [**Node.js**](https://nodejs.org/en/download) **18 oder neuer.** Die Skills führen lokale Skripte aus; ohne Node.js können sie überhaupt nicht ausgeführt werden. * [**Salesforce CLI**](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_install_cli.htm)**, bei Ihrer Org authentifiziert.** Es ermöglicht die org-bewussten Schritte (Nachschlagen von Objekt- und Felddokumentation, Abfragen von Komponenten-Versionen, Abrufen und Speichern von Site-Inhalten) und darüber deployen Sie, was der Assistent erzeugt. Verbinden Sie Ihre Org mit: ```bash sf org login web ``` {% hint style="warning" %} **Machen Sie das zuerst.** Ohne Node.js und eine authentifizierte Salesforce CLI haben die Skills und der MCP-Server nichts, womit sie arbeiten können: Der Assistent kann Dokumentation lesen, aber er kann nichts Nützliches in Ihrer Org erzeugen oder speichern. {% endhint %} ## Wählen Sie Ihren Client {% tabs %} {% tab title="🖥️ Claude Code (Desktop-App oder Terminal)" %} **1. Installieren Sie die Skills** Wechseln Sie aus Ihrem Projektverzeichnis heraus (in der Desktop-App öffnen Sie zuerst Ihren Projektordner) und führen Sie aus: ```bash npx skills add avonni/skills ``` Dadurch werden alle fünf Skills automatisch heruntergeladen und in der Konfiguration Ihres Projekts installiert. **2. Verbinden Sie den MCP-Server** Der Server wird gehostet: Es gibt nichts lokal zu installieren oder auszuführen. Führen Sie aus: ```bash claude mcp add --transport http avonni https://mcp.avonnicomponents.com ``` Das ist die gesamte Einrichtung. {% endtab %} {% tab title="⌨️ Cursor, VS Code, GitHub Copilot" %} **1. Installieren Sie die Skills** Führen Sie aus Ihrem Projektverzeichnis Folgendes aus: ```bash npx skills add avonni/skills ``` Dadurch werden alle fünf Skills automatisch heruntergeladen und in der Konfiguration Ihres Projekts installiert. **2. Verbinden Sie den MCP-Server** Fügen Sie einen JSON-Konfigurationseintrag hinzu, zum Beispiel in `.cursor/mcp.json` oder `.vscode/mcp.json`: ```json { "mcpServers": { "avonni": { "url": "https://mcp.avonnicomponents.com" } } } ``` Prüfen Sie die Dokumentation Ihres Assistenten für den genauen Dateinamen und Speicherort. Die Form des Eintrags bleibt überall gleich: ein Name und eine URL. {% endtab %} {% endtabs %} ## Was im Skill-Set enthalten ist Alle fünf Skills befinden sich im öffentlichen [avonni/skills](https://github.com/avonni/skills) Repository: * `avonni-experience-components`, für Avonni-Komponenten auf Experience-Site-Seiten * `avonni-architect`, der Koordinator, der komplette Anwendungsfälle plant und erstellt * `avonni-flow-components`, für Avonni Flow Screen Components in Bildschirmflüssen * `avonni-dynamic-components`, für Dynamic Components auf Lightning-Seiten * `avonni-lwc-components`, für Avonni-Komponenten in LWC-Code {% hint style="success" %} #### **Behalten Sie avonni-architect im Set** Beschreiben Sie ein Geschäftsergebnis ("eine Support-Portal-Seite mit einer Fallliste und einem Flow zum Erstellen eines Falls") und der Architect plant die Architektur und führt dann die richtigen Skills in Abhängigkeitsreihenfolge aus, damit jedes Teil korrekt mit den anderen verbunden wird. Er benötigt die anderen Skills, die zusammen mit ihm installiert sind, um seine Arbeit zu erledigen. {% endhint %} ## Überprüfen Sie die Einrichtung Fragen Sie Ihren Assistenten: *"Listen Sie die verfügbaren Avonni Experience-Komponenten auf."* Wenn er mit einer echten Komponentenliste antwortet, die über den MCP-Server abgerufen wurde, statt mit einer allgemeinen Antwort aus dem Gedächtnis, funktioniert die Verbindung. ## Toolsets filtern (optional) Standardmäßig stellt der Server Tools für alle vier Avonni-Pakete bereit (`LWC`, `dynamischen`, `Flow`, `Experience`). Wenn Sie nur Experience-Site-Seiten erstellen, hängen Sie einen `?toolsets=` Abfrageparameter an die URL an, damit die Tool-Liste des Assistenten minimal bleibt: ``` https://mcp.avonnicomponents.com?toolsets=experience ``` Fügen Sie Pakete mit einer durch Kommas getrennten Liste wieder hinzu, zum Beispiel `?toolsets=experience,flow`. {% hint style="info" %} Wenn Sie die Toolsets filtern, werden Komponenten aus den ausgeschlossenen Paketen für den Assistenten unsichtbar. Siehe [Einschränkungen & FAQ](/experience-cloud/experience-cloud-de/mit-ki-erstellen/limitations-and-faq.md). {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/mit-ki-erstellen/setup.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.