Passer au contenu principal

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ôtEquinix-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.

Contenu du plug-in​

Le Marketplace publie un plug-in, equinix-fabric, qui contient quatre compétences.

CompétencesCe que vous pouvez demander au client de faire
show-fabric-inventoryRechercher 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-connectionCré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-networkPlanifier, 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-routerCré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 .

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

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 /pluginparticiper à une session interactive et effectuer une sélection equinix-fabric sur le equinix-agent-plugins Marketplace.

  3. Authentifier. Exécutez /mcp, sélectionnez equinix-fabricet 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​

  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​

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​

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​

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.

  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​

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.

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​

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​

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 .

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étencesmanage-fabric-connection , manage-fabric-network, et manage-cloud-routercré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​

Pour les erreurs d'authentification, de connectivité et d'autorisation, reportez-vous à la section Dépannage de la présentation du serveur MCP. Les problèmes suivants sont spécifiques au plugin.

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​

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​

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 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-mcpentrée de la configuration MCP du client.

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​

Cette page vous a-t-elle été utile ?