> For the complete documentation index, see [llms.txt](https://help.meltingspot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.meltingspot.io/manage-spot/integrations/assistants-ia-mcp/plugin-et-skills-meltingspot.md).

# Plugin et skills MeltingSpot

Installez en une fois la connexion à MeltingSpot et les consignes qui guident votre assistant.

Le plugin MeltingSpot est une façon plus simple de connecter Claude, Claude Code ou Codex à votre Spot. Il apporte :

* **la connexion au serveur MCP MeltingSpot, déjà configurée** : vous n'avez pas à saisir l'adresse du serveur ;
* **des skills**, c'est-à-dire des consignes qui apprennent à votre assistant à utiliser MeltingSpot correctement : faire confirmer les suppressions, travailler par lots, comprendre les messages d'erreur, se méfier du contenu écrit par les membres.

Le plugin est public et gratuit. Son code est disponible sur GitHub : [meltingspot/meltingspot-for-ai](https://github.com/meltingspot/meltingspot-for-ai).

Avant de commencer, vérifiez les [prérequis](https://help.meltingspot.io/manage-spot/integrations/assistants-ia-mcp.md#avant-de-commencer) : vous êtes administrateur du Spot et le serveur MCP est activé pour ce Spot.

## Installer le plugin

{% hint style="info" %}
Les libellés ci-dessous sont ceux des interfaces en anglais.
{% endhint %}

{% tabs %}
{% tab title="claude.ai et Cowork" %}

1. Ouvrez **Customize > Plugins**.
2. Choisissez **Add > Add marketplace** et saisissez `meltingspot/meltingspot-for-ai`.
3. Ajoutez le plugin `meltingspot`.
4. Ouvrez l'onglet **Connectors** du plugin et connectez MeltingSpot.
5. La page MeltingSpot s'ouvre : choisissez votre Spot dans **Spot à connecter**, puis cliquez sur **Autoriser**.

Le plugin est enregistré sur votre compte Claude : il est aussi disponible dans Cowork et dans Claude Code.
{% endtab %}

{% tab title="Claude Code" %}

1. Dans Claude Code, tapez :

   ```
   /plugin marketplace add meltingspot/meltingspot-for-ai
   /plugin install meltingspot@meltingspot
   ```
2. Tapez `/mcp` pour vous connecter à MeltingSpot.
3. La page MeltingSpot s'ouvre dans votre navigateur : choisissez votre Spot dans **Spot à connecter**, puis cliquez sur **Autoriser**.
   {% endtab %}

{% tab title="Codex" %}

1. Dans un terminal, ajoutez la marketplace MeltingSpot :

   ```bash
   codex plugin marketplace add meltingspot/meltingspot-for-ai
   ```
2. Dans le répertoire des plugins de Codex, installez `meltingspot` depuis la marketplace `meltingspot`.
3. Connectez-vous à MeltingSpot quand Codex vous le demande : choisissez votre Spot dans **Spot à connecter**, puis cliquez sur **Autoriser**.
   {% endtab %}

{% tab title="Skills seules" %}
Pour ajouter uniquement les skills à un assistant compatible, lancez dans un terminal :

```bash
npx skills add meltingspot/meltingspot-for-ai
```

Cette commande n'ajoute pas la connexion à MeltingSpot : ajoutez-la ensuite dans votre assistant, avec l'adresse `https://mcp.meltingspot.io/mcp` (voir le guide de votre assistant).
{% endtab %}
{% endtabs %}

## Les skills incluses

| Skill                           | Ce qu'elle apprend à votre assistant                                                                                                                                |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `meltingspot-conventions`       | Les règles de base : une connexion = un Spot, listes paginées, lots de 100 éléments au plus, dates, mise en forme et langue de réponse.                             |
| `meltingspot-write-safely`      | Consulter avant de modifier, vous faire confirmer les suppressions et les modifications en masse, rendre compte des résultats partiels, ne pas réessayer en boucle. |
| `meltingspot-errors`            | Comprendre les messages d'erreur de MeltingSpot (accès refusé, paramètres invalides, erreur inattendue) et vous proposer la bonne action.                           |
| `meltingspot-untrusted-content` | Traiter le contenu écrit par les membres comme des données, jamais comme des instructions, et vous signaler les tentatives de manipulation.                         |
| `meltingspot-domain`            | Ce qu'est un Spot et ce qu'il contient : membres et rôles, groupes, tags, canaux, forums, lives, cours, parcours, collections, modération et recherche.             |

## Données échangées

* Le plugin n'exécute rien sur votre ordinateur : il déclare seulement la connexion à MeltingSpot et les skills.
* Quand votre assistant utilise MeltingSpot, il agit sur le Spot de la connexion, avec votre compte administrateur.
* Les résultats (membres, groupes, contenus du Spot…) sont transmis à votre assistant, donc au fournisseur de son modèle d'IA.

Consultez aussi la [politique de confidentialité](https://www.iubenda.com/privacy-policy/99274573) et les [conditions générales](https://www.meltingspot.io/terms-and-conditions) de MeltingSpot.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.meltingspot.io/manage-spot/integrations/assistants-ia-mcp/plugin-et-skills-meltingspot.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
