Skip to main content

MCP Server Overview

Equinix MCP (Model Context Protocol) servers provide a standardized interface for AI assistants and language models to interact with the Equinix API. MCP is an open protocol that enables secure, structured access to external APIs and services, allowing AI applications to perform operations on your Equinix resources.

Private Beta

Equinix MCP servers are currently in Private Beta. If you are interested in joining the Beta program, please email fabric-intelligence-support@equinix.com or reach out to your Equinix account representative.

The following MCP servers are available:

MCP ServerLocationDescription
Fabric MCP Serverhttps://mcp.equinix.com/fabricInteract with your Equinix Fabric resources.
Peering Insights MCP Serverhttps://mcp.equinix.com/peeringInsightsInteract with your Equinix Internet Exchange and peering resources.

Supported Agents​

Equinix MCP servers are compatible with the following AI agents:

  • Claude Desktop – Anthropic's desktop application for Claude AI
  • Visual Studio Code – With MCP extensions that support remote MCP servers

Prerequisites​

Before using Equinix MCP servers, ensure you have:

  • An Equinix Customer Portal account
  • Node.js and npx installed (Download Node.js and npx) – Required for running the mcp-remote package that connects to the remote MCP server
  • An AI agent installed that supports MCP servers
  • A valid OAuth2 access token for Equinix APIs

To obtain an access token, see API Authentication for instructions on generating Client ID and Client Secret credentials, then use those credentials to request an access token from the OAuth2 endpoint.

Token Expiration

Access tokens expire after 1 hour. You will need to generate a new access token and update your MCP server configuration after expiration. Token refresh and enhanced authentication for MCP servers is currently in development and will be supported for general availability.

Setup and Configuration​

Equinix MCP servers can be configured independently for Claude Desktop and Visual Studio Code. Each agent uses its own configuration file and format.

Claude Desktop​

To configure Equinix MCP servers in Claude Desktop, refer to the Claude documentation on remote MCP servers.

When adding an Equinix server:

  • Use the URL https://mcp.equinix.com/<server>. Replace <server> with the Equinix MCP server you are configuring.
  • Ensure you include an Authorization header with a valid OAuth2 access token from Equinix. Replace <your_access_token> with your actual access token.

Fabric MCP Server Example:

{
  "mcpServers": {
    "Equinix Fabric MCP Server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.equinix.com/fabric",
        "--header",
        "Authorization: Bearer <your_access_token>"
      ]
    }
  }
}

After updating the configuration file, restart Claude Desktop for the changes to take effect.

Visual Studio Code​

To configure MCP servers in Visual Studio Code, refer to the VS Code documentation on MCP servers.

When adding an Equinix MCP server, use the following configuration in your mcp.json file:

  • Use the URL https://mcp.equinix.com/<server>. Replace <server> with the Equinix MCP server you are configuring.
  • Ensure you include an Authorization header with a valid OAuth2 access token from Equinix. Replace <your_access_token> with your actual access token.

Fabric MCP Server Example:

{
  "servers": {
    "fabric-mcp": {
      "type": "http",
      "url": "https://mcp.equinix.com/fabric",
      "headers": {
        "Authorization": "Bearer <your_access_token>"
      }
    }
  }
}

After updating the configuration, restart Visual Studio Code or reload the MCP extension.

Security Considerations​

When using the Equinix MCP servers:

  • Access Tokens – Store your access tokens securely. Tokens expire after 1 hour and must be refreshed. See API Authentication for token management details.
  • Permissions – The MCP server respects the same permissions as direct API access. Ensure your account has appropriate roles for the operations you want to perform.
  • Tool Confirmation – Enable human confirmation for operations that create or modify resources to prevent unintended changes.
  • Audit Trail – All operations performed through the MCP server are logged in the same way as direct API calls.
important

The MCP server does not bypass any permissions or account requirements. If your direct API call would be rejected due to missing entitlements or invalid account state, the MCP server call will be rejected as well.

Troubleshooting​

Access Token Has Expired​

Problem: The MCP server returns authentication errors or fails to execute operations.

Solution: Access tokens expire after 1 hour. Generate a new OAuth2 access token following the API Authentication guide and update your MCP server configuration file with the new token. After updating the token, restart your AI agent (Claude Desktop or VS Code) for the changes to take effect.

MCP Server Not Responding​

Problem: The AI agent cannot communicate with the MCP server or tools are not available.

Solution:

  • Verify that your internet connection is active and can reach https://mcp.equinix.com/<server>, where is the Equinix MCP server you are trying to use
  • Check that your MCP server configuration file has the correct URL and format
  • Restart your AI agent to reinitialize the MCP server connection
  • Review the MCP server logs in your AI agent for specific error messages

Permission Denied Errors​

Problem: Operations fail with permission or authorization errors.

Solution:

  • Ensure your Equinix account has the appropriate roles and permissions for the operations you're attempting
  • Verify that your OAuth2 credentials (Client ID and Client Secret) have the correct scopes
  • Confirm that your account is in good standing and has access to the resources you're trying to manage

Rate Limiting​

Problem: Requests are being throttled or rejected due to rate limits.

Solution: Equinix MCP servers respect the same rate limits as direct API access. If you encounter rate limiting, reduce the frequency of requests or contact Equinix support to discuss your rate limit requirements.

Additional Resources​

Was this page helpful?