Présentation du serveur MCP

Le serveur MCP Fabric permet aux assistants IA et aux outils de développement d'appeler le Equinix Fabric API en votre nom. MCP (Model Context Protocol) est un protocole ouvert permettant de connecter ces outils à des services externes. Un client MCP peut rechercher et modifier vos ressources Fabric sans avoir à écrire de code API.

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 serveur MCP, envoyez un e-mail à fabric-intelligence-support@equinix.com.

URL du serveur	Outils	Description
`https://mcp.equinix.com/fabric`	Outils Fabric	Connexions, ports, routeurs cloud, routage, profils de service, et la télémétrie.

Installer en tant que plug-in

Claude Code et Claude Desktop peuvent installer ce serveur en même temps que les compétences Equinix Fabric en une seule étape, sans configuration de serveur. Les compétences indiquent au client quels filtres et valeurs chaque opération Fabric accepte. Pour plus d'informations, reportez-vous à la rubrique module d'extension Fabric Skills .

Clients MCP pris en charge

Les clients suivants sont pris en charge :

Bureau Claude , l'application de bureau d'Anthropic
Claude Code, agent de terminal d'Anthropic
Curseur, l'éditeur de code IA
Code Visual Studio , via GitHub CoPilot
Codex, via l'interface de ligne de commande ou l'application de bureau
Gemini CLI, agent de terminal de Google
OpenCode, l'agent de terminal open-source

D’autres clients MCP qui prennent en charge les serveurs distants avec OAuth peuvent fonctionner, mais ils ne sont pas testés. Pour plus d'informations, reportez-vous à la rubrique autres clients MCP .

Limites d'outils dans votre Client

Le serveur Fabric MCP publie plus de 100 outils. Certains clients limitent le nombre d'outils qu'un modèle peut charger simultanément. Le code Visual Studio autorise un maximum de 128 outils dans toutes les sources, et Windsurf en autorise 100. L’exécution simultanée de plusieurs serveurs MCP peut dépasser ces limites, ce qui entraîne l’échec des demandes ou l’omission d’outils sans préavis.

Si vous atteignez une limite d'outils client, désactivez les serveurs MCP que vous n'utilisez pas. Certains clients chargent les définitions d'outils à la demande plutôt qu'à la fois, ce qui évite la limite.

Conditions préalables

Un compte Equinix Customer Portal avec accès Fabric
Client MCP qui prend en charge les serveurs MCP distants avec OAuth

Aucun logiciel supplémentaire n'est requis. Il n'y a pas de package à installer ni de jeton à générer. Votre client termine la connexion dans un navigateur.

Authentification

Le serveur utilise OAuth 2,1 et prend en charge à la fois l'enregistrement dynamique des clients (DCR) et les documents de métadonnées d'identification des clients (CIMD). Votre client utilise la méthode qu'il met en œuvre. La plupart des clients utilisent actuellement la DCR. Le code Visual Studio prend également en charge la CIMD.

Ajoutez l'URL du serveur à la configuration de votre client, comme décrit dans la section installation et configuration.
Le client détecte qu'il n'a pas de jeton et vous invite à vous connecter.
Une fenêtre de navigateur s'ouvre. Connectez-vous avec vos identifiants Equinix Customer Portal.
Sur l'écran d'approbation, sélectionnez un niveau d'autorisation, puis approuvez la demande. Pour plus d'informations, consultez modèle d'autorisations .
Le client stocke les jetons et les actualise en arrière-plan.

Effectuez ce processus une fois par client. La session reste valide jusqu'à son expiration ou jusqu'à ce que vous la révoquiez.

Cycle de vie des jetons

Les jetons d’accès sont de courte durée et sont liés au serveur pour lequel vous les avez autorisés. Les clients enregistrés avec un document de métadonnées d’identifiant client reçoivent également un jeton d’actualisation rotatif et renouvellent en arrière-plan, de sorte que vous êtes rarement invité à vous connecter. Les clients enregistrés via DCR se renouvellent via le flux de navigateur, de sorte qu'ils vous invitent à vous connecter plus fréquemment.

Si une session expire ou si vous la révoquez, le client vous invite à vous reconnecter.

Mise en place et configuration

Chaque client suit les mêmes trois étapes : ajoutez l'URL du serveur, enregistrez la configuration et redémarrez le client. Seuls l'emplacement du fichier et le format de configuration diffèrent. L’URL du serveur Fabric est https://mcp.equinix.com/fabric.

Bureau Claude

Vous pouvez ajouter le serveur via la page connecteurs ou en modifiant le fichier de configuration. Anthropic documente les deux méthodes dans des intégrations personnalisées à l'aide de MCP distant .

Option 1 : Ajouter des connecteurs via (recommandé)

Ouvrez Claude Desktop et cliquez sur le menu de votre profil, puis sur Paramètres.
Dans la barre latérale Paramètres, cliquez sur connecteurs.
Cliquez sur Ajouter un connecteur personnalisé .
Entrez un nom (par exemple, Fabric MCP) et définissez l'URL du serveur MCP distant sur https://mcp.equinix.com/fabric, puis cliquez sur Ajouter.
Cliquez sur connecter en regard du nouveau connecteur. Une fenêtre de navigateur s'ouvre dans laquelle vous vous authentifiez avec vos identifiants Equinix Customer Portal.

Si la session expire, le connecteur affiche « la connexion a expiré ». Cliquez sur se connecter pour vous reconnecter.

Option 2 : Modifiez le fichier de configuration

Emplacement du fichier de configuration :

MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json

Vous pouvez également ouvrir le fichier de configuration à partir de Paramètres > Développeur > modifier la configuration dans Claude Desktop.

Exemple de serveur MCP Fabric :

{
  "mcpServers": {
    "Equinix Fabric MCP Server": {
      "url": "https://mcp.equinix.com/fabric"
    }
  }
}

Enregistrez le fichier et redémarrez Claude Desktop. La connexion au navigateur s'ouvre la première fois que vous utilisez un outil Fabric.

Code Claude

Ajoutez le serveur à partir de la ligne de commande :

claude mcp add --transport http fabric-mcp https://mcp.equinix.com/fabric

Ajouter -s user à la commande pour rendre le serveur disponible dans chaque projet plutôt que uniquement dans le projet en cours.

Puis authentifiez-vous :

/mcp

Sélectionnez fabric-mcp dans la liste et complétez la connexion au navigateur. Cet écran affiche également l'état de la connexion, qui distingue une session expirée d'une erreur de configuration.

Vous pouvez également modifier directement le fichier de configuration. Dans~/.claude.json :

{
  "mcpServers": {
    "fabric-mcp": {
      "type": "http",
      "url": "https://mcp.equinix.com/fabric"
    }
  }
}

Curseur

CURSOR lit les serveurs MCP à partir d'un fichier JSON. Pour plus d'informations, consultez la documentation Cursor MCP .

Emplacement du fichier de configuration :

Au niveau du projet : .cursor/mcp.json dans la racine de votre projet
Monde : ~/.cursor/mcp.json

Vous pouvez également ajouter des serveurs via Paramètres du curseur > outils et MCP > Nouveau serveur MCP .

Exemple de serveur MCP Fabric :

{
  "mcpServers": {
    "Equinix Fabric MCP Server": {
      "url": "https://mcp.equinix.com/fabric"
    }
  }
}

Redémarrez le curseur. Le curseur vous invite à vous connecter la première fois qu'il se connecte.

Code Visual Studio

Le code Visual Studio stocke les serveurs MCP dans mcp.json. Pour connaître l'ensemble des options, consultez la documentation MCP du code Visual Studio .

Emplacement du fichier de configuration :

MacOS/Linux : .vscode/mcp.json (espace de travail) ou ~/.vscode/mcp.json (utilisateur)
Windows : .vscode\mcp.json (espace de travail) ou %USERPROFILE%\.vscode\mcp.json (utilisateur)

Exemple de serveur MCP Fabric :

{
  "servers": {
    "fabric-mcp": {
      "type": "http",
      "url": "https://mcp.equinix.com/fabric"
    }
  }
}

Redémarrez le code Visual Studio ou rechargez la fenêtre (Cmde+Maj+P sous macOS, Ctrl+Maj+P sous Windows et Linux, puis Développeur : Fenêtre de rechargement ). La connexion au navigateur s'ouvre lors de la première utilisation.

CLI Gemini

Gemini CLI lit les serveurs MCP à partir de settings.json. Pour plus d'informations, consultez la documentation MCP de l'interface de ligne de commande Gemini .

Emplacement du fichier de configuration :

Monde : ~/.gemini/settings.json
Au niveau du projet : .gemini/settings.json

Exemple de serveur MCP Fabric. Ce client a besoin de la httpUrl clé plutôt queurl :

{
  "mcpServers": {
    "fabric-mcp": {
      "httpUrl": "https://mcp.equinix.com/fabric",
      "oauth": {
        "enabled": true
      }
    }
  }
}

Redémarrez l'interface de ligne de commande Gemini, puis authentifiez-vous :

/mcp auth fabric-mcp

Cette commande ouvre un navigateur et écoute sur http://localhost:7777/oauth/callback, alors exécutez-la sur un système équipé d'un navigateur. Il ne fonctionne pas sur une session SSH sans transfert de navigateur. Exécutez /mcp auth sans arguments pour répertorier les serveurs qui nécessitent encore une connexion.

OpenCode

OpenCode stocke les serveurs MCP dans son fichier de configuration sous la mcp clé. Pour plus d'informations, consultez la documentation OpenCode MCP .

Emplacement du fichier de configuration :

Au niveau du projet : opencode.json dans la racine de votre projet
Monde : ~/.config/opencode/opencode.json

Exemple de serveur MCP Fabric :

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "fabric-mcp": {
      "type": "remote",
      "url": "https://mcp.equinix.com/fabric",
      "enabled": true
    }
  }
}

OpenCode exécute le flux OAuth la première fois qu'il utilise le serveur. Vous pouvez également démarrer le flux manuellement :

opencode mcp auth fabric-mcp

Codex

Vous pouvez ajouter le serveur via l'interface de ligne de commande, l'application de bureau ou le fichier de configuration.

Option 1 : Ajouter via CLI (recommandé)

Installez Codex CLI à l'aide de la documentation d'installation de Codex CLI .

Ajoutez un serveur MCP à l'aide de la commande suivante :

codex mcp add fabric-mcp --url https://mcp.equinix.com/fabric

Exécutez la commande login :
```
codex mcp login fabric-mcp
```
Une fenêtre de navigateur s'ouvre dans laquelle vous vous authentifiez avec vos identifiants Equinix Customer Portal.

Option 2 : Ajouter via Codex Desktop

Ouvrez Codex Desktop.
Accédez à Paramètres.
Dans la barre latérale des paramètres, cliquez sur serveur MCP .
Cliquez sur Ajouter un serveur.
Saisissez un nom (par exemple, Fabric MCP), sélectionnez HTTP en continu comme type, définissez l'URL sur https://mcp.equinix.com/fabric, puis cliquez sur Enregistrer.
Après avoir ajouté le serveur, exécutez la commande login à partir de votre terminal :
```
codex mcp login fabric-mcp
```
Une fenêtre de navigateur s'ouvre dans laquelle vous vous authentifiez avec vos identifiants Equinix Customer Portal.

Option 3 : Modifiez le fichier de configuration

Emplacement du fichier de configuration :

~/.codex/config.toml (niveau utilisateur)
.codex/config.toml (au niveau du projet)

Exemple de serveur MCP Fabric :

[mcp_servers.fabric]
url = "https://mcp.equinix.com/fabric"

Enregistrez le fichier et redémarrez Codex Desktop, puis connectez-vous lorsque vous y êtes invité.

Autres clients MCP

Ajoutez https://mcp.equinix.com/fabric le format requis par votre client pour un serveur MCP distant. Le client gère le flux OAuth. Les clients qui ne sont pas répertoriés dans les clients MCP pris en charge ne sont pas testés. Si un client non testé ne parvient pas à se connecter, vérifiez le serveur auprès d'un client pris en charge avant d'ouvrir un ticket d'assistance.

Modèle d'autorisations

Le serveur MCP Fabric appelle Fabric API en tant qu'utilisateur connecté. Chaque appel est attribué à cet utilisateur dans le journal d'audit, de la même manière qu'un appel API direct. Le serveur ne peut effectuer aucune opération que le compte de l'utilisateur n'est pas déjà autorisé à effectuer.

Deux contrôles déterminent ce qu'un client connecté peut appeler :

Rôles de compte. Les rôles attribués à votre compte Equinix Customer Portal définissent le niveau d’accès maximal. La connexion via MCP n'augmente pas ce chiffre.
Niveau d'autorisation. Lorsqu'un client se connecte, vous sélectionnez un niveau d'autorisation sur l'écran d'approbation. Les niveaux suivants sont disponibles :

Niveau d'autorisation	Description
`fabricViewer`	Accès en lecture seule. Recherches et recherches, telles que `searchNetworks` ou `getNetworkByUuid`.
`fabricOperator`	Accès au visualiseur, ainsi que la modification des ressources existantes et les opérations d'association ou de détachement, telles que `updateNetwork`.
`fabricManager`	Accès opérateur, plus création de ressources, telles que `createNetwork` ou `createRouter`.

Le jeton émis accorde l'intersection des deux contrôles. Un niveau d'autorisation inférieur aux rôles du compte limite le client. Un niveau d'autorisation supérieur aux rôles du compte n'accorde pas d'accès supplémentaire.

Utilisez le niveau d'autorisation le plus restreint qui couvre le travail. Lors de la configuration d'un agent qui répond uniquement aux questions concernant votre inventaire, le fabricViewerniveau d'autorisation est approprié. Un client configuré avec ce niveau d'autorisation ne peut pas modifier les ressources, même si l'utilisateur dispose de droits d'administration.

L'un ou l'autre contrôle peut rejeter un appel. Une erreur d'autorisation est le plus souvent causée par un rôle manquant sur le compte plutôt que par un niveau d'autorisation restrictif. Vérifiez d'abord les rôles du compte.

Aucun niveau d'autorisation n'accorde l'accès de suppression. Le serveur ne publie aucun outil de suppression, de sorte que les connexions, les ports, les routeurs cloud et les réseaux ne peuvent pas être supprimés via le serveur MCP. Supprimez ces ressources dans le portail ou via API.

Considérations sur la sécurité

Avant de connecter un client, vérifiez les éléments suivants.

Confirmez les opérations d'écriture. Activez la confirmation d'outil dans votre client MCP pour tout outil qui crée ou met à jour une ressource. La plupart des clients demandent par défaut, mais vérifiez le paramètre, car certains créent des opérations qui entraînent immédiatement des frais. La commande d'un port ou d'un routeur Cloud par l'intermédiaire d'un agent est facturée au même tarif que la commande d'un port ou d'un routeur Cloud sur le portail.
Connecter uniquement les clients de confiance. Tout client MCP peut initier une demande d’authentification auprès de Equinix. L’approbation de la demande accorde à cette application l’accès à votre compte pour la durée de la session. Vérifiez que la demande provient d'une application que vous avez installée et configurée, et refusez toute demande provenant d'un lien ou d'une application non reconnue. Les clients qui prennent en charge les documents de métadonnées d'identifiant client s'identifient à un document publié à une URL stable, ce qui est un indicateur d'identité plus fort que l'enregistrement dynamique seul. Dans les deux cas, la décision d'approbation vous appartient.
Traiter la sortie de l'outil comme une entrée non fiable. Les réponses de l'outil incluent du texte défini par l'utilisateur, tel que les noms de connexion, les noms de projet et les balises. Une ressource nommée pour ressembler à une instruction peut amener un agent à appeler un outil que vous n'avez pas demandé. Gardez la confirmation activée pour les outils d'écriture et évaluez le risque avant d'exécuter le serveur Fabric MCP aux côtés de serveurs qui récupèrent du contenu non fiable, tels que les navigateurs Web ou les clients de messagerie.
Savoir où vos données sont envoyées. Vos invites et les réponses aux outils qu'elles génèrent passent par le modèle utilisé par votre client MCP, sous réserve des conditions de ce fournisseur. Toutes les données renvoyées par le serveur, y compris les noms de connexion, l'inventaire des ports et la télémétrie, font partie de cette conversation. Si votre organisation limite l'endroit où les données d'infrastructure peuvent être envoyées, examinez le client et son modèle sous-jacent avant de vous connecter. Equinix enregistre les appels API que le serveur effectue en votre nom de la même manière que tout autre trafic API provenant de votre compte.

Pour révoquer l'accès d'un client que vous ne reconnaissez plus, reportez-vous à la rubrique vérification et révocation de l'accès.

Vérification et révocation de l'accès

Chaque client que vous autorisez apparaît sous gestion du consentement IA dans votre compte utilisateur Equinix , accessible depuis compte utilisateur > accès > gestion du consentement IA . La liste vous indique chaque client par nom, si son consentement est toujours accordé, quand vous l'avez autorisé et quand il a appelé Equinix pour la dernière fois.

Utilisez cette page pour identifier quels agents peuvent actuellement accéder à votre compte Fabric et quels agents sont inactifs. Cliquez sur révoquer sur une ligne pour mettre fin à l'accès de ce client, ou sélectionnez plusieurs lignes et révoquez-les ensemble.

Révoquez l'accès en cas de perte d'un appareil, lorsque vous n'utilisez plus un client que vous avez testé précédemment ou lorsqu'une date de dernière activité ne correspond pas à votre propre utilisation.

La suppression du serveur de la configuration d'un client ne révoque pas l'accès. Cette modification empêche le client local d'appeler le serveur, mais l'autorisation reste active jusqu'à ce que vous la révoquiez.

important

Le serveur MCP ne contourne aucune exigence d'autorisation ou de compte. Si un appel API direct est rejeté pour des droits manquants ou un état de compte non valide, l'appel MCP est également rejeté.

Vérifiez la connexion

Une fois le client redémarré et que vous avez terminé la connexion au navigateur, émettez une demande en lecture seule :

répertorier les métros Equinix Fabric.

Une liste de codes métropolitains confirme que le serveur est connecté et que le jeton est valide. Une erreur d'autorisation indique que la connexion n'a pas été effectuée. Vérifiez d'abord les journaux MCP du client.

Dépannage

Échec de l'authentification

Le client ne peut pas s'authentifier ou signale une erreur d'autorisation lorsqu'il se connecte.

Vérifiez que votre compte Equinix Customer Portal est actif.
Supprimez le serveur du client, ajoutez-le à nouveau et terminez la connexion au navigateur.
Si le client le prend en charge, effacez les informations d'identification mises en cache du client, puis redémarrez le client et connectez-vous à nouveau.

Le serveur ne répond pas

Le client ne peut pas atteindre le serveur ou aucun outil n'est répertorié.

Vérifiez que le système peut atteindre https://mcp.equinix.com/fabric.
Comparez l'URL et le format du fichier de configuration aux exemples présentés dans Configuration et Configuration.
Redémarrez le client pour réinitialiser la connexion.
Consultez les journaux du serveur MCP dans le client pour rechercher l'erreur spécifique.
Si le serveur se connecte mais que seuls certains outils sont répertoriés, reportez-vous à la section limites des outils dans votre client.

Autorisation refusée

Un appel échoue avec une erreur d'autorisation ou d'autorisation.

Vérifiez les rôles sur le compte avec lequel vous vous êtes connecté. C'est la cause la plus fréquente.
Vérifiez le niveau d'autorisation que vous avez sélectionné lorsque vous vous êtes connecté. Un client connecté à fabricViewer ne peut pas effectuer d'opérations d'écriture, quels que soient les rôles du compte. Reconnectez-vous et sélectionnez fabricOperator ou fabricManager si l'opération l'exige.
Vérifiez que le compte a accès au projet qui contient la ressource.
Si vous avez demandé une opération de suppression, notez que le serveur ne publie aucun outil de suppression. Utilisez le portail ou le API.

Session expirée

Les appels qui ont réussi commencent à échouer avec des erreurs d'authentification. Les clients renouvellent automatiquement les jetons, de sorte que cette condition indique généralement que l'autorisation a été révoquée ou n'a pas pu être renouvelée. Vérifiez que le client est toujours autorisé en cours de révision et de révocation de l'accès.

Redémarrez le client pour déclencher une nouvelle connexion.
Lorsque vous y êtes invité, terminez le flux du navigateur.
Si la condition persiste, supprimez la configuration du serveur et ajoutez-la à nouveau.

Limitation du débit

Le serveur est soumis aux mêmes limites de débit que l'accès direct à API. Réduisez le taux de demande ou contactez l'assistance clientèle Equinix pour vérifier vos limites.

Ressources supplémentaires

Fabric Tools - les outils que ce serveur publie.
Plugin Fabric Skills - les compétences Fabric et ce serveur, installés en tant que plugin unique.
Référence Fabric API - le API appelé par les outils.
Référence sur les rôles et autorisations IAM - les opérations autorisées par chaque rôle.
Authentification API : authentification pour un accès direct à API.
Spécification du protocole de contexte du modèle - la spécification du protocole.

Clients MCP pris en charge​

Limites d'outils dans votre Client​

Conditions préalables​

Authentification​

Cycle de vie des jetons​

Mise en place et configuration​

Bureau Claude​

Option 1 : Ajouter des connecteurs via (recommandé)​

Option 2 : Modifiez le fichier de configuration​

Code Claude​

Curseur​

Code Visual Studio​

CLI Gemini​

OpenCode​

Codex​

Option 1 : Ajouter via CLI (recommandé)​

Option 2 : Ajouter via Codex Desktop​

Option 3 : Modifiez le fichier de configuration​

Autres clients MCP​

Modèle d'autorisations​

Considérations sur la sécurité​

Vérification et révocation de l'accès​

Vérifiez la connexion​

Dépannage​

Échec de l'authentification​

Le serveur ne répond pas​

Autorisation refusée​

Session expirée​

Limitation du débit​

Ressources supplémentaires​

Clients MCP pris en charge

Limites d'outils dans votre Client

Conditions préalables

Authentification

Cycle de vie des jetons

Mise en place et configuration

Bureau Claude

Option 1 : Ajouter des connecteurs via (recommandé)

Option 2 : Modifiez le fichier de configuration

Code Claude

Curseur

Code Visual Studio

CLI Gemini

OpenCode

Codex

Option 1 : Ajouter via CLI (recommandé)

Option 2 : Ajouter via Codex Desktop

Option 3 : Modifiez le fichier de configuration

Autres clients MCP

Modèle d'autorisations

Considérations sur la sécurité

Vérification et révocation de l'accès

Vérifiez la connexion

Dépannage

Échec de l'authentification

Le serveur ne répond pas

Autorisation refusée

Session expirée

Limitation du débit

Ressources supplémentaires