Visão geral do servidor MCP

O servidor Fabric MCP permite que assistentes de IA e ferramentas de desenvolvedor liguem para a Equinix Fabric API em seu nome. O MCP (Model Context Protocol) é um protocolo aberto para conectar essas ferramentas a serviços externos. Um cliente MCP pode pesquisar e modificar seus recursos Fabric sem exigir que você escreva código API.

Visualização pública

O servidor Fabric MCP está em visualização pública. As ferramentas, descrições e formatos de resposta podem mudar antes da disponibilidade geral.

Para feedback, dúvidas ou ajuda com o servidor MCP, envie um e-mail para fabric-intelligence-support@equinix.com.

URL do servidor	Ferramentas	Descrição
https://mcp.equinix.com/fabric	Ferramentas Fabric	Conexões, portas, roteadores de cloud, roteamento, perfis de serviço, e telemetria.

Instalar como um plug-in

O Claude Code e o Claude Desktop podem instalar este servidor juntamente com as habilidades Equinix Fabric em uma única etapa, sem configuração de servidor. As habilidades informam ao cliente quais filtros e valores cada operação do Fabric aceita. Para obter mais informações, consulte Plugin de habilidades do Fabric .

Clientes MCP suportados

Os seguintes clientes são suportados:

• Claude Desktop, aplicativo de desktop da Anthropic
• Código Claude , Agente terminal da Anthropic
• Cursor, o editor de código de IA
• Código do Visual Studio , por meio do GitHub Copilot
• Codex, por meio da CLI ou do aplicativo de desktop
• Gemini CLI, agente de terminal do Google
• OpenCode, o agente de terminal de código aberto

Outros clientes MCP que suportam servidores remotos com OAuth podem funcionar, mas não são testados. Para obter mais informações, consulte Outros clientes MCP .

Limites da ferramenta em seu cliente

O servidor Fabric MCP publica mais de 100 ferramentas. Alguns clientes limitam o número de ferramentas que um modelo pode carregar ao mesmo tempo. O código Visual Studio permite um máximo de 128 ferramentas em todas as fontes, e o Windsurf permite 100. A execução simultânea de vários servidores MCP pode exceder esses limites, o que faz com que as solicitações falhem ou que as ferramentas sejam omitidas sem aviso prévio.

Se você atingir um limite de ferramentas de cliente, desative os servidores MCP que não está usando. Alguns clientes carregam definições de ferramentas sob demanda, em vez de todas de uma vez, o que evita o limite.

Pré-requisitos

• Uma conta Equinix Customer Portal com acesso Fabric
• Um cliente MCP que suporta servidores MCP remotos com OAuth

Nenhum software adicional é necessário. Não há pacote para instalar e nenhum token para gerar. O cliente conclui o login em um navegador.

Autenticação

O servidor usa o OAuth 2,1 e suporta o Registro Dinâmico de Cliente (DCR) e Documentos de Metadados de ID de Cliente (CIMD). O cliente usa qualquer método que implementar. Atualmente, a maioria dos clientes usa DCR. O código Visual Studio também suporta CIMD.

1. Adicione o URL do servidor à configuração do seu cliente, conforme descrito em Instalação e configuração.
2. O cliente detecta que não tem token e solicita que você se conecte.
3. Uma janela do navegador é aberta. Faça login com suas credenciais do Equinix Customer Portal.
4. Selecione um nível de permissão na tela Aprovação e, em seguida, aprove a solicitação. Para obter mais informações, consulte Modelo de permissões .
5. O cliente armazena os tokens e os atualiza em segundo plano.

Conclua este processo uma vez por cliente. A sessão permanece válida até que expire ou você a revogue.

Ciclo de vida do token

Os tokens de acesso são de curta duração e estão vinculados ao servidor para o qual você os autorizou. Os clientes registrados com um documento de metadados de ID do cliente também recebem um token de atualização rotativo e renovam em segundo plano, portanto, raramente você é solicitado a fazer login. Os clientes registrados por meio da DCR renovam por meio do fluxo do navegador, para que você faça login com mais frequência.

Se uma sessão expirar ou você a revogar, o cliente solicitará que você faça login novamente.

Configuração e instalação

Cada cliente segue as mesmas três etapas: Adicione o URL do servidor, salve a configuração e reinicie o cliente. Apenas o local do arquivo e o formato de configuração são diferentes. O URL do servidor Fabric é https://mcp.equinix.com/fabric.

Desktop Claude

Você pode adicionar o servidor por meio da página Conectores ou editando o arquivo de configuração. A antropia documenta ambos os métodos em integrações personalizadas usando o MCP remoto .

Opção 1: Adicionar por meio de conectores (recomendado)

1. Abra o Claude Desktop e clique no menu do seu perfil, depois em Configurações.

2. Na barra lateral Configurações , clique em Conectores.

3. Clique em Adicionar conector personalizado .

4. Insira um Nome (por exemplo, Fabric MCP) e defina o URL do servidor MCP Remoto como https://mcp.equinix.com/fabric, depois clique em Adicionar.

   

5. Clique em Conectar ao lado do novo conector. Uma janela do navegador é aberta, onde você faz autenticação com suas credenciais do Equinix Customer Portal.

Se a sessão expirar, o conector exibirá "A conexão expirou". Clique em Conectar para fazer login novamente.

Opção 2: Edite o arquivo de configuração

Local do arquivo de configuração:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Você também pode abrir o arquivo de configuração em Configurações > Desenvolvedor > Editar configuração dentro do Claude Desktop.

Exemplo de servidor Fabric MCP:

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

Salve o arquivo e reinicie o Claude Desktop. O login do navegador é aberto na primeira vez que você usa uma ferramenta Fabric.

Código Claude

Adicione o servidor a partir da linha de comando:

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

Adicione -s user ao comando para disponibilizar o servidor em todos os projetos, em vez de apenas no projeto atual.

Em seguida, autentique:

/mcp

Selecione fabric-mcp na lista e conclua o login do navegador. Essa tela também exibe o status da conexão, o que distingue uma sessão expirada de um erro de configuração.

Você também pode editar o arquivo de configuração diretamente. Em ~/.claude.json:

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

Cursor

O cursor lê servidores MCP a partir de um arquivo JSON. Para obter mais informações, consulte a documentação do Cursor MCP .

Local do arquivo de configuração:

• No nível do projeto: .cursor/mcp.json na raiz do seu projeto
• Global: ~/.cursor/mcp.json

Você também pode adicionar servidores em Configurações do cursor > Ferramentas e MCP > Novo servidor MCP .

Exemplo de servidor Fabric MCP:

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

Reinicie o cursor. O cursor solicita que você faça login na primeira vez que se conectar.

Código Visual Studio

O código Visual Studio armazena servidores MCP em mcp.json. Para obter o conjunto completo de opções, consulte a documentação MCP do Código Visual Studio .

Local do arquivo de configuração:

• MacOS/Linux: .vscode/mcp.json (espaço de trabalho) ou ~/.vscode/mcp.json (usuário)
• Windows: .vscode\mcp.json (espaço de trabalho) ou %USERPROFILE%\.vscode\mcp.json (usuário)

Exemplo de servidor Fabric MCP:

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

Para reiniciar o código Visual Studio, ou recarregue a janela (******** Recarregar janela). O login do navegador é aberto no primeiro uso.

CLI do Gemini

A CLI do Gemini lê servidores MCP do settings.json. Para obter mais informações, consulte a documentação do MCP CLI do Gemini .

Local do arquivo de configuração:

• Global: ~/.gemini/settings.json
• No nível do projeto: .gemini/settings.json

Exemplo de servidor Fabric MCP. Este cliente requer a httpUrl chave em vez urlde :

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

Reinicie a CLI do GEMINI e, em seguida, autentique:

/mcp auth fabric-mcp

Este comando abre um navegador e escuta no http://localhost:7777/oauth/callback, portanto, execute-o em um sistema com um navegador. Ele não funciona em uma sessão SSH sem encaminhamento do navegador. Execute /mcp auth sem argumentos para listar os servidores que ainda exigem login.

Código aberto

O OpenCode armazena servidores MCP em seu arquivo de configuração sob a mcp chave. Para obter mais informações, consulte a documentação do OpenCode MCP .

Local do arquivo de configuração:

• No nível do projeto: opencode.json na raiz do seu projeto
• Global: ~/.config/opencode/opencode.json

Exemplo de servidor Fabric MCP:

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

O OpenCode executa o fluxo OAuth na primeira vez que usa o servidor. Você também pode iniciar o fluxo manualmente:

opencode mcp auth fabric-mcp

Codex

Você pode adicionar o servidor por meio da CLI, do aplicativo de desktop ou do arquivo de configuração.

Opção 1: Adicionar via CLI (recomendado)

1. Instale a CLI do Codex usando a documentação de configuração da CLI do Codex .

2. Adicione um servidor MCP usando o seguinte comando:

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

3. Execute o comando login:

   codex mcp login fabric-mcp

   Uma janela do navegador é aberta, onde você faz autenticação com suas credenciais do Equinix Customer Portal.

Opção 2: Adicionar via Codex Desktop

1. Abra o Codex Desktop.

2. Vá para Configurações.

3. Na barra lateral de configurações, clique em Servidor MCP .

4. Clique em Adicionar servidor.

5. Insira um Nome (por exemplo, Fabric MCP), selecione HTTP Streamable como o tipo, defina o URL como https://mcp.equinix.com/fabrice clique em Salvar.

   

6. Depois de adicionar o servidor, execute o comando login no terminal:

   codex mcp login fabric-mcp

   Uma janela do navegador é aberta, onde você faz autenticação com suas credenciais do Equinix Customer Portal.

Opção 3: Edite o arquivo de configuração

Local do arquivo de configuração:

• ~/.codex/config.toml (nível de usuário)
• .codex/config.toml (nível do projeto)

Exemplo de servidor Fabric MCP:

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

Salve o arquivo e reinicie o Codex Desktop e, em seguida, faça login quando solicitado.

Outros clientes MCP

Adicione https://mcp.equinix.com/fabrico formato que seu cliente requer para um servidor MCP remoto. O cliente lida com o fluxo OAuth. Os clientes que não estão listados em Clientes MCP suportados não são testados. Se um cliente não testado falhar ao se conectar, verifique o servidor com um cliente compatível antes de abrir um caso de suporte.

Modelo de permissões

O servidor Fabric MCP chama o Fabric API como o usuário que fez login. Cada chamada é atribuída a esse usuário no registro de auditoria, da mesma forma que uma chamada direta API. O servidor não pode executar nenhuma operação que a conta do usuário ainda não tem permissão para executar.

Dois controles determinam o que um cliente conectado pode chamar:

• Funções da conta. As funções atribuídas à sua conta Equinix Customer Portal definem o nível máximo de acesso. A conexão por meio do MCP não aumenta isso.
• Nível de permissão. Quando um cliente se conecta, você seleciona um nível de permissão na tela Aprovação. Os seguintes níveis estão disponíveis:

Nível de permissão	Descrição
fabricViewer	Acesso somente leitura. Pesquisas e pesquisas, como searchNetworks ou getNetworkByUuid.
fabricOperator	Acesso do visualizador, além de modificação de recursos existentes e anexar ou desanexar operações, como updateNetwork.
fabricManager	Acesso do operador, além da criação de recursos, como createNetworkou createRouter.

O token emitido concede a interseção dos dois controles. Um nível de permissão abaixo das funções da conta restringe o cliente. Um nível de permissão acima das funções da conta não concede acesso adicional.

Use o nível de permissão mais restrito que abrange o trabalho. Ao configurar um agente que responde apenas a perguntas sobre seu inventário, o fabricViewernível de permissão é apropriado. Um cliente configurado com esse nível de permissão não pode alterar recursos, mesmo que o usuário tenha direitos administrativos.

Qualquer controle pode rejeitar uma chamada. Um erro de autorização é mais frequentemente causado por uma função ausente na conta, em vez de por um nível de permissão restritivo, portanto, verifique as funções da conta primeiro.

Nenhum nível de permissão concede acesso de exclusão. O servidor não publica nenhuma ferramenta de exclusão, portanto, conexões, portas, roteadores de cloud e redes não podem ser removidos por meio do servidor MCP. Exclua esses recursos no portal ou por meio do API.

Considerações de segurança

Antes de conectar um cliente.

• Confirme as operações de gravação. Ative a confirmação da ferramenta em seu cliente MCP para qualquer ferramenta que crie ou atualize um recurso. A maioria dos clientes solicita por padrão, mas verifique a configuração, porque algumas operações de criação incorrem em cobranças imediatamente. O pedido de uma porta ou de um Cloud Router por meio de um agente é cobrado na mesma taxa que o pedido de um no portal.
• Conecte apenas clientes confiáveis. Qualquer cliente MCP pode iniciar uma solicitação de autenticação para a Equinix. A aprovação da solicitação concede a esse aplicativo acesso à sua conta durante a sessão. Confirme se a solicitação foi originada de um aplicativo que você instalou e configurou e recuse qualquer solicitação que chegue de um link ou de um aplicativo não reconhecido. Os clientes que suportam documentos de metadados de ID do cliente se identificam com um documento publicado em um URL estável, que é um indicador mais forte de identidade do que o registro dinâmico sozinho. A decisão de aprovação permanece sua em qualquer caso.
• Trate a saída da ferramenta como entrada não confiável. As respostas da ferramenta incluem texto definido pelo usuário, como nomes de conexões, nomes de projetos e tags. Um recurso nomeado para se assemelhar a uma instrução pode fazer com que um agente chame uma ferramenta que você não solicitou. Mantenha a confirmação ativada para ferramentas de gravação e avalie o risco antes de executar o servidor Fabric MCP junto com servidores que recuperam conteúdo não confiável, como navegadores da Web ou clientes de e-mail.
• Saiba para onde seus dados são enviados. Os prompts e as respostas da ferramenta que eles geram passam pelo modelo que seu cliente MCP usa, sujeito aos termos desse fornecedor. Todos os dados que o servidor retornar, incluindo nomes de conexão, inventário de portas e telemetria, se tornam parte dessa conversa. Se sua organização restringir para onde os dados de infraestrutura podem ser enviados, revise o cliente e seu modelo subjacente antes de se conectar. O Equinix registra as chamadas API que o servidor faz em seu nome da mesma forma que qualquer outro tráfego API da sua conta.

Para revogar o acesso de um cliente que você não reconhece mais, consulte Revisão e revogação de acesso.

Revisar e revogar o acesso

Cada cliente que você autorizar aparece em Gerenciamento de consentimento de IA em sua conta de usuário do Equinix , acessível em Conta de usuário > Acesso > Gerenciamento de consentimento de IA . A lista dá a você cada cliente pelo nome, se o consentimento ainda é concedido, quando você o autorizou e quando ligou pela última vez para Equinix.

Use esta página para identificar quais agentes podem acessar sua conta do Fabric no momento e quais agentes estão inativos. Clique em Revogar em uma linha para encerrar o acesso desse cliente ou selecione várias linhas e revogue-as juntas.

Revogue o acesso quando um dispositivo for perdido, quando você não usar mais um cliente testado anteriormente ou quando a data da última atividade não corresponder ao seu próprio uso.

A remoção do servidor da configuração de um cliente não revoga o acesso. Essa alteração impede que o cliente local chame o servidor, mas a autorização permanece ativa até que você a revogue.

important

O servidor MCP não ignora nenhum requisito de permissão ou conta. Se uma chamada API direta for rejeitada por direitos ausentes ou por um estado de conta inválido, a chamada MCP também será rejeitada.

Verifique a conexão

Depois que o cliente reiniciar e você concluir o login do navegador, emita uma solicitação somente leitura:

Liste os mercados estratégicos Equinix Fabric.

Uma lista de códigos metropolitanos confirma que o servidor está conectado e que o token é válido. Um erro de autorização indica que o login não foi concluído. Primeiro, verifique os logs do MCP do cliente.

Solução de problemas

Falha na autenticação

O cliente não consegue autenticar ou relata um erro de autorização quando se conecta.

• Verifique se sua conta Equinix Customer Portal está ativa.
• Remova o servidor do cliente, adicione-o novamente e conclua o login do navegador.
• Se o cliente oferecer suporte a essas credenciais armazenadas em cache, reinicie o cliente e faça login novamente.

O servidor não está respondendo

O cliente não pode acessar o servidor ou nenhuma ferramenta está listada.

• Verifique se o sistema pode alcançar https://mcp.equinix.com/fabric.
• Compare o URL e o formato do arquivo de configuração com os exemplos em Instalação e Configuração.
• Reinicie o cliente para reinicializar a conexão.
• Consulte os logs do servidor MCP no cliente para verificar o erro específico.
• Se o servidor se conectar, mas apenas algumas ferramentas estiverem listadas, consulte Limites de ferramentas no seu Cliente.

Permissão negada

Uma chamada falha com um erro de permissão ou autorização.

• Verifique as funções na conta com a qual você fez login. Esta é a causa mais comum.
• Verifique o nível de permissão que você selecionou ao se conectar. Um cliente conectado ao fabricViewer não pode executar operações de gravação, independentemente das funções da conta. Reconecte e selecione fabricOperator ou fabricManager se a operação exigir.
• Verifique se a conta tem acesso ao projeto que contém o recurso.
• Se você solicitou uma operação de exclusão, observe que o servidor não publica nenhuma ferramenta de exclusão. Use o portal ou o API.

Sessão expirada

As chamadas anteriormente bem-sucedidas começam a falhar com erros de autenticação. Os clientes renovam tokens automaticamente, portanto, essa condição geralmente indica que a autorização foi revogada ou não pôde ser renovada. Verifique se o cliente ainda está concedido em Revisão e revogação de acesso.

• Reinicie o cliente para acionar um novo login.
• Quando solicitado, conclua o fluxo do navegador.
• Se a condição persistir, remova a configuração do servidor e adicione-a novamente.

Limitação de taxa

O servidor está sujeito aos mesmos limites de taxa que o acesso direto à API. Reduza a taxa de solicitação ou entre em contato com o Suporte ao cliente Equinix para verificar seus limites.

Recursos adicionais

• Fabric Tools - As ferramentas que este servidor publica.
• Fabric Skills Plugin - as habilidades do Fabric e este servidor, instalados como um plug-in.
• Referência do Fabric API - O API que as ferramentas chamam.
• Referência de funções e permissões do IAM - As operações permitidas por cada função.
• Autenticação API - Autenticação para acesso direto à API.
• Especificação do protocolo de contexto do modelo - a especificação do protocolo.