> 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-fr/creer-avec-lia/setup.md).

# Configuration

{% hint style="warning" %}
🚧 **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](/experience-cloud/experience-cloud-fr/aide/how-do-i-contact-support.md): vos retours déterminent directement ce que nous améliorerons ensuite.
{% endhint %}

Deux choses à connecter : le **Compétences Avonni** et le **serveur MCP Avonni**. Un ensemble d’exigences d’abord, puis choisissez votre client.

## Prérequis

Les skills écrivent des fichiers sur votre machine et interagissent avec votre organisation Salesforce, donc chaque client a besoin de la même base, y compris l’application de bureau Claude :

* [**Node.js**](https://nodejs.org/en/download) **18 ou version ultérieure.** Les skills exécutent des scripts locaux ; sans Node.js, ils ne peuvent pas s’exécuter du tout.
* [**Salesforce CLI**](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_install_cli.htm)**, authentifiée auprès de votre organisation.** Il alimente les étapes tenant compte de l’organisation (recherche de documentation sur les objets et les champs, requêtes sur les versions des composants, récupération et enregistrement du contenu du site) et c’est ainsi que vous déployez ce que l’assistant produit. Connectez votre organisation avec :

```bash
sf org login web
```

{% hint style="warning" %}
**Faites cela en premier.** Sans Node.js et une Salesforce CLI authentifiée, les skills et le serveur MCP n’ont rien à utiliser : l’assistant peut lire la documentation, mais il ne peut rien générer ni enregistrer d’exploitable dans votre organisation.
{% endhint %}

## Choisissez votre client

{% tabs %}
{% tab title="🖥️ Claude Code (application de bureau ou terminal)" %}
**1. Installez les skills**

Depuis le répertoire de votre projet (dans l’application de bureau, ouvrez d’abord le dossier de votre projet), exécutez :

```bash
npx skills add avonni/skills
```

Cela télécharge et installe automatiquement les cinq skills dans la configuration de votre projet.

**2. Connectez le serveur MCP**

Le serveur est hébergé : rien n’est à installer ni à exécuter localement. Exécutez :

```bash
claude mcp add --transport http avonni https://mcp.avonnicomponents.com
```

C’est toute la configuration.
{% endtab %}

{% tab title="⌨️ Cursor, VS Code, GitHub Copilot" %}
**1. Installez les skills**

Depuis le répertoire de votre projet, exécutez :

```bash
npx skills add avonni/skills
```

Cela télécharge et installe automatiquement les cinq skills dans la configuration de votre projet.

**2. Connectez le serveur MCP**

Ajoutez une entrée de configuration JSON, par exemple dans `.cursor/mcp.json` ou `.vscode/mcp.json`:

```json
{
    "mcpServers": {
        "avonni": {
            "url": "https://mcp.avonnicomponents.com"
        }
    }
}
```

Consultez la documentation de votre assistant pour connaître le nom et l’emplacement exacts du fichier. La structure de l’entrée reste la même partout : un nom et une URL.
{% endtab %}
{% endtabs %}

## Contenu du jeu de skills

Les cinq skills se trouvent dans le dépôt public [avonni/skills](https://github.com/avonni/skills) dépôt :

* `avonni-experience-components`, pour les composants Avonni sur les pages Experience Site
* `avonni-architect`, le coordinateur qui planifie et construit des cas d’utilisation complets
* `avonni-flow-components`, pour les composants d’écran Avonni Flow dans les flux d’écran
* `avonni-dynamic-components`, pour les composants dynamiques sur les pages Lightning
* `avonni-lwc-components`, pour les composants Avonni dans le code LWC

{% hint style="success" %}

#### **Conservez avonni-architect dans l’ensemble**

Décrivez un résultat métier ("une page de portail d’assistance avec une liste de cas et un flux pour créer un cas") et l’architecte planifie l’architecture, puis exécute les skills appropriés dans l’ordre des dépendances afin que chaque élément soit correctement relié aux autres. Il a besoin que les autres skills soient installés avec lui pour effectuer son travail.
{% endhint %}

## Vérifiez la configuration

Demandez à votre assistant : *"Liste les composants Experience Avonni disponibles."*

S’il répond avec une vraie liste de composants récupérée via le serveur MCP plutôt qu’avec une réponse générique issue de sa mémoire, la connexion fonctionne.

## Filtrer les toolsets (facultatif)

Par défaut, le serveur expose des outils pour les quatre packages Avonni (`lwc`, `packages dynamiques`, `flow`, `package experience`). Si vous créez uniquement des pages Experience Site, ajoutez un `?toolsets=` paramètre de requête à l’URL pour réduire au minimum la liste d’outils de l’assistant :

```
https://mcp.avonnicomponents.com?toolsets=experience
```

Ajoutez à nouveau des packages avec une liste séparée par des virgules, par exemple `?toolsets=experience,flow`.

{% hint style="info" %}
Si vous filtrez les toolsets, les composants des packages exclus deviennent invisibles pour l’assistant. Voir [Limitations et FAQ](/experience-cloud/experience-cloud-fr/creer-avec-lia/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-fr/creer-avec-lia/setup.md?ask=<question>&goal=<endgoal>
```

`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.