MCP 服务器概述

Fabric MCP服务器允许人工智能助理和开发人员工具代表您呼叫Equinix Fabric API。模型上下文协议(MCP)是将这些工具连接到外部服务的开放式协议。MCP客户端可以搜索和修改您的Fabric资源，无需您编写API代码。

公开预览

Fabric MCP服务器处于公开预览状态。工具，描述和响应格式可能在正式上线之前更改。

有关MCP服务器的反馈，疑问或帮助，请发送电子邮件至fabric-intelligence-support@equinix.com。

服务器URL	工具	描述
`https://mcp.equinix.com/fabric`	Fabric工具	连接，端口，云路由器，路由，服务配置文件，和遥测。

安装为插件

Claude Code和Claude Desktop可以一步安装此服务器和Equinix Fabric技能，无需服务器配置。技能告诉客户每个Fabric操作接受的筛选条件和值。如需了解更多信息, 请参阅Fabric Skills插件。

支持的 MCP 客户

支持以下客户端：

Claude Desktop, Anthropic的桌面应用程序
Claude Code, 人类的终端代理
Cursor, AI代码编辑器
Visual Studio代码, 通过GitHub Copilot
Codex，通过CLI或桌面应用程序
Gemini CLI, 谷歌的终端代理
OpenCode, 开源终端代理

其他MCP客户端支持具有OAuth的远程服务器，但它们尚未经过测试。有关详细信息，请参阅其他MCP客户端。

客户中的工具限制

Fabric MCP服务器发布了100多种工具。某些客户端限制模型一次可加载的工具数量。Visual Studio代码允许在所有来源中使用128个工具，Windsurf允许使用100个工具。同时运行多台MCP服务器可能会超出这些限制，从而导致请求失败或遗漏工具，恕不另行通知。

如果您达到客户端工具数量上限，请禁用您未使用的MCP服务器。某些客户端是按需加载工具定义，而不是一次性加载，从而避免了这一限制。

先决条件

具有Fabric访问权限的Equinix Customer Portal账户
支持具有OAuth的远程MCP服务器的MCP客户端

不需要其他软件。没有要安装的软件包，也没有要生成的令牌。您的客户在浏览器中完成登录。

验证

服务器使用OAuth 2.1，并支持动态客户端注册(DCR)和客户端ID元数据文档(CIMD)。您的客户使用其采用的任何方法。大多数客户端目前使用DCR。Visual Studio代码还支持CIMD。

将服务器URL添加到客户机配置中，如设置和配置中所述。
客户端检测到它没有令牌，并提示您进行连接。
**浏览器窗口随即打开。**使用您的Equinix Customer Portal凭据登录。
在审批屏幕上选择权限级别，然后批准请求。有关详细信息，请参阅权限模型。
客户端存储令牌并在后台刷新。

每个客户完成此流程一次。会话将保持有效，直至过期或您撤销。

代币生命周期

访问令牌的有效期较短，并绑定到您授权其使用的服务器。使用客户ID元数据文档注册的客户也会收到轮换刷新令牌并在后台续订，因此很少提示您登录。通过浏览器流程更新DCR注册的客户端，因此他们会更频繁地提示您登录。

如果会话过期或您将其撤销，客户端会提示您再次登录。

设置和配置

每个客户端都遵循相同的三个步骤：添加服务器URL，保存配置并重新启动客户端。文件位置和配置格式不同。Fabric服务器URL为https://mcp.equinix.com/fabric。

Claude Desktop

您可以通过连接器页面或通过编辑配置文件来添加服务器。将这两种方法记录在使用远程MCP的自定义集成中。

选项1：添加VIA连接器(推荐)

打开Claude Desktop并点击您的个人资料菜单，然后点击设置。
在设置侧栏中，单击连接器。
单击添加自定义连接器。
输入名称(例如Fabric MCP)并将远程MCP服务器URL设置为https://mcp.equinix.com/fabric，然后单击添加。
单击新连接器旁边的连接。浏览器窗口随即打开，您可在其中使用Equinix Customer Portal凭据进行身份验证。

如果会话已过期，连接器将显示“连接已过期”。单击连接以再次登录。

选项2：编辑配置文件

配置文件位置：

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
窗口：%APPDATA%\Claude\claude_desktop_config.json

您也可以从设置> Developer >编辑Claude Desktop内的配置中打开配置文件。

Fabric MCP 服务器示例：

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

保存文件并重启Claude Desktop。浏览器登录信息在您首次使用Fabric工具时打开。

代码

从命令行添加服务器：

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

将服务器添加-s user到命令中，以使服务器可用于每个项目，而非仅用于当前项目。

然后进行身份验证：

/mcp

从列表中选择fabric-mcp并完成浏览器登录。此屏幕还会显示连接状态，以区分过期会话与配置错误。

您也可以直接编辑配置文件。流入~/.claude.json：

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

光标

光标从JSON文件读取MCP服务器。有关详细信息，请参阅光标MCP文档。

配置文件位置：

项目级：.cursor/mcp.json在项目根目录中
全球：~/.cursor/mcp.json

您也可以通过光标设置>工具和MCP >新建MCP服务器添加服务器。

Fabric MCP 服务器示例：

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

重新启动光标。光标在首次连接时提示您登录。

Visual Studio代码

Visual Studio代码将MCP服务器存储在mcp.json。有关全套选项，请参阅Visual Studio代码MCP文档。

配置文件位置：

macOS/Linux：.vscode/mcp.json(工作区)或~/.vscode/mcp.json(用户)
窗口：.vscode\mcp.json(工作区)或%USERPROFILE%\.vscode\mcp.json(用户)

Fabric MCP 服务器示例：

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

重新启动Visual Studio代码，或重新加载窗口(macOS上为Cmd+Shift+P，Windows和Linux上为Ctrl+Shift+P，然后为Developer: 重新加载窗口)。浏览器登录信息在首次使用时打开。

Gemini CLI

Gemini CLI从读取MCP服务器settings.json。有关更多信息，请参阅Gemini CLI MCP文档。

配置文件位置：

全球：~/.gemini/settings.json
项目级：.gemini/settings.json

Fabric MCP服务器示例。此客户端需要httpUrl密钥，而非url：

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

重新启动Gemini CLI，然后进行身份验证：

/mcp auth fabric-mcp

此命令将打开浏览器并监听http://localhost:7777/oauth/callback，因此在装有浏览器的系统上运行。在没有浏览器转发的情况下，SSH会话无法正常工作。在不带参数的情况下运行/mcp auth，列出仍需要登录的服务器。

OpenCode

OpenCode将MCP服务器存储在其配置文件中的密钥下mcp。有关详细信息，请参阅OpenCode MCP文档。

配置文件位置：

项目级：opencode.json在项目根目录中
全球：~/.config/opencode/opencode.json

Fabric MCP 服务器示例：

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

OpenCode在首次使用服务器时运行OAuth流。您也可以手动启动流程：

opencode mcp auth fabric-mcp

法典

您可以通过CLI，桌面应用程序或配置文件添加服务器。

选项1：通过CLI添加(推荐)

使用Codex CLI设置说明文件安装Codex CLI。

使用以下命令添加MCP服务器：

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

运行login命令：
```
codex mcp login fabric-mcp
```
浏览器窗口随即打开，您可在其中使用Equinix Customer Portal凭据进行身份验证。

选项2：通过Codex桌面添加

打开Codex桌面。
前往设置。
在设置侧栏中，单击MCP服务器。
单击添加服务器。
输入名称(例如Fabric MCP)，选择可流式HTTP作为类型，将URL设置为，https://mcp.equinix.com/fabric然后单击保存。
添加服务器后，从终端运行login命令：
```
codex mcp login fabric-mcp
```
浏览器窗口随即打开，您可在其中使用Equinix Customer Portal凭据进行身份验证。

选项3：编辑配置文件

配置文件位置：

~/.codex/config.toml(用户级)
.codex/config.toml(项目级)

Fabric MCP 服务器示例：

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

保存文件并重新启动Codex桌面，然后在出现提示时登录。

其他MCP客户

以客户端要求远程MCP服务器的格式添加https://mcp.equinix.com/fabric。客户处理OAuth流。未在支持的MCP客户端中列出的客户端未经过测试。未经测试的客户端连接失败，请在提出支持请求之前，先核实服务器是否有受支持的客户端。

权限模型

Fabric MCP服务器将Fabric API称为登录用户。在审核日志中，每个呼叫都归属于该用户，其方式与直接API呼叫相同。服务器无法执行用户账户未获准执行的任何操作。

已连接客户端可以调用以下两个控件：

**账户角色。**分配给您的Equinix Customer Portal账户的角色设置了最大访问权限级别。通过MCP连接不会增加IT。
**权限级别。**客户端连接时，请在审批屏幕上选择权限级别。以下级别可用：

权限级别	描述
`fabricViewer`	只读访问权限。搜索和查找，例如`searchNetworks`或`getNetworkByUuid`。
`fabricOperator`	查看器访问权限，以及修改现有资源以及关联或分离操作，如`updateNetwork`。
`fabricManager`	操作员访问权限，以及创建资源，如`createNetwork`或`createRouter`。

签发的令牌授予两个控件的交叉点。账户角色下方的权限级别会限制客户端。账户角色以上的权限级别不会授予额外的访问权限。

使用涵盖工作的最窄权限级别。配置仅回答有关库存问题的代理时，fabricViewer权限级别是适当的。配置此权限级别的客户端无法更改资源，即使该用户拥有管理权限。

任一控件都可以拒绝呼叫。授权错误最常见的原因是账户中缺少角色，而非限制性权限级别，因此请先核实账户角色。

权限级别不授予删除访问权限。服务器不发布删除工具，因此无法通过MCP服务器删除连接，端口，云路由器和网络。在门户网站中或通过API删除这些资源。

安全考量

在连接客户端之前，请查阅以下内容。

**确认写入操作。**在MCP客户端中为任何创建或更新资源的工具启用工具确认。默认情况下，大多数客户端会进行提示，但要验证设置，因为某些创建操作会立即产生费用。通过代理订购端口或云路由器的费用与在门户中订购端口或云路由器的费用相同。
**仅连接受信任客户端。**任何MCP客户端都可以向Equinix发起身份验证请求。批准请求将授予应用程序在会话期间访问您的账户的权限。确认请求源自您安装和配置的应用程序，并拒绝来自链接或未识别应用程序的任何请求。支持客户ID元数据文档的客户会使用以稳定网址发布的文档自行自我识别，这是比单纯动态注册更有力的身份指标。在任何一种情况下，审批决定均由您自行决定。
**将工具输出视为不受信任的输入。**工具响应包括用户定义的文本，例如连接名称，项目名称和标记。类似于指令的资源可能导致业务代表呼叫您未请求的工具。为编写工具启用确认功能，并在运行Fabric MCP服务器和检索不受信任内容的服务器(如网页浏览器或电子邮件客户端)之前评估风险。
**了解您的数据发送位置。**您的提示及其生成的工具响应将通过MCP客户端使用的模型传递，具体取决于该供应商的条款。服务器返回的任何数据(包括连接名称，端口清单和遥测)都将成为该对话的一部分。如果贵组织限制基础设施数据的发送位置，请在连接前检查客户端及其基础模型。Equinix记录服务器代表您发起的API呼叫，其方式与来自您账户的任何其他API流量相同。

要撤销不再识别的客户端的访问权限，请参阅查看和撤销访问权限。

查看和撤销访问权限

您授权的每位客户都将显示在您的Equinix用户账户中的AI同意管理之下，可通过“用户账户>访问权限>人工智能同意管理”访问。名单中列出了每位客户的姓名，包括其是否仍然获得同意，您授权的时间以及上次致电Equinix的时间。

使用此页面确定哪些代理当前可以访问您的Fabric账户，哪些代理处于非活动状态。单击一行上的“撤销”以结束该客户的访问权限，或选择多行并一起撤销。

设备丢失，不再使用之前测试的客户端，或上次活动日期与您自己的使用情况不符时，撤销访问权限。

将服务器移出客户端配置不会撤销访问权限。该更改会阻止本地客户端调用服务器，但在您撤销之前，授权将保持活动状态。

important

MCP服务器不会绕过任何权限或账户要求。如果直接API呼叫因缺失权限或账户状态无效而被拒绝，MCP呼叫也会被拒绝。

验证连接

客户端重启并完成浏览器登录后，发出只读请求：

列出Equinix Fabric都会区。

都会区代码列表确认服务器已连接且令牌有效。授权错误表示登录未完成。先检查客户端的MCP日志。

故障排除

验证失败

客户端无法进行身份验证，或在连接时报告授权错误。

验证您的Equinix Customer Portal账户已激活。
将服务器从客户端中移除，再次添加，然后完成浏览器登录。
清除客户端的缓存凭据(如果客户端支持)，然后重启客户端并再次登录。

服务器未响应

客户端无法到达服务器，或未列出任何工具。

验证系统是否可以访问https://mcp.equinix.com/fabric。
将URL和配置文件格式与设置和配置中的示例进行比较。
重新启动客户端以重新初始化连接。
在客户端中查看MCP服务器日志，以查找特定错误。
如果服务器已连接，但仅列出部分工具，请参阅客户端中的工具限制。

权限被拒绝

呼叫失败并出现权限或授权错误。

验证您登录账户的角色。这是最常见的原因。
验证您在连接时选择的权限级别。与关联的客户端fabricViewer无法执行写入操作，无论账户的角色如何。重新连接并选择fabricOperator或fabricManager(如果操作需要)。
验证账户是否有权访问包含该资源的项目。
如果您请求删除操作，请注意服务器不会发布删除工具。使用门户网站或API。

会话已过期

先前成功的调用开始失败，并出现身份验证错误。客户端会自动续订令牌，因此这种情况通常表示授权已撤销或无法续订。在“审核与撤销访问权限”中验证客户端是否仍获得授权。

重新启动客户端以触发新登录。
出现提示时，完成浏览器流程。
如果这种情况仍然存在，请移除服务器配置并再次添加。

速率限制

服务器受与直接API访问相同的速率限制。降低请求率，或联系Equinix客户支持以查看您的限制。

额外资源

Fabric Tools -此服务器发布的工具。
Fabric Skills插件- Fabric Skills和此服务器，作为一个插件安装。
Fabric API参考-工具调用的API。
IAM角色和权限参考-每个角色允许的操作。
API验证-直接API访问的验证。
Model Context Protocol Specification (模型上下文协议规范)—协议规范。

支持的 MCP 客户​

客户中的工具限制​

先决条件​

验证​

代币生命周期​

设置和配置​

Claude Desktop​

选项1：添加VIA连接器(推荐)​

选项2：编辑配置文件​

代码​

光标​

Visual Studio代码​

Gemini CLI​

OpenCode​

法典​

选项1：通过CLI添加(推荐)​

选项2：通过Codex桌面添加​

选项3：编辑配置文件​

其他MCP客户​

权限模型​

安全考量​

查看和撤销访问权限​

验证连接​

故障排除​

验证失败​

服务器未响应​

权限被拒绝​

会话已过期​

速率限制​

额外资源​

支持的 MCP 客户

客户中的工具限制

先决条件

验证

代币生命周期

设置和配置

Claude Desktop

选项1：添加VIA连接器(推荐)

选项2：编辑配置文件

代码

光标

Visual Studio代码

Gemini CLI

OpenCode

法典

选项1：通过CLI添加(推荐)

选项2：通过Codex桌面添加

选项3：编辑配置文件

其他MCP客户

权限模型

安全考量

查看和撤销访问权限

验证连接

故障排除

验证失败

服务器未响应

权限被拒绝

会话已过期

速率限制

额外资源