MCPサーバーの概要

Fabric MCPサーバーを使用すると、AIアシスタントや開発者ツールがお客様に代わってEquinix Fabric APIに電話することができます。モデルコンテキストプロトコル(MCP)は、これらのツールを外部サービスに接続するためのオープンプロトコルです。MCPクライアントは、APIコードを記述することなく、Fabricリソースを検索および変更できます。

パブリックプレビュー

Fabric MCPサーバはパブリックプレビュー中です。ツール、説明、回答形式は、一般に提供される前に変更される場合があります。

MCPサーバに関するフィードバック、質問、またはサポートが必要な場合は、fabric-intelligence-support@equinix.comまでメールでお問い合わせください。

サーバーURL	ツール	説明
`https://mcp.equinix.com/fabric`	ファブリックツール	接続、ポート、クラウドルーター、ルーティング、サービスプロファイル、テレメトリ

プラグインとしてインストール

クロードコードとクロードデスクトップは、サーバー構成なしで、Equinix Fabricスキルと一緒にこのサーバーをワンステップでインストールできます。このスキルは、各Fabricオペレーションが受け入れるフィルタと値をクライアントに伝えるものです。詳細については、Fabric Skillsプラグインを参照してください。

対応MCPクライアント

次のクライアントがサポートされています。

クロードデスクトップ、Anthropicのデスクトップアプリケーション
クロード・コード、Anthropicの端末エージェント
カーソル、AIコードエディタ
Visual Studioコード、GitHubコパイロットを介して
Codex（CLIまたはデスクトップアプリを使用）
Gemini CLI、Googleのターミナルエージェント
OpenCode、オープンソースの端末エージェント

OAuthを使用してリモートサーバをサポートする他のMCPクライアントは動作する可能性がありますが、テストされていません。詳細については、「他のMCPクライアント」を参照してください。

クライアントのツール制限

Fabric MCPサーバは100以上のツールを公開しています。一部のクライアントでは、モデルが一度にロードできるツールの数を制限しています。Visual Studioコードでは、全てのソースで最大128個のツールを使用でき、ウインドサーフィンでは100個のツールを使用できます。複数のMCPサーバを同時に実行すると、これらの制限を超える可能性があり、リクエストが失敗したり、ツールが予告なく省略されたりする可能性があります。

クライアントツールの上限に達した場合は、使用していないMCPサーバを無効にします。一部のクライアントは、一度にツール定義をロードするのではなく、オンデマンドでツール定義をロードするため、制限が回避されます。

前提条件

Fabricアクセス権を持つEquinix Customer Portalアカウント
OAuthを使用してリモートMCPサーバをサポートするMCPクライアント

追加のソフトウェアは必要ありません。インストールするパッケージも生成するトークンもありません。クライアントはブラウザでログインを完了します。

認証

サーバーはOAuth 2.1を使用し、動的クライアント登録(DCR)とクライアントIDメタデータドキュメント(CIMD)の両方をサポートしています。クライアントは、実装されているいずれかの方法を使用します。ほとんどのクライアントは現在DCRを使用しています。Visual StudioコードはCIMDもサポートしています。

「セットアップと構成」の説明に従って、クライアントの構成にサーバーURLを追加します。
**クライアントはトークンがないことを検出し、**接続するように求めます。
**ブラウザウィンドウが開きます。**Equinix Customer Portalの認証情報でログインします。
承認画面**で権限レベルを選択し、**リクエストを承認します。詳細については、「権限モデル」を参照してください。
**クライアントはトークンを保存し、**バックグラウンドで更新します。

このプロセスは、クライアントごとに1回完了してください。セッションは、有効期限が切れるか、取り消すまで有効です。

トークンのライフサイクル

アクセストークンは短命であり、認証したサーバーにバインドされます。クライアントIDメタデータドキュメントに登録されたクライアントには、更新トークンがローテーションで送信され、バックグラウンドで更新されるため、ログインを求められることはほとんどありません。DCRを介して登録されたクライアントはブラウザフローを介して更新されるため、より頻繁にログインするように求められます。

セッションの有効期限が切れた場合、またはセッションを取り消すと、クライアントから再度ログインするよう求められます。

セットアップと構成

すべてのクライアントは、サーバーURLの追加、設定の保存、クライアントの再起動の3つの手順と同じです。ファイルの場所と構成形式のみが異なります。FabricサーバーのURLはです。https://mcp.equinix.com/fabric

クロードデスクトップ

サーバーを追加するには、[コネクタ]ページを使用するか、構成ファイルを編集します。Anthropicは、リモートMCPを使用したカスタムインテグレーションで両方の方法を文書化しています。

オプション1：ビアコネクタの追加（推奨）

クロード・デスクトップを開き、プロフィールメニューの「設定」をクリックします。
[設定]サイドバーで、[コネクタ]をクリックします。
カスタムコネクターを追加をクリックする。
名前（など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

構成ファイルは、クロードデスクトップ内の「**設定」>「開発者」>「構成を編集」**から開くこともできます。

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コードを再起動するか、ウィンドウをリロードしてください(Mac OSではCmd+Shift+P、WindowsおよびLinuxではCtrl+Shift+Pを押してから、開発者：ウィンドウリロード）。最初に使用すると、ブラウザのログインが開きます。

ジェミニCLI

Gemini CLIはからMCPサーバーを読み込む。settings.json詳細については、Gemini CLI MCPのドキュメントを参照してください。

構成ファイルの場所：

グローバル：~/.gemini/settings.json
プロジェクトレベル：.gemini/settings.json

ファブリックMCPサーバの例このクライアントには、url以下のキーではなく、キーが必要です。httpUrl

{
  "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は、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呼び出しと同様に、監査ログ内のそのユーザーに帰属されます。サーバーは、ユーザーのアカウントにまだ実行が許可されていない操作を実行できません。

接続されたクライアントが何を呼び出すかを決定する2つのコントロール：

**アカウントの役割。**Equinix Customer Portalアカウントに割り当てられた役割により、最大アクセスレベルが設定されます。MCPを介して接続しても増加しません。
**権限レベル。**クライアントが接続する際に、承認画面で権限レベルを選択します。以下のレベルが利用可能です。

権限レベル	説明
`fabricViewer`	読み取り専用アクセス。やなどの検索とルックアップ。searchNetworks``getNetworkByUuid
`fabricOperator`	ビューアアクセス、および既存のリソースの変更、およびなどの接続または切り離し操作。`updateNetwork`
`fabricManager`	オペレータのアクセス権に加え、やなどのリソースの作成も可能です。createNetwork``createRouter

発行されたトークンは、2つのコントロールの共通部分を付与します。アカウントの役割より低い権限レベルでは、クライアントが制限されます。アカウントの役割を超える権限レベルでは、追加のアクセス権は付与されません。

作業をカバーする最も狭い権限レベルを使用してください。インベントリに関する質問にのみ回答するエージェントを設定する場合は、fabricViewer権限レベルが適切です。この権限レベルで設定されたクライアントは、ユーザーが管理者権限を持っていても、リソースを変更できません。

いずれかのコントロールで通話を拒否できます。承認エラーは、制限された権限レベルではなく、アカウントの役割がないことが原因で発生することが多いため、最初にアカウントの役割を確認してください。

削除アクセス権を付与する権限レベルがありません。サーバーは削除ツールを公開しないため、MCPサーバーを介して接続、ポート、クラウドルーター、ネットワークを削除することはできません。ポータルまたはAPIからこれらのリソースを削除します。

セキュリティ

クライアントを接続する前に、以下を確認してください。

**書き込み操作を確認します。**リソースを作成または更新するツールについて、MCPクライアントでツール確認を有効にします。多くのクライアントはデフォルトでプロンプトを表示しますが、一部の作成操作では直ちに料金が発生するため、設定を確認してください。エージェントを介したポートまたはクラウドルーターの発注は、ポータルでの発注と同じレートで請求されます。
**信頼できるクライアントのみを接続します。**どのMCPクライアントでも、Equinixへの認証要求を開始できます。リクエストを承認すると、セッションの期間中、そのアプリケーションにお客様のアカウントへのアクセス権が付与されます。リクエストがインストールして設定したアプリケーションから送信されたことを確認し、リンクまたは認識できないアプリケーションから送信されたリクエストはすべて拒否します。クライアントIDメタデータドキュメントをサポートするクライアントは、安定したURLで公開されたドキュメントで自身を識別します。これは、動的登録のみよりもIDの指標として優れています。いずれの場合も、承認の決定はお客様のものとします。
**ツール出力を信頼できない入力として扱います。**ツールの応答には、接続名、プロジェクト名、タグなどのユーザー定義テキストが含まれます。指示に似た名前のリソースがあると、エージェントがリクエストしていないツールに電話する可能性があります。書き込みツールの確認を有効にし、Webブラウザや電子メールクライアントなどの信頼できないコンテンツを取得するサーバと並行してFabric MCPサーバを実行する前に、リスクを評価してください。
**データが送信される場所を把握する。**プロンプトとそれらが生成するツールの応答は、MCPクライアントが使用するモデルを通過し、そのベンダーの条件に従うものとします。接続名、ポートインベントリ、テレメトリなど、サーバーが返すデータはすべて、その会話の一部になります。組織がインフラストラクチャデータの送信先を制限している場合は、接続する前にクライアントとその基盤モデルを確認してください。Equinixは、お客様のアカウントからの他のAPIトラフィックと同様に、サーバーがお客様に代わって行うAPI呼び出しを記録します。

認識しなくなったクライアントのアクセス権を取り消すには、「アクセス権の確認と取り消し」を参照してください。

アクセス権の確認と取り消し

承認したすべてのクライアントは、EquinixユーザーアカウントのAI同意管理の下に表示され、ユーザーアカウント>アクセス> AI同意管理からアクセスできます。リストには、各クライアントの名前、同意がまだ付与されているかどうか、承認した日時、最後にEquinixを呼び出した日時が記載されています。

このページを使用して、現在Fabricアカウントにアクセスできるエージェントと、非アクティブなエージェントを特定します。1行の[取り消す]をクリックしてそのクライアントのアクセスを終了するか、複数の行を選択してまとめて取り消すことができます。

デバイスを紛失した場合、以前にテストしたクライアントを使用しなくなった場合、または最終アクティビティ日がお客様の使用状況と一致しない場合は、アクセス権を取り消す。

クライアントの構成からサーバーを削除しても、アクセス権は取り消されません。この変更により、ローカルクライアントからサーバーへの呼び出しが停止されますが、ユーザーが取り消すまで認証は有効なままです。

important

MCPサーバは、権限またはアカウント要件をバイパスしません。権限がないか、アカウントの状態が無効であるために直接API呼び出しが拒否される場合、MCP呼び出しも拒否されます。

接続を確認する

クライアントが再起動し、ブラウザログインが完了したら、読み取り専用リクエストを発行します。

Equinix Fabricの都市圏を一覧表示する。

都市圏コードのリストは、サーバーが接続されており、トークンが有効であることを確認します。認証エラーは、ログインが完了しなかったことを示します。最初にクライアントのMCPログを確認してください。

トラブルシューティング

認証失敗

クライアントが認証できないか、接続時に承認エラーが報告されます。

Equinix Customer Portalアカウントが有効であることを確認してください。
クライアントからサーバーを削除し、再度追加してブラウザログインを完了します。
クライアントがキャッシュされた認証情報をサポートしている場合は、クライアントの認証情報をクリアし、クライアントを再起動して再度ログインします。

サーバーが応答していません

クライアントがサーバーにアクセスできないか、ツールがリストされていません。

システムがに到達できることを確認します。https://mcp.equinix.com/fabric
URLと構成ファイルの形式を、「セットアップと構成」の例と比較します。
クライアントを再起動して接続を再初期化します。
特定のエラーについて、クライアントのMCPサーバログを確認します。
サーバーが接続しても、一部のツールしかリストされていない場合は、「クライアントのツール制限」を参照してください。

権限が拒否されました

権限または承認エラーでコールが失敗しました。

ログインしたアカウントの役割を確認してください。これが最も一般的な原因です。
接続時に選択した権限レベルを確認してください。に接続されたクライアントは、fabricViewerアカウントの役割に関係なく、書き込み操作を実行できません。再接続して、操作に必要な場合はまたはをfabricManager選択します。fabricOperator
アカウントがリソースを含むプロジェクトにアクセスできることを確認します。
削除操作をリクエストした場合、サーバーは削除ツールを発行しないことに注意してください。ポータルまたはAPIを使用してください。

セッションの有効期限が切れました

以前に成功したコールは、認証エラーとともに失敗し始めます。クライアントはトークンを自動的に更新するため、通常、この状態は承認が取り消されたか、更新できなかったことを示します。クライアントがレビューおよびアクセス権の取り消し中にまだ付与されていることを確認してください。

クライアントを再起動して、新しいログインをトリガーします。
プロンプトが表示されたら、ブラウザフローを完了します。
問題が解決しない場合は、サーバー設定を削除して再度追加してください。

レート制限

サーバーには、直接APIアクセスと同じレート制限が適用されます。リクエストレートを下げるか、Equinixカスタマーサポートにお問い合わせください。

その他のリソース

Fabric Tools -このサーバが公開するツール。
Fabric Skillsプラグイン- Fabricスキルとこのサーバーを1つのプラグインとしてインストールします。
Fabric APIリファレンス-ツールが呼ぶAPI。
IAMの役割と権限リファレンス-各役割が許可する操作。
API認証- API直接アクセスのための認証。
モデルコンテキストプロトコル仕様-プロトコル仕様。

対応MCPクライアント​

クライアントのツール制限​

前提条件​

認証​

トークンのライフサイクル​

セットアップと構成​

クロードデスクトップ​

オプション1：ビアコネクタの追加（推奨）​

オプション2：構成ファイルを編集する​

クロードコード​

カーソル​

Visual Studioコード​

ジェミニCLI​

オープンコード​

コーデックス​

オプション1：CLIを使用して追加（推奨）​

オプション2：Codexデスクトップ経由で追加​

オプション3：構成ファイルを編集する​

その他のMCPクライアント​

権限モデル​

セキュリティ​

アクセス権の確認と取り消し​

接続を確認する​

トラブルシューティング​

認証失敗​

サーバーが応答していません​

権限が拒否されました​

セッションの有効期限が切れました​

レート制限​

その他のリソース​

対応MCPクライアント

クライアントのツール制限

前提条件

認証

トークンのライフサイクル

セットアップと構成

クロードデスクトップ

オプション1：ビアコネクタの追加（推奨）

オプション2：構成ファイルを編集する

クロードコード

カーソル

Visual Studioコード

ジェミニCLI

オープンコード

コーデックス

オプション1：CLIを使用して追加（推奨）

オプション2：Codexデスクトップ経由で追加

オプション3：構成ファイルを編集する

その他のMCPクライアント

権限モデル

セキュリティ

アクセス権の確認と取り消し

接続を確認する

トラブルシューティング

認証失敗

サーバーが応答していません

権限が拒否されました

セッションの有効期限が切れました

レート制限

その他のリソース