# Fabric Skills插件

Equinix Fabric Skills插件可在一个步骤中安装Fabric Skills和Fabric MCP服务器。将Marketplace添加到您的客户端，安装插件并登录。然后，您可以要求客户搜索您的Fabric清单，创建和更新连接，管理Fabric网络或配置Fabric Cloud Router。

技能是指导客户正确执行任务的说明文件。Fabric技能定义了哪些筛选器应用于库存搜索，详细说明客户端创建前的连接请求需求，Fabric Cloud Router软件包接受的值以及顺序运行步骤。没有它们，客户就拥有了工具，但没有程序。该插件还包含Fabric MCP服务器定义，因此您无需单独配置服务器。

该插件发布在[Equinix](https://github.com/equinix/equinix-agent-plugins)上的[gitHub-agent-plugins](https://github.com/equinix/equinix-agent-plugins)仓库中。该存储库是一个插件市场。只需添加一次Marketplace，然后安装所需的插件。

> **公开预览**
>
> Fabric MCP服务器处于公开预览状态。工具，描述和响应格式可能在正式上线之前更改。
>
> 如需反馈，疑问或有关插件的帮助，请发送电子邮件至<fabric-intelligence-support@equinix.com>。

## 插件包含什么内容[​](#插件包含什么内容 "直接链接至插件包含什么内容")

Marketplace发布了一个插件，`equinix-fabric`其中包含四个技能。

| 技能                       | 您可以要求客户做些什么                                                                                                                                 |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `show-fabric-inventory`    | 搜索并列出连接，端口，Fabric云路由器，服务令牌，路由筛选器，路由聚合和Equinix Precision Time服务。按都会区，项目，州，带宽，类型，或姓名。             |
| `manage-fabric-connection` | 创建，更新和重试Fabric连接，包括EVPL，EPL，IP，互联网接入，和EVP - LAN或EP - LAN虚拟连接。在创建连接前验证连接，并更新其名称，带宽或通知电子邮件地址。 |
| `manage-fabric-network`    | 规划，创建，查找，比较和更新类型为EVP- LAN，EVP-树，EP-Tree LAN和EP-Tree的Fabric网络，包括端口兼容性检查。                                             |
| `manage-cloud-router`      | 创建和更新Fabric云路由器。为IPv4和IPv6配置BGP。创建，关联和更新路由筛选器，路由筛选规则，路由聚合和路由聚合规则。                                      |

该插件将Fabric MCP服务器捆绑在一起`https://mcp.equinix.com/fabric`，并在您的客户端中以名称注册`equinix-fabric`。服务器公开的工具以及每个工具所需的访问权限级别，请参阅[Fabric工具](https://docs.equinix.com/zh-Hans/equinix-api/mcp-servers/fabric-mcp-server.md)。

## 先决条件[​](#先决条件 "直接链接至先决条件")

* Equinix Customer Portal账户，可访问您希望客户使用的Fabric资源。客户端充当登录并继承该用户权限的用户。
* 读取插件Marketplace的客户端。Claude Code和Claude Desktop Do。对于其他客户端，请参阅[在其他客户端中安装](#install-in-other-clients)。
* 对和`https://github.com`的网络访问权限`https://mcp.equinix.com`。

您不需要访问令牌。您的客户端在首次调用服务器时完成浏览器登录。有关更多信息，请参阅[身份验证](https://docs.equinix.com/zh-Hans/equinix-api/mcp-servers/overview.md#authentication)。

## 在Claude Code中安装[​](#在claude-code中安装 "直接链接至在Claude Code中安装")

1. 添加Marketplace。

   ```
   claude plugin marketplace add equinix/equinix-agent-plugins
   ```

2. 安装插件。

   ```
   claude plugin install equinix-fabric@equinix-agent-plugins
   ```

   您也可以在互动会话中跑步`/plugin`，并从`equinix-agent-plugins`Marketplace中选择`equinix-fabric`。

3. 验证。运行`/mcp`，选择`equinix-fabric`，然后完成浏览器登录。

4. 确认插件已安装且服务器已连接。

   ```
   claude plugin list
   ```

   ```
   claude mcp list
   ```

## 在Claude Desktop中安装[​](#在claude-desktop中安装 "直接链接至在Claude Desktop中安装")

1. 前往**设置>自定义**并选择**插件**。

2. 选择**添加Marketplace**。

3. 输入存储库地址并确认。

   ```
   https://github.com/equinix/equinix-agent-plugins
   ```

4. 等待Marketplace同步。Claude Desktop从存储库读取Marketplace索引并列出其声明的插件。获取新插件或版本时，请在Marketplace条目中选择**同步**。

5. 在列表中找到**Equinix Fabric**，选择**安装**，并确认其切换已启用。

6. 验证。前往**设置>连接器**，查找**Equinix Fabric**，并完成浏览器登录。技能仅在连接服务器后有效。

7. 启动新会话。

## 为团队安装[​](#为团队安装 "直接链接至为团队安装")

在项目中的每个人克隆项目资源库时，若要为其提供插件，请将以下内容提交到项目文件中`.claude/settings.json`。

```
{

  "extraKnownMarketplaces": {

    "equinix-agent-plugins": {

      "source": {

        "source": "github",

        "repo": "equinix/equinix-agent-plugins"

      }

    }

  },

  "enabledPlugins": {

    "equinix-fabric@equinix-agent-plugins": true

  }

}
```

每个用户仍然单独登录，每个用户的权限来自其自己的Equinix账户。

## 在Codex中安装[​](#在codex中安装 "直接链接至在Codex中安装")

Codex从Marketplace安装技能。单独添加Fabric MCP服务器。

1. 在Codex中，前往**插件>添加>添加Marketplace**。

2. 输入存储库地址并添加Marketplace。

   ```
   https://github.com/equinix/equinix-agent-plugins
   ```

3. 在您的个人空间中，选择**Equinix Fabric**并进行安装。

4. 添加Fabric MCP服务器。

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

5. Codex首次调用服务器时，启动新会话并完成浏览器登录。

## 在其他客户端中安装[​](#在其他客户端中安装 "直接链接至在其他客户端中安装")

对于Cursor，Visual Studio Code，Gemini CLI和OpenCode等客户端，请分别添加服务器和技能。

1. 添加Fabric MCP服务器，请按照[设置和配置](https://docs.equinix.com/zh-Hans/equinix-api/mcp-servers/overview.md#setup-and-configuration)中的客户端说明添加Fabric MCP服务器。

2. 添加技能。克隆存储库并将客户的技能加载工具指向Skills目录，或将文件内容粘贴`SKILL.md`到客户的说明中。

   ```
   git clone https://github.com/equinix/equinix-agent-plugins.git
   ```

   技能是目录中的普通Markdown文件`fabric-agent-plugins/skills/`。每个skill都有自己的文件夹，其中包含一个`SKILL.md`文件；对于某些skill，还有一个`references`包含辅助程序的文件夹。

## 验证安装[​](#验证安装 "直接链接至验证安装")

启动会话并输入如下请求：

```
Show me all my Fabric connections in SV.
```

客户端调用Fabric MCP服务器，并返回Equinix用户可以看到的连接。如果IT人员在未调用工具的情况下应答，则服务器未连接。更多信息，请参阅[故障排除](#troubleshooting)。

其他尝试请求：

* `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.`

## 更新或移除插件[​](#更新或移除插件 "直接链接至更新或移除插件")

在Claude Code中，在更新之前刷新Marketplace，以便客户看到最新版本。

```
claude plugin marketplace update equinix-agent-plugins
```

```
claude plugin update equinix-fabric@equinix-agent-plugins
```

要删除插件，请运行以下命令。

```
claude plugin uninstall equinix-fabric@equinix-agent-plugins
```

在Claude Desktop中，在Marketplace条目上选择**同步**，然后在插件上选择**更新**。要移除插件，请选择**卸载**。要移除Marketplace及其所有插件，请选择**移除Marketplace**。

## 权限和批准[​](#权限和批准 "直接链接至权限和批准")

插件不会改变您的Equinix账户的功能。客户端充当登录用户，其持有的令牌将授予该用户角色与连接时所选权限级别的交叉。有关详细信息，请参阅[权限模型](https://docs.equinix.com/zh-Hans/equinix-api/mcp-servers/overview.md#permissions-model)。

以下几点与技能相关：

* 为创建或更新资源的工具调用启用客户确认提示。`manage-fabric-connection`，`manage-fabric-network`和`manage-cloud-router`Skills创建和修改Fabric资源，其中部分资源已计费。
* 服务器不发布删除工具，因此删除连接，Fabric网络或Fabric Cloud Router资源的请求失败。要移除资源，请使用Equinix Customer Portal或Fabric API。

## 故障排除[​](#故障排除 "直接链接至故障排除")

有关身份验证，连接和权限错误，请参阅MCP服务器概述中的[故障排除](https://docs.equinix.com/zh-Hans/equinix-api/mcp-servers/overview.md#troubleshooting)。插件存在以下特定问题。

### Marketplace无法同步[​](#marketplace无法同步 "直接链接至Marketplace无法同步")

\*\*问题：\*\*您的客户无法添加或刷新`equinix-agent-plugins`Marketplace。

**解决方案：**确认您的网络允许访问`https://github.com`。检查您输入的地址是否与完全相同`https://github.com/equinix/equinix-agent-plugins`。然后在Marketplace条目上选择**同步**，或运行`claude plugin marketplace update equinix-agent-plugins`。

### 插件已安装，但客户端没有Fabric工具[​](#插件已安装但客户端没有fabric工具 "直接链接至插件已安装，但客户端没有Fabric工具")

\*\*问题：\*\*您的客户已识别该请求，但报告称其没有Fabric工具，或根据一般信息而非您的账户予以答复。

**解决方案：**插件已安装，但服务器未经验证。在Claude Code中运行`/mcp`，或前往**设置>连接器**，选择`equinix-fabric`，然后完成浏览器登录。然后开始新会话。

### Fabric服务器出现两次[​](#fabric服务器出现两次 "直接链接至Fabric服务器出现两次")

\*\*问题：\*\*您的客户同时列出`fabric-mcp`和`equinix-fabric`，或者两次显示每个Fabric工具。

\*\*解决方案：\*\*在安装插件之前，您按照[设置和配置](https://docs.equinix.com/zh-Hans/equinix-api/mcp-servers/overview.md#setup-and-configuration)手动添加了服务器。该插件会添加其自己的副本`equinix-fabric`，名为。删除手动条目。在Claude Code中，运行`claude mcp remove fabric-mcp`。在其他客户端中，请从客户端的MCP配置中删除该`fabric-mcp`条目。

### 客户要求您缩小搜索范围[​](#客户要求您缩小搜索范围 "直接链接至客户要求您缩小搜索范围")

\*\*问题：\*\*您要求提供库存，客户要求提供都会区，项目或资源类型，而不是返回结果。

\*\*解决方案：\*\*此行为出于故意。`show-fabric-inventory`Skill要求在开放式请求中至少输入一个筛选条件。添加筛选条件(如`show me my ports in SV`)，或明确要求输入所有内容，如`show me my full Fabric inventory`。

## 额外资源[​](#额外资源 "直接链接至额外资源")

* [MCP服务器概述](https://docs.equinix.com/zh-Hans/equinix-api/mcp-servers/overview.md)-服务器的设置，身份验证，权限和安全。
* [Fabric Tools](https://docs.equinix.com/zh-Hans/equinix-api/mcp-servers/fabric-mcp-server.md) -服务器发布的工具以及每个工具所需的访问权限级别。
* [Fabric API参考](https://docs.equinix.com/zh-Hans/api-catalog/fabricv4.md)-工具调用的API。
* [ns-agent-plugins](https://github.com/equinix/equinix-agent-plugins) -插件来源，技能定义和贡献指导[Equinix](https://github.com/equinix/equinix-agent-plugins)。