# Fabric Skillsプラグイン

Equinix Fabric Skillsプラグインは、FabricスキルとFabric MCPサーバーを1つのステップでインストールします。マーケットプレイスをクライアントに追加し、プラグインをインストールしてログインします。その後、クライアントにFabricインベントリの検索、接続の作成と更新、Fabricネットワークの管理、またはFabric Cloud Routerの設定を依頼できます。

スキルは、タスクを正しく実行する方法をクライアントに伝える指示ファイルです。ファブリックスキルは、インベントリ検索に適用するフィルタを定義します。これには、クライアントが作成する前に必要な接続リクエストの詳細、Fabric Cloud Routerパッケージが受け入れる値、ステップの実行順序が定義されます。それらがなければ、顧客はツールを持っているが、手順は持っていない。プラグインにはFabric MCPサーバ定義も含まれるため、サーバを個別に設定することはできません。

プラグインは、[Equinix](https://github.com/equinix/equinix-agent-plugins)上の[github-agent-plugins](https://github.com/equinix/equinix-agent-plugins)リポジトリで公開されています。そのリポジトリはプラグインマーケットプレイスです。マーケットプレイスを一度追加してから、そこから必要なプラグインをインストールします。

> **パブリックプレビュー**
>
> Fabric MCPサーバはパブリックプレビュー中です。ツール、説明、回答形式は、一般に提供される前に変更される場合があります。
>
> プラグインに関するフィードバック、質問、サポートが必要な場合は、<fabric-intelligence-support@equinix.com>までメールでお問い合わせください。

## プラグインの内容[​](#プラグインの内容 "への直接リンクプラグインの内容")

マーケットプレイスは`equinix-fabric`4つのスキルを含む1つのプラグインを公開しています。

| スキル                     | お客様に依頼できること                                                                                                                                                                                               |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `show-fabric-inventory`    | 接続、ポート、Fabric Cloud Router、サービストークン、ルートフィルター、ルートアグリゲーション、およびEquinix Precision Timeサービス。都市圏、プロジェクト、状態、帯域幅、タイプ、または名前。                        |
| `manage-fabric-connection` | EVPL、EPL、IP、インターネットアクセス、インターネットアクセスなど、Fabric接続の作成、更新、再試行およびEVP- LANまたはEP- LAN仮想接続。作成する前に接続を検証し、名前、帯域幅、または通知メールアドレスを更新します。 |
| `manage-fabric-network`    | EVP-Tree、EVP-Tree、EP-Tree、EP-Treeの各タイプのファブリックネットワークの計画、作成、検索、比較、更新（ポートの互換性チェックを含むLAN LAN）                                                                        |
| `manage-cloud-router`      | Fabric Cloud Routerの作成と更新。IPv4およびIPv6用にBGPを設定します。ルートフィルター、ルートフィルタールール、ルートアグリゲーション、ルートアグリゲーションルールを作成、追加、更新します。                         |

プラグインはFabric MCPサーバをにバンドルし、`https://mcp.equinix.com/fabric`という名前でクライアントに登録します。`equinix-fabric`サーバが公開するツールと、それぞれに必要なアクセスレベルについては、「[Fabric Tools」を](https://docs.equinix.com/ja/equinix-api/mcp-servers/fabric-mcp-server.md)参照してください。

## 前提条件[​](#前提条件 "への直接リンク前提条件")

* クライアントに使用させたいFabricリソースにアクセスできるEquinix Customer Portalアカウント。クライアントは、ログインしてそのユーザーの権限を継承するユーザーとして機能します。
* プラグインマーケットプレイスを読むクライアント。クロードコードとクロードデスクトップは対応しています。他のすべてのクライアントについては、[他のクライアントにインストールを](#install-in-other-clients)参照してください。
* およびへのネットワークアクセス。`https://mcp.equinix.com``https://github.com`

アクセストークンは必要ありません。クライアントは、サーバーを初めて呼び出したときにブラウザログインを完了します。詳細については、[認証を](https://docs.equinix.com/ja/equinix-api/mcp-servers/overview.md#authentication)参照してください。

## クロードコードでインストール[​](#クロードコードでインストール "への直接リンククロードコードでインストール")

1. マーケットプレイスを追加します。

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

2. プラグインをインストールします。

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

   インタラクティブセッションで実行し、マーケットプレイスから`equinix-agent-plugins`選択すること`equinix-fabric`もできます。`/plugin`

3. 認証します。を実行し`/mcp`、を選択して、`equinix-fabric`ブラウザログインを完了します。

4. プラグインがインストールされ、サーバーが接続されていることを確認してください。

   ```
   claude plugin list
   ```

   ```
   claude mcp list
   ```

## Claudeデスクトップにインストール[​](#claudeデスクトップにインストール "への直接リンクClaudeデスクトップにインストール")

1. **\[設定]>\[カスタマイズ]に**移動し、\[プラグイン]を選択します。\*\*\*\*

2. **\[マーケットプレイスを追加]を**選択します。

3. リポジトリアドレスを入力して確認します。

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

4. マーケットプレイスが同期するのを待ちます。クロード・デスクトップはリポジトリからマーケットプレイスのインデックスを読み取り、宣言したプラグインを一覧表示します。新しいプラグインやバージョンを入手する場合は、マーケットプレイスエントリで\[**同期]を**選択します。

5. リストから**Equinixファブリックを**見つけ、**インストールを**選択して、トグルが有効になっていることを確認します。

6. 認証します。**\[設定]>\[コネクタ]に**移動し、**Equinixファブリックを**見つけてブラウザログインを完了します。このスキルは、サーバーが接続された後にのみ機能します。

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は市場からスキルをインストールします。Fabric MCPサーバを個別に追加します。

1. Codexで、\[**プラグイン]>\[追加]>\[マーケットプレイスを追加]の順に**移動します。

2. リポジトリアドレスを入力し、マーケットプレイスを追加します。

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

3. 個人のスペースで、**Equinixファブリックを**選択してインストールします。

4. Fabric MCPサーバを追加します。

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

5. 新しいセッションを開始し、Codexがサーバーを初めて呼び出したときにブラウザログインを完了します。

## 他のクライアントにインストール[​](#他のクライアントにインストール "への直接リンク他のクライアントにインストール")

カーソル、Visual Studioコード、ジェミニCLI、OpenCodeなどのクライアントの場合は、サーバーとスキルを個別に追加します。

1. 「[セットアップと構成」](https://docs.equinix.com/ja/equinix-api/mcp-servers/overview.md#setup-and-configuration)のクライアントの指示に従って、Fabric MCPサーバを追加します。

2. スキルを追加します。リポジトリを複製し、クライアントのスキルローダーをスキルディレクトリに移動するか、ファイルの内容をクライアントの指示に貼り付けます。`SKILL.md`

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

   スキルはディレクトリ内のプレーンMarkdownファイルである。`fabric-agent-plugins/skills/`各スキルには、ファイルを含む独自のフォルダがあり、一`SKILL.md`部のスキルでは、`references`補足手順が記載されたフォルダが含まれています。

## 設置の確認[​](#設置の確認 "への直接リンク設置の確認")

セッションを開始し、次のようなリクエストを入力します。

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

クライアントがFabric MCPサーバを呼び出し、Equinixユーザーが表示できる接続を返します。ツールを呼び出さずに応答した場合、サーバーは接続されていません。詳細については、[トラブルシューティングを](#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 plugin marketplace update equinix-agent-plugins
```

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

プラグインを削除するには、次のコマンドを実行します。

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

クロード・デスクトップで、マーケットプレイスエントリで**同期を**選択し、プラグインで**更新を**選択します。プラグインを削除するには、［**アンインストール］を**選択します。マーケットプレイスとすべてのプラグインを削除するには、\[**マーケットプレイスを削除]を**選択します。

## 権限と承認[​](#権限と承認 "への直接リンク権限と承認")

プラグインは、Equinixアカウントでできることを変更しません。クライアントはログインしたユーザーとして機能し、クライアントが保持するトークンは、そのユーザーの役割と接続時に選択された権限レベルの共通部分を付与します。詳細については、「[権限モデル」を](https://docs.equinix.com/ja/equinix-api/mcp-servers/overview.md#permissions-model)参照してください。

以下のポイントは、スキルに固有のものです。

* リソースを作成または更新するツール呼び出しのためのクライアントの確認プロンプトを有効にします。`manage-fabric-connection`、`manage-fabric-network`、および`manage-cloud-router`のスキルはFabricリソースを作成および変更し、それらのリソースの一部は請求されます。
* サーバは削除ツールを発行しないため、接続、ファブリックネットワーク、またはFabric Cloud Routerリソースの削除リクエストは失敗します。リソースを削除するには、Equinix Customer PortalまたはFabric APIを使用します。

## トラブルシューティング[​](#トラブルシューティング "への直接リンクトラブルシューティング")

認証、接続、および権限のエラーについては、「MCPサーバーの概要」の[トラブルシューティングを](https://docs.equinix.com/ja/equinix-api/mcp-servers/overview.md#troubleshooting)参照してください。以下の問題はプラグイン固有のものです。

### マーケットプレイスの同期に失敗する[​](#マーケットプレイスの同期に失敗する "への直接リンクマーケットプレイスの同期に失敗する")

\*\*問題：\*\*お客様はマーケットプレイスを追加または更新できません。`equinix-agent-plugins`

**ソリューション：**ネットワークでへのアクセスが許可されていることを確認してください。`https://github.com`住所がと正確に入力されていることを確認してください。`https://github.com/equinix/equinix-agent-plugins`次に、マーケットプレイスエントリで**同期を**選択するか、を実行します。`claude plugin marketplace update equinix-agent-plugins`

### プラグインはインストールされていますが、クライアントにFabricツールがありません[​](#プラグインはインストールされていますがクライアントにfabricツールがありません "への直接リンクプラグインはインストールされていますが、クライアントにFabricツールがありません")

\*\*問題：\*\*お客様のクライアントはリクエストを認識したものの、Fabricツールがない、またはお客様のアカウントではなく一般的な知識から回答したと報告しています。

**ソリューション：**プラグインはインストールされていますが、サーバーが認証されていません。クロードコードで実行する`/mcp`か、クロードデスクトップで**\[設定]>\[コネクタ]に**移動し、を選択して`equinix-fabric`ブラウザログインを完了します。その後、新しいセッションを開始します。

### Fabric Serverが2回表示される[​](#fabric-serverが2回表示される "への直接リンクFabric Serverが2回表示される")

\*\*問題：\*\*クライアントはとの両方をリストするか`fabric-mcp``equinix-fabric`、各Fabricツールを2回表示します。

\*\*ソリューション：\*\*プラグインをインストールする前に、[セットアップと構成](https://docs.equinix.com/ja/equinix-api/mcp-servers/overview.md#setup-and-configuration)に従ってサーバーを手動で追加しました。プラグインは、という名前の独自のコピーを追加します。`equinix-fabric`手動入力を削除する。クロードコードで、を実行します。`claude mcp remove fabric-mcp`他のクライアントでは、クライアントのMCP設定からエントリを削除します。`fabric-mcp`

### クライアントから検索を絞り込むように求められた[​](#クライアントから検索を絞り込むように求められた "への直接リンククライアントから検索を絞り込むように求められた")

\*\*問題：\*\*あなたがインベントリを要求し、クライアントが結果を返すのではなく、都市圏、プロジェクト、またはリソースタイプを要求します。

\*\*ソリューション：\*\*この動作は意図的なものです。`show-fabric-inventory`スキルは、オープンエンドリクエストに対して少なくとも1つのフィルターを要求しています。などのフィルターを追加する`show me my ports in SV`か、などのすべてを明示的に要求します。`show me my full Fabric inventory`

## その他のリソース[​](#その他のリソース "への直接リンクその他のリソース")

* [MCPサーバーの概要](https://docs.equinix.com/ja/equinix-api/mcp-servers/overview.md)-サーバーのセットアップ、認証、権限、およびセキュリティ。
* [Fabric Tools](https://docs.equinix.com/ja/equinix-api/mcp-servers/fabric-mcp-server.md) -サーバが公開するツールと、それぞれに必要なアクセスレベル。
* [Fabric APIリファレンス](https://docs.equinix.com/ja/api-catalog/fabricv4.md)-ツールが呼ぶAPI。
* [Equinix agent-plugins](https://github.com/equinix/equinix-agent-plugins) -プラグインソース、スキル定義、コントリビューションガイダンス。