Visión general del servidor MCP

El servidor MCP de Fabric permite que los asistentes de IA y las herramientas de desarrollo llamen al Equinix Fabric API en su nombre. El protocolo contextual del modelo (MCP) es un protocolo abierto para conectar estas herramientas a servicios externos. Un cliente MCP puede buscar y modificar sus recursos de Fabric sin necesidad de escribir código API.

Vista previa pública

El servidor MCP de Fabric se encuentra en vista previa pública. Las herramientas, las descripciones y los formatos de respuesta pueden cambiar antes de la disponibilidad general.

Para obtener comentarios, preguntas o ayuda con el servidor MCP, envíe un correo electrónico a fabric-intelligence-support@equinix.com.

URL del servidor	Herramientas	Descripción
`https://mcp.equinix.com/fabric`	Herramientas de Fabric	Conexiones, puertos, Cloud Routers, enrutamiento, perfiles de servicio, y telemetría.

Instalar como complemento

Claude Code y Claude Desktop pueden instalar este servidor junto con las habilidades de Equinix Fabric en un solo paso, sin configuración de servidor. Las habilidades indican al cliente qué filtros y valores acepta cada operación de Fabric. Para obtener más información, consulte el complemento de habilidades de Fabric .

Clientes MCP compatibles

Se admite a los siguientes clientes:

Claude Desktop, aplicación de escritorio de anthropic
Código de Claude , agente terminal de anthropic
Cursor, el editor de código de IA
Código de Visual Studio, a través de Copilot de GitHub
Codex, a través de la CLI o la aplicación de escritorio
Gemini CLI, el agente terminal de Google
OpenCode, el agente terminal de código abierto

Es posible que otros clientes MCP que admiten servidores remotos con OAuth funcionen, pero no se prueben. Para obtener más información, consulte Otros clientes MCP .

Límites de herramientas en su cliente

El servidor MCP de Fabric publica más de 100 herramientas. Algunos clientes limitan el número de herramientas que un modelo puede cargar a la vez. El código de Visual Studio permite un máximo de 128 herramientas en todas las fuentes, y Windsurf permite 100. Ejecutar varios servidores MCP simultáneamente puede superar estos límites, lo que provoca que las solicitudes fallen o que se omitan herramientas sin previo aviso.

Si alcanza un límite de herramienta de cliente, desactive los servidores MCP que no esté utilizando. Algunos clientes cargan definiciones de herramientas a demanda en lugar de todas a la vez, lo que evita el límite.

Requisitos previos

Una cuenta de Equinix Customer Portal con acceso a Fabric
Un cliente MCP que admite servidores MCP remotos con OAuth

No se requiere ningún software adicional. No hay ningún paquete que instalar ni ningún token que generar. Su cliente completa el inicio de sesión en un navegador.

Autenticación

El servidor utiliza OAuth 2,1 y admite tanto el registro dinámico de cliente (DCR) como los documentos de metadatos de ID de cliente (CIMD). Su cliente utiliza cualquier método que implemente. La mayoría de los clientes utilizan actualmente DCR. El código Visual Studio también admite CIMD.

Añada la URL del servidor a la configuración de su cliente, como se describe en Configuración y configuración .
El cliente detecta que no tiene token y le pide que se conecte.
Se abre una ventana del navegador. Inicie sesión con sus credenciales de Equinix Customer Portal.
Seleccione un nivel de permiso en la pantalla de aprobación y, a continuación, apruebe la solicitud. Para obtener más información, consulte Modelo de permisos .
El cliente almacena los tokens y los actualiza en segundo plano.

Complete este proceso una vez por cliente. La sesión sigue siendo válida hasta que caduque o la revoque.

Ciclo de vida del token

Los tokens de acceso son de corta duración y están vinculados al servidor para el que los autorizó. Los clientes registrados con un documento de metadatos de ID de cliente también reciben un token de actualización giratorio y se renuevan en segundo plano, por lo que rara vez se le pide que inicie sesión. Los clientes registrados a través de DCR se renuevan a través del flujo del navegador, por lo que le solicitan que inicie sesión con más frecuencia.

Si una sesión caduca o la revocas, el cliente te pedirá que inicies sesión de nuevo.

Instalación y configuración

Cada cliente sigue los mismos tres pasos: Añada la URL del servidor, guarde la configuración y reinicie el cliente. Solo difieren la ubicación del archivo y el formato de configuración. La URL del servidor de Fabric es https://mcp.equinix.com/fabric.

Escritorio de Claude

Puede añadir el servidor a través de la página Conectores o editando el archivo de configuración. Anthropic documenta ambos métodos en integraciones personalizadas utilizando MCP remoto .

Opción 1: Añadir a través de conectores (recomendado)

Abra Claude Desktop y haga clic en su menú de perfil y, a continuación, Configuración.
En la barra lateral Configuración, haga clic en Conectores.
Haga clic en Añadir conector personalizado .
Introduzca un nombre (por ejemplo, Fabric MCP) y establezca la URL del servidor MCP remoto en https://mcp.equinix.com/fabric, a continuación, haga clic en Añadir.
Haga clic en Conectar junto al nuevo conector. Se abre una ventana del navegador donde se autentica con sus credenciales de Equinix Customer Portal.

Si la sesión caduca, el conector muestra "La conexión ha caducado". Haga clic en Conectar para iniciar sesión de nuevo.

Opción 2: Edite el archivo de configuración

Ubicación del archivo de configuración:

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

También puede abrir el archivo de configuración desde Configuración > Desarrollador > Editar configuración dentro de Claude Desktop.

Ejemplo del servidor MCP de Fabric:

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

Guarde el archivo y reinicie Claude Desktop. El inicio de sesión del navegador se abre la primera vez que utiliza una herramienta Fabric.

Código Claude

Añada el servidor desde la línea de comandos:

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

Añada -s useral comando para que el servidor esté disponible en todos los proyectos en lugar de solo en el proyecto actual.

A continuación, autenticar:

/mcp

Seleccione fabric-mcp de la lista y complete el inicio de sesión del navegador. Esta pantalla también muestra el estado de la conexión, que distingue una sesión caducada de un error de configuración.

También puede editar el archivo de configuración directamente. En~/.claude.json:

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

Cursor

El cursor lee los servidores MCP desde un archivo JSON. Para obtener más información, consulte la documentación MCP del cursor .

Ubicación del archivo de configuración:

Nivel de proyecto: .cursor/mcp.json en la raíz de su proyecto
Global: ~/.cursor/mcp.json

También puede añadir servidores a través de la configuración del cursor > Herramientas y MCP > Nuevo servidor MCP .

Ejemplo del servidor MCP de Fabric:

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

Reinicie el cursor. El cursor le pide que inicie sesión la primera vez que se conecte.

Código Visual Studio

El código Visual Studio almacena los servidores MCP en mcp.json. Para obtener el conjunto completo de opciones, consulte la documentación MCP del código Visual Studio .

Ubicación del archivo de configuración:

MacOS/Linux: .vscode/mcp.json (espacio de trabajo) o ~/.vscode/mcp.json (usuario)
Windows: .vscode\mcp.json (espacio de trabajo) o %USERPROFILE%\.vscode\mcp.json (usuario)

Ejemplo del servidor MCP de Fabric:

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

Reinicie el código de Visual Studio o vuelva a cargar la ventana (Cmd+Mayús+P en macOS, Ctrl+Mayús+P en Windows y Linux y, a continuación, Desarrollador: Volver a cargar ventana). El inicio de sesión del navegador se abre en el primer uso.

CLI de Gemini

La CLI de Gemini lee los servidores MCP de settings.json. Para obtener más información, consulte la documentación MCP de Gemini CLI .

Ubicación del archivo de configuración:

Global: ~/.gemini/settings.json
Nivel de proyecto: .gemini/settings.json

Ejemplo de servidor MCP de Fabric. Este cliente requiere la httpUrl clave en lugar de url:

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

Reinicie la CLI de Gemini y, a continuación, autentique:

/mcp auth fabric-mcp

Este comando abre un navegador y escucha en http://localhost:7777/oauth/callback, así que ejecútalo en un sistema con un navegador. No funciona en una sesión SSH sin reenvío del navegador. Ejecute /mcp auth sin argumentos para enumerar los servidores que aún requieren un inicio de sesión.

OpenCode

OpenCode almacena los servidores MCP en su archivo de configuración bajo la mcp clave. Para obtener más información, consulte la documentación MCP de OpenCode .

Ubicación del archivo de configuración:

Nivel de proyecto: opencode.json en la raíz de su proyecto
Global: ~/.config/opencode/opencode.json

Ejemplo del servidor MCP de Fabric:

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

OpenCode ejecuta el flujo OAuth la primera vez que utiliza el servidor. También puede iniciar el flujo manualmente:

opencode mcp auth fabric-mcp

Codex

Puede añadir el servidor a través de la CLI, la aplicación de escritorio o el archivo de configuración.

Opción 1: Añadir a través de CLI (recomendado)

Instale la CLI de Codex con la documentación de configuración de la CLI de Codex .

Añada un servidor MCP con el siguiente comando:

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

Ejecute el comando login:
```
codex mcp login fabric-mcp
```
Se abre una ventana del navegador donde se autentica con sus credenciales de Equinix Customer Portal.

Opción 2: Añada a través de Codex Desktop

Abra el escritorio de Codex.
Vaya a Configuración.
En la barra lateral de configuración, haga clic en Servidor MCP .
Haga clic en Añadir servidor.
Introduzca un nombre (por ejemplo, Fabric MCP), seleccione HTTP streaming como el tipo, establezca la URL en https://mcp.equinix.com/fabric, y haga clic en Guardar.
Después de añadir el servidor, ejecute el comando login desde su terminal:
```
codex mcp login fabric-mcp
```
Se abre una ventana del navegador donde se autentica con sus credenciales de Equinix Customer Portal.

Opción 3: Edite el archivo de configuración

Ubicación del archivo de configuración:

~/.codex/config.toml (nivel de usuario)
.codex/config.toml (nivel de proyecto)

Ejemplo del servidor MCP de Fabric:

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

Guarde el archivo y reinicie Codex Desktop y, a continuación, inicie sesión cuando se le solicite.

Otros clientes de MCP

Añada https://mcp.equinix.com/fabricel formato que su cliente requiere para un servidor MCP remoto. El cliente gestiona el flujo de OAuth. Los clientes que no aparecen en la lista de clientes MCP compatibles no se prueban. Si un cliente no probado no se conecta, verifique el servidor con un cliente compatible antes de abrir una instancia de asistencia.

Modelo de permisos

El servidor MCP de Fabric llama al API de Fabric como el usuario que inició sesión. Cada llamada se atribuye a ese usuario en el registro de auditoría, de la misma manera que una llamada de Direct API. El servidor no puede realizar ninguna operación que la cuenta del usuario no esté autorizada a realizar.

Dos controles determinan a qué puede llamar un cliente conectado:

Roles de cuenta. Los roles asignados a su cuenta de Equinix Customer Portal establecen el nivel máximo de acceso. Conectarse a través de MCP no lo aumenta.
Nivel de permiso. Cuando un cliente se conecta, selecciona un nivel de permiso en la pantalla de aprobación. Los siguientes niveles están disponibles:

Nivel de permiso	Descripción
`fabricViewer`	Acceso de solo lectura. Búsquedas y búsquedas, como `searchNetworks` `getNetworkByUuid`.
`fabricOperator`	Acceso al espectador, además de modificación de recursos existentes y operaciones de adjuntar o desasociar, como `updateNetwork`.
`fabricManager`	Acceso del operador, más creación de recursos, como `createNetwork`o `createRouter`.

El token emitido concede la intersección de los dos controles. Un nivel de permiso inferior a los roles de la cuenta restringe al cliente. Un nivel de permiso superior a los roles de la cuenta no otorga acceso adicional.

Utilice el nivel de permisos más estrecho que cubre el trabajo. Al configurar un agente que solo responda preguntas sobre su inventario, el fabricViewernivel de permiso es el adecuado. Un cliente configurado con este nivel de permiso no puede cambiar los recursos, incluso si el usuario tiene derechos administrativos.

Cualquiera de los controles puede rechazar una llamada. La mayoría de las veces, un error de autorización se debe a la falta de un rol en la cuenta y no a un nivel de permisos restrictivo, así que verifica primero los roles de la cuenta.

Ningún nivel de permiso permite eliminar el acceso. El servidor no publica herramientas de eliminación, por lo que las conexiones, los puertos, los Cloud Routers y las redes no se pueden eliminar a través del servidor MCP. Elimine estos recursos en el portal o a través de API.

Consideraciones sobre seguridad

Revise lo siguiente antes de conectar un cliente.

Confirme las operaciones de escritura. Habilite la confirmación de la herramienta en su cliente MCP para cualquier herramienta que cree o actualice un recurso. La mayoría de los clientes solicitan de forma predeterminada, pero verifican la configuración, porque algunas operaciones de creación incurren en cargos inmediatamente. El pedido de un puerto o un Cloud Router a través de un agente se factura al mismo precio que el pedido de uno en el portal.
Conecte solo clientes de confianza. Cualquier cliente MCP puede iniciar una solicitud de autenticación a Equinix. Al aprobar la solicitud, se concede a esa aplicación acceso a su cuenta durante la duración de la sesión. Confirme que la solicitud se originó en una aplicación que ha instalado y configurado, y rechace cualquier solicitud que llegue desde un enlace o desde una aplicación no reconocida. Los clientes que admiten documentos de metadatos de ID de cliente se identifican con un documento publicado en una URL estable, que es un indicador más fuerte de identidad que el registro dinámico solo. La decisión de aprobación sigue siendo suya en cualquier caso.
Trate la salida de la herramienta como entrada no confiable. Las respuestas de la herramienta incluyen texto definido por el usuario, como nombres de conexión, nombres de proyectos y etiquetas. Un recurso nombrado para que se parezca a una instrucción puede hacer que un agente llame a una herramienta que no solicitó. Mantenga habilitada la confirmación para las herramientas de escritura y evalúe el riesgo antes de ejecutar el servidor MCP de Fabric junto con servidores que recuperan contenido no confiable, como navegadores web o clientes de correo electrónico.
Comprenda dónde se envían sus datos. Sus peticiones y las respuestas de la herramienta que generan pasan por el modelo que utiliza su cliente MCP, sujeto a los términos de ese proveedor. Cualquier dato que devuelva el servidor, incluidos los nombres de conexión, el inventario de puertos y la telemetría, pasa a formar parte de esa conversación. Si su organización restringe dónde se pueden enviar los datos de infraestructura, revise el cliente y su modelo subyacente antes de conectarse. Equinix registra las llamadas a API que el servidor realiza en su nombre de la misma manera que cualquier otro tráfico de API desde su cuenta.

Para revocar el acceso de un cliente que ya no reconoce, consulte Revisar y revocar el acceso.

Revisar y revocar el acceso

Cada cliente que autoriza aparece en Gestión de consentimiento de IA en su cuenta de usuario de Equinix , accesible desde la cuenta de usuario > Acceso > Gestión de consentimiento de IA . La lista le indica a cada cliente por su nombre, si se sigue concediendo su consentimiento, cuándo lo autorizó y cuándo se llamó por última vez Equinix.

Utilice esta página para identificar qué agentes pueden acceder actualmente a su cuenta de Fabric y qué agentes están inactivos. Haga clic en Revocar en una fila para finalizar el acceso de ese cliente, o seleccione varias filas y revocarlas juntas.

Revocar el acceso cuando se pierde un dispositivo, cuando ya no utilice un cliente que ha probado anteriormente o cuando una fecha de última actividad no se corresponda con su propio uso.

Eliminar el servidor de la configuración de un cliente no revoca el acceso. Ese cambio impide que el cliente local llame al servidor, pero la autorización permanece activa hasta que la revoque.

important

El servidor MCP no omite ningún requisito de permiso o cuenta. Si se rechaza una llamada directa a API por falta de derechos o por un estado de cuenta no válido, también se rechaza la llamada a MCP.

Compruebe la conexión

Una vez que el cliente se reinicie y complete el inicio de sesión del navegador, emita una solicitud de solo lectura:

Lista de las áreas metropolitanas de Equinix Fabric.

Una lista de códigos de área metropolitana confirma que el servidor está conectado y que el token es válido. Un error de autorización indica que el inicio de sesión no se ha completado. Compruebe primero los registros de MCP del cliente.

Solución de problemas

Error de autenticación

El cliente no puede autenticarse o informa de un error de autorización cuando se conecta.

Compruebe que su cuenta de Equinix Customer Portal esté activa.
Elimine el servidor del cliente, añádelo de nuevo y complete el inicio de sesión del navegador.
Borre las credenciales almacenadas en caché del cliente si el cliente lo admite, reinicie el cliente e inicie sesión de nuevo.

El servidor no está respondiendo

El cliente no puede llegar al servidor o no hay ninguna herramienta en la lista.

Compruebe que el sistema puede llegar a https://mcp.equinix.com/fabric.
Compare la URL y el formato de archivo de configuración con los ejemplos de Configuración y configuración .
Reinicie el cliente para reinicializar la conexión.
Revise los registros del servidor MCP en el cliente para detectar el error específico.
Si el servidor se conecta pero solo aparecen algunas herramientas en la lista, consulte Límites de herramientas en su cliente.

Permiso denegado

Una llamada falla con un error de permiso o autorización.

Verifique los roles de la cuenta con la que ha iniciado sesión. Esta es la causa más común.
Compruebe el nivel de permiso seleccionado cuando se conectó. Un cliente conectado con fabricViewer no puede realizar operaciones de escritura, independientemente de los roles de la cuenta. Vuelva a conectar y seleccione fabricOperator o fabricManager si la operación lo requiere.
Compruebe que la cuenta tenga acceso al proyecto que contiene el recurso.
Si ha solicitado una operación de eliminación, tenga en cuenta que el servidor no publica ninguna herramienta de eliminación. Utilice el portal o el API.

Sesión caducada

Las llamadas que se han realizado correctamente anteriormente comienzan a producir errores de autenticación. Los clientes renuevan los tokens automáticamente, por lo que esta condición suele indicar que la autorización se ha revocado o no se ha podido renovar. Compruebe que el cliente aún se le concede en la sección Revisar y revocar el acceso.

Reinicie el cliente para activar un nuevo inicio de sesión.
Complete el flujo del navegador cuando se le solicite.
Si la condición persiste, elimine la configuración del servidor y añádala de nuevo.

Limitación de velocidad

El servidor está sujeto a los mismos límites de tarifa que Direct API Access. Reduzca la tasa de solicitudes o póngase en contacto con el servicio de atención al cliente de Equinix para revisar sus límites.

Recursos adicionales

Herramientas de Fabric - Las herramientas que publica este servidor.
Complemento de habilidades de Fabric - Las habilidades de Fabric y este servidor, instalados como un solo complemento.
Referencia de Fabric API - El API al que llaman las herramientas.
Referencia de roles y permisos de IAM: Las operaciones que permite cada rol.
Autenticación de API - Autenticación para acceso directo a API.
Especificación del protocolo contextual del modelo - La especificación del protocolo.

Clientes MCP compatibles​

Límites de herramientas en su cliente​

Requisitos previos​

Autenticación​

Ciclo de vida del token​

Instalación y configuración​

Escritorio de Claude​

Opción 1: Añadir a través de conectores (recomendado)​

Opción 2: Edite el archivo de configuración​

Código Claude​

Cursor​

Código Visual Studio​

CLI de Gemini​

OpenCode​

Codex​

Opción 1: Añadir a través de CLI (recomendado)​

Opción 2: Añada a través de Codex Desktop​

Opción 3: Edite el archivo de configuración​

Otros clientes de MCP​

Modelo de permisos​

Consideraciones sobre seguridad​

Revisar y revocar el acceso​

Compruebe la conexión​

Solución de problemas​

Error de autenticación​

El servidor no está respondiendo​

Permiso denegado​

Sesión caducada​

Limitación de velocidad​

Recursos adicionales​

Clientes MCP compatibles

Límites de herramientas en su cliente

Requisitos previos

Autenticación

Ciclo de vida del token

Instalación y configuración

Escritorio de Claude

Opción 1: Añadir a través de conectores (recomendado)

Opción 2: Edite el archivo de configuración

Código Claude

Cursor

Código Visual Studio

CLI de Gemini

OpenCode

Codex

Opción 1: Añadir a través de CLI (recomendado)

Opción 2: Añada a través de Codex Desktop

Opción 3: Edite el archivo de configuración

Otros clientes de MCP

Modelo de permisos

Consideraciones sobre seguridad

Revisar y revocar el acceso

Compruebe la conexión

Solución de problemas

Error de autenticación

El servidor no está respondiendo

Permiso denegado

Sesión caducada

Limitación de velocidad

Recursos adicionales