# Plug-in Fabric Skills Le plug-in Equinix Fabric Skills installe les compétences Fabric et le serveur MCP Fabric en une seule étape. Ajoutez la marketplace à votre client, installez le plug-in et connectez-vous. Vous pouvez ensuite demander au client de rechercher votre inventaire Fabric, de créer et de mettre à jour des connexions, de gérer des réseaux Fabric ou de configurer un Fabric Cloud Router. Une compétence est un fichier d'instructions qui indique au client comment effectuer correctement une tâche. Les compétences Fabric définissent les filtres qui s'appliquent à une recherche d'inventaire, qui détaillent les besoins d'une demande de connexion avant que le client ne la crée, les valeurs acceptées par un package Fabric Cloud Router et l'ordre d'exécution des étapes. Sans eux, un client dispose des outils, mais pas de la procédure. Le plug-in contient également la définition du serveur Fabric MCP, de sorte que vous ne devez pas configurer le serveur séparément. Le plugin est publié dans le dépôt[Equinix-agent-plugins](https://github.com/equinix/equinix-agent-plugins) sur github. Ce référentiel est une place de marché de plug-ins. Vous ajoutez la marketplace une fois, puis installez les plugins que vous souhaitez y utiliser. > **Aperçu public** > > Le serveur Fabric MCP est en mode d’aperçu public. Les outils, les descriptions et les formats de réponse peuvent changer avant la disponibilité générale. > > Pour obtenir des commentaires, des questions ou de l'aide sur le plug-in, envoyez un e-mail [à fabric-intelligence-support@equinix.com](mailto:fabric-intelligence-support@equinix.com). ## Contenu du plug-in[​](#contenu-du-plug-in "Lien direct vers Contenu du plug-in") Le Marketplace publie un plug-in, `equinix-fabric`, qui contient quatre compétences. | Compétences | Ce que vous pouvez demander au client de faire | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `show-fabric-inventory` | Rechercher et répertorier les connexions, les ports, les routeurs Fabric Cloud, les jetons de service, les filtres de routage, agrégations de routes et services Equinix Precision Time. Filtrer par zone métropolitaine, projet, état, bande passante, type, ou le nom. | | `manage-fabric-connection` | Créer, mettre à jour et réessayer des connexions Fabric, y compris EVPL, EPL, IP, accès Internet, et des connexions virtuelles EVP-LAN ou EP-LAN. Avant de la créer, validez une connexion et mettez à jour son nom, sa bande passante ou ses adresses e-mail de notification. | | `manage-fabric-network` | Planifier, créer, rechercher, comparer et mettre à jour les réseaux Fabric de type EVP-LAN, EVP-Tree, EP-LAN et EP-Tree, y compris les vérifications de compatibilité des ports. | | `manage-cloud-router` | Créer et mettre à jour des routeurs Fabric Cloud. Configurer BGP pour IPv4 et IPv6. Créez, associez et mettez à jour des filtres de route, des règles de filtre de route, des agrégations de route et des règles d'agrégation de route. | Le plug-in regroupe le serveur Fabric MCP à `https://mcp.equinix.com/fabric` et l'enregistre dans votre client sous le nom `equinix-fabric`. Pour connaître les outils exposés par le serveur et le niveau d'accès dont chacun a besoin, reportez-vous à la section [outils Fabric](https://docs.equinix.com/fr/equinix-api/mcp-servers/fabric-mcp-server.md) . ## Conditions préalables[​](#conditions-préalables "Lien direct vers Conditions préalables") * Un compte Equinix Customer Portal avec accès aux ressources Fabric que vous souhaitez que le client utilise. Le client agit en tant qu'utilisateur qui se connecte et hérite des autorisations de cet utilisateur. * Client qui lit les marketplaces de plug-ins. Claude Code et Claude Desktop le font. Pour tous les autres clients, reportez-vous à la section [installer dans d'autres clients](#install-in-other-clients). * Accès réseau à `https://mcp.equinix.com` et `https://github.com`. Vous n'avez pas besoin de jeton d'accès. Votre client effectue une connexion au navigateur la première fois qu'il appelle le serveur. Pour plus d'informations, consultez [authentification](https://docs.equinix.com/fr/equinix-api/mcp-servers/overview.md#authentication). ## Installer dans Claude Code[​](#installer-dans-claude-code "Lien direct vers Installer dans Claude Code") 1. Ajouter le Marketplace. ``` claude plugin marketplace add equinix/equinix-agent-plugins ``` 2. Installez le plug-in. ``` claude plugin install equinix-fabric@equinix-agent-plugins ``` Vous pouvez également `/plugin`participer à une session interactive et effectuer une sélection `equinix-fabric` sur le `equinix-agent-plugins` Marketplace. 3. Authentifier. Exécutez `/mcp`, sélectionnez `equinix-fabric`et terminez la connexion au navigateur. 4. Vérifiez que le plug-in est installé et que le serveur est connecté. ``` claude plugin list ``` ``` claude mcp list ``` ## Installer dans Claude Desktop[​](#installer-dans-claude-desktop "Lien direct vers Installer dans Claude Desktop") 1. Accédez à **Paramètres > personnaliser** et sélectionnez **plugins**. 2. Sélectionnez **Ajouter une place de marché**. 3. Saisissez l'adresse du référentiel et confirmez. ``` https://github.com/equinix/equinix-agent-plugins ``` 4. Attendez la synchronisation du Marketplace. Claude Desktop lit l’index Marketplace à partir du référentiel et répertorie les plugins qu’il déclare. Sur l'entrée Marketplace, sélectionnez **synchroniser** chaque fois que vous souhaitez obtenir de nouveaux plugins ou versions. 5. Dans la liste, recherchez **Equinix-Fabric**, sélectionnez **installer** et confirmez que son basculement est activé. 6. Authentifier. Accédez à **Paramètres > connecteurs**, recherchez **Equinix-Fabric** et complétez la connexion au navigateur. Les compétences fonctionnent uniquement après la connexion du serveur. 7. Démarrer une nouvelle session. ## Installer pour une équipe[​](#installer-pour-une-équipe "Lien direct vers Installer pour une équipe") Pour donner le plug-in à tous les participants à un projet lorsqu'ils clonent le référentiel du projet, validez ce qui suit dans le fichier du projet`.claude/settings.json`. ``` { "extraKnownMarketplaces": { "equinix-agent-plugins": { "source": { "source": "github", "repo": "equinix/equinix-agent-plugins" } } }, "enabledPlugins": { "equinix-fabric@equinix-agent-plugins": true } } ``` Chaque utilisateur se connecte toujours individuellement, et les autorisations de chaque utilisateur proviennent de son propre compte Equinix. ## Installer dans Codex[​](#installer-dans-codex "Lien direct vers Installer dans Codex") Codex installe les compétences à partir du marché. Ajoutez le serveur Fabric MCP séparément. 1. Dans Codex, accédez à **plugins > Ajouter > Ajouter une place de marché**. 2. Saisissez l'adresse du référentiel et ajoutez le Marketplace. ``` https://github.com/equinix/equinix-agent-plugins ``` 3. Dans votre espace personnel, sélectionnez **Equinix-Fabric** et installez-le. 4. Ajoutez le serveur Fabric MCP. ``` codex mcp add equinix-fabric --url https://mcp.equinix.com/fabric ``` 5. Lorsque Codex appelle le serveur pour la première fois, démarrez une nouvelle session et terminez la connexion au navigateur. ## Installer sur d'autres clients[​](#installer-sur-dautres-clients "Lien direct vers Installer sur d'autres clients") Pour les clients tels que Cursor, code Visual Studio, interface de ligne de commande Gemini et OpenCode, ajoutez le serveur et les compétences séparément. 1. Ajoutez le serveur Fabric MCP en suivant les instructions pour votre client dans [Configuration et Configuration](https://docs.equinix.com/fr/equinix-api/mcp-servers/overview.md#setup-and-configuration). 2. Ajoutez les compétences. Clonez le référentiel et pointez le chargeur de compétences de votre client vers le répertoire de compétences, ou collez le contenu d'un `SKILL.md` fichier dans les instructions de votre client. ``` git clone https://github.com/equinix/equinix-agent-plugins.git ``` Les compétences sont des fichiers Markdown simples dans le `fabric-agent-plugins/skills/` répertoire. Chaque compétence possède son propre dossier qui contient un `SKILL.md` fichier et, pour certaines compétences, un `references` dossier avec des procédures d'assistance. ## Vérifiez l'installation[​](#vérifiez-linstallation "Lien direct vers Vérifiez l'installation") Ouvrez une session et saisissez une demande telle que la suivante : ``` Show me all my Fabric connections in SV. ``` Le client appelle le serveur MCP Fabric et renvoie les connexions que votre utilisateur Equinix peut voir. Si elle répond sans appeler un outil, le serveur n'est pas connecté. Pour plus d'informations, reportez-vous à la section [Dépannage](#troubleshooting). Autres demandes à essayer : * `List my Fabric Cloud Routers.` * `Which of my service tokens expire in the next 30 days?` * `What Fabric Networks do I have?` * `Create a BASIC Fabric Cloud Router in Dallas.` * `Connect my SV port to AWS Direct Connect at 1 Gbps.` ## Mettre à jour ou supprimer le plug-in[​](#mettre-à-jour-ou-supprimer-le-plug-in "Lien direct vers Mettre à jour ou supprimer le plug-in") Dans Claude Code, actualisez le Marketplace avant de procéder à la mise à jour afin que le client voie la dernière version. ``` claude plugin marketplace update equinix-agent-plugins ``` ``` claude plugin update equinix-fabric@equinix-agent-plugins ``` Pour supprimer le plug-in, exécutez la commande suivante. ``` claude plugin uninstall equinix-fabric@equinix-agent-plugins ``` Dans Claude Desktop, sélectionnez **synchroniser** sur l’entrée Marketplace, puis **mettre à jour** sur le plug-in. Pour supprimer le plug-in, sélectionnez **Désinstaller**. Pour supprimer le Marketplace et tous les plug-ins de celui-ci, sélectionnez **Supprimer le Marketplace**. ## Autorisations et approbations[​](#autorisations-et-approbations "Lien direct vers Autorisations et approbations") Le plugin ne change pas ce que votre compte Equinix peut faire. Le client agit en tant qu'utilisateur qui s'est connecté, et le jeton qu'il détient accorde l'intersection des rôles de cet utilisateur et du niveau d'autorisation sélectionné au moment de la connexion. Pour plus d'informations, consultez [modèle d'autorisations](https://docs.equinix.com/fr/equinix-api/mcp-servers/overview.md#permissions-model) . Les points suivants sont spécifiques aux compétences : * Activer l'invite de confirmation de votre client pour les appels d'outils qui créent ou mettent à jour des ressources. Les compétences`manage-fabric-connection` , `manage-fabric-network`, et `manage-cloud-router`créent et modifient des ressources Fabric, et certaines de ces ressources sont facturées. * Le serveur ne publie aucun outil de suppression, de sorte que les demandes de suppression d'une connexion, d'un réseau Fabric ou d'une ressource Fabric Cloud Router échouent. Pour supprimer une ressource, utilisez Equinix Customer Portal ou Fabric API. ## Dépannage[​](#dépannage "Lien direct vers Dépannage") Pour les erreurs d'authentification, de connectivité et d'autorisation, reportez-vous à la section [Dépannage](https://docs.equinix.com/fr/equinix-api/mcp-servers/overview.md#troubleshooting) de la présentation du serveur MCP. Les problèmes suivants sont spécifiques au plugin. ### La Marketplace ne parvient pas à se synchroniser[​](#la-marketplace-ne-parvient-pas-à-se-synchroniser "Lien direct vers La Marketplace ne parvient pas à se synchroniser") **Problème :** Votre client ne peut pas ajouter ou actualiser le `equinix-agent-plugins` Marketplace. **Solution :** Vérifiez que votre réseau autorise l'accès à `https://github.com`. Vérifiez que vous avez saisi l'adresse exactement comme `https://github.com/equinix/equinix-agent-plugins`. Puis, sélectionnez **synchroniser** sur l'entrée Marketplace ou exécutez `claude plugin marketplace update equinix-agent-plugins`. ### Le plug-in est installé, mais le client ne dispose pas d'outils Fabric[​](#le-plug-in-est-installé-mais-le-client-ne-dispose-pas-doutils-fabric "Lien direct vers Le plug-in est installé, mais le client ne dispose pas d'outils Fabric") **Problème :** Votre client reconnaît la demande mais signale qu'il ne dispose pas d'outils Fabric ou qu'il répond à partir de connaissances générales au lieu de votre compte. **Solution :** Le plug-in est installé mais le serveur n'est pas authentifié. Exécutez `/mcp` dans Claude Code, ou accédez à **Paramètres > connecteurs** dans Claude Desktop, sélectionnez `equinix-fabric`, puis terminez la connexion au navigateur. Ensuite, démarrez une nouvelle session. ### Le Fabric Server apparaît deux fois[​](#le-fabric-server-apparaît-deux-fois "Lien direct vers Le Fabric Server apparaît deux fois") **Problème :** Votre client répertorie à la fois `fabric-mcp` et `equinix-fabric`, ou affiche deux fois chaque outil Fabric. **Solution :** Vous avez ajouté le serveur manuellement en suivant [installation et configuration](https://docs.equinix.com/fr/equinix-api/mcp-servers/overview.md#setup-and-configuration) avant d'installer le plug-in. Le plugin ajoute sa propre copie nommée `equinix-fabric`. Supprimer l'entrée manuelle. Dans Claude Code, exécutez `claude mcp remove fabric-mcp`. Sur les autres clients, supprimez l'`fabric-mcp`entrée de la configuration MCP du client. ### Le Client vous demande d'affiner une recherche[​](#le-client-vous-demande-daffiner-une-recherche "Lien direct vers Le Client vous demande d'affiner une recherche") **Problème :** Vous demandez votre inventaire et le client vous demande une zone métropolitaine, un projet ou un type de ressource au lieu de renvoyer les résultats. **Solution :** Ce comportement est intentionnel. La `show-fabric-inventory` compétence demande au moins un filtre sur une demande ouverte. Ajoutez un filtre, tel que `show me my ports in SV`, ou demandez tout explicitement, tel que `show me my full Fabric inventory`. ## Ressources supplémentaires[​](#ressources-supplémentaires "Lien direct vers Ressources supplémentaires") * [Présentation du serveur MCP](https://docs.equinix.com/fr/equinix-api/mcp-servers/overview.md) - Configuration, authentification, autorisations et sécurité pour le serveur. * [Fabric Tools](https://docs.equinix.com/fr/equinix-api/mcp-servers/fabric-mcp-server.md) - les outils que le serveur publie et le niveau d'accès dont chacun a besoin. * [Référence Fabric API](https://docs.equinix.com/fr/api-catalog/fabricv4.md) - le API appelé par les outils. * [Equinix-agent-plugins](https://github.com/equinix/equinix-agent-plugins) - source du plug-[in](https://github.com/equinix/equinix-agent-plugins), définitions des compétences et conseils de contribution.