Ir para o conteúdo principal

Plug-in de habilidades do Fabric

O plug-in Equinix Fabric Skills instala as habilidades Fabric e o servidor Fabric MCP juntos em uma única etapa. Adicione o marketplace ao seu cliente, instale o plug-in e faça login. Em seguida, você pode pedir ao cliente para pesquisar seu inventário Fabric, criar e atualizar conexões, gerenciar redes Fabric ou configurar um Fabric Cloud Router.

Uma habilidade é um arquivo de instruções que diz ao cliente como realizar uma tarefa corretamente. As habilidades do Fabric definem quais filtros se aplicam a uma pesquisa de inventário, quais detalhes uma solicitação de conexão precisa antes que o cliente a crie, quais valores um pacote Fabric Cloud Router aceita e qual ordem as etapas são executadas em. Sem eles, um cliente tem as ferramentas, mas não o procedimento. O plug-in também carrega a definição do servidor Fabric MCP, para que você não configure o servidor separadamente.

O plugin é publicado no repositórioEquinix-agent-plugins no GitHub. Esse repositório é um marketplace de plugins. Você adiciona o marketplace uma vez e, em seguida, instala os plugins que você quer dele.

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, perguntas ou ajuda com o plugin, envie um e-mail para fabric-intelligence-support@equinix.com.

O que o plug-in contém​

O marketplace publica um plug-in, equinix-fabricque contém quatro habilidades.

HabilidadeO que você pode pedir ao cliente para fazer
show-fabric-inventoryPESQUISE e liste conexões, portas, Fabric Cloud Routers, tokens de serviço, filtros de rota, agregações de rotas e serviços Equinix Precision Time. Filtrar por mercado estratégico, projeto, estado, largura de banda, tipo, ou nome.
manage-fabric-connectionCrie, atualize e tente novamente conexões Fabric, incluindo EVPL, EPL, IP, acesso à Internet, e conexões virtuais EVP-LAN ou EP-LAN. Valide uma conexão antes de criá-la e atualize seu nome, largura de banda ou endereços de e-mail de notificação.
manage-fabric-networkPlaneje, crie, procure, compare e atualize redes Fabric do tipo EVP-LAN, EVP-Tree, EP-LAN e EP-Tree, incluindo verificações de compatibilidade de portas.
manage-cloud-routerCrie e atualize roteadores Fabric Cloud. Configure o BGP para IPv4 e IPv6. Crie, anexe e atualize filtros de rota, regras de filtro de rota, agregações de rota e regras de agregação de rota.

O plug-in agrupa o servidor Fabric MCP em https://mcp.equinix.com/fabric e o registra em seu cliente com o nome equinix-fabric. Para obter as ferramentas que o servidor expõe e o nível de acesso de que cada um precisa, consulte Ferramentas Fabric .

Pré-requisitos​

  • Uma conta Equinix Customer Portal com acesso aos recursos Fabric que você deseja que o cliente use. O cliente age como o usuário que faz login e herda as permissões desse usuário.
  • Um cliente que lê marketplaces de plugins. Claude Code e Claude Desktop fazem. Para todos os outros clientes, consulte Instalar em outros clientes.
  • Acesso à rede para https://mcp.equinix.com e https://github.com.

Você não precisa de um token de acesso. O cliente conclui um login no navegador na primeira vez que liga para o servidor. Para obter mais informações, consulte Autenticação.

Instale no Claude Code​

  1. Adicione o marketplace.

    claude plugin marketplace add equinix/equinix-agent-plugins

  2. Instale o plug-in.

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

    Você também pode participar /plugin de uma sessão interativa e selecionar equinix-fabric no equinix-agent-pluginsmarketplace.

  3. Autenticar. Execute /mcp, selecione equinix-fabrice conclua o login do navegador.

  4. Confirme se o plug-in está instalado e se o servidor está conectado.

    claude plugin list
    claude mcp list

Instale no Claude Desktop​

  1. Acesse Configurações > Personalizar e selecione Plugins.

  2. Selecione Adicionar marketplace.

  3. Insira o endereço do repositório e confirme.

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

  4. Aguarde a sincronização do marketplace. O Claude Desktop lê o índice do marketplace do repositório e lista os plugins que declara. Selecione Sincronizar na entrada do marketplace sempre que quiser obter novos plug-ins ou versões.

  5. Encontre o Equinix-Fabric na lista, selecione Instalar e confirme se a alternância está ativada.

  6. Autenticar. Acesse Configurações > Conectores, localize Equinix-Fabric e conclua o login do navegador. As habilidades só funcionam depois que o servidor é conectado.

  7. Inicie uma nova sessão.

Instalar para uma equipe​

Para dar a todos em um projeto o plugin quando clonarem o repositório do projeto, confirme o seguinte no arquivo do projeto.claude/settings.json.

{
  "extraKnownMarketplaces": {
    "equinix-agent-plugins": {
      "source": {
        "source": "github",
        "repo": "equinix/equinix-agent-plugins"
      }
    }
  },
  "enabledPlugins": {
    "equinix-fabric@equinix-agent-plugins": true
  }
}

Cada usuário ainda faz login individualmente, e as permissões de cada usuário vêm de sua própria conta do Equinix.

Instalar no Codex​

O CODEX instala as habilidades do mercado. Adicione o servidor Fabric MCP separadamente.

  1. No Codex, vá para Plugins > Adicionar > Adicionar marketplace.

  2. Insira o endereço do repositório e adicione o marketplace.

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

  3. Em seu espaço pessoal, selecione Equinix-Fabric e instale-o.

  4. Adicione o servidor Fabric MCP.

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

  5. Inicie uma nova sessão e conclua o login do navegador quando o CODEX chamar o servidor pela primeira vez.

Instalar em outros clientes​

Para clientes como Cursor, Código Visual Studio, CLI do GEMINI e OpenCode, adicione o servidor e as habilidades separadamente.

  1. Adicione o servidor Fabric MCP usando as instruções para seu cliente em Instalação e configuração.

  2. Adicione as habilidades. Faça o clone do repositório e aponte o carregador de habilidades do cliente para o diretório de habilidades ou cole o conteúdo de um SKILL.md arquivo nas instruções do cliente.

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

    As habilidades são arquivos de Markdown simples no fabric-agent-plugins/skills/diretório. Cada habilidade tem sua própria pasta que contém um SKILL.md arquivo e, para algumas habilidades, uma references pasta com procedimentos de apoio.

Verifique a instalação​

Inicie uma sessão e insira uma solicitação como a seguinte:

Show me all my Fabric connections in SV.

O cliente chama o servidor Fabric MCP e retorna as conexões que o usuário Equinix pode ver. Se ele atender sem chamar uma ferramenta, o servidor não está conectado. Para obter mais informações, consulte Solução de problemas.

Outras solicitações para tentar:

  • 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.

Atualize ou remova o plug-in​

Em Claude Code, atualize o marketplace antes de atualizar para que o cliente veja a versão mais recente.

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

Para remover o plug-in, execute o seguinte comando.

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

No Claude Desktop, selecione Sincronizar na entrada do marketplace e, em seguida, Atualizar no plug-in. Para remover o plug-in, selecione Desinstalar. Para remover o marketplace e todos os plugins dele, selecione Remover marketplace.

Permissões e aprovações​

O plug-in não altera o que sua conta Equinix pode fazer. O cliente atua como o usuário que fez login, e o token que ele mantém concede a interseção das funções desse usuário e o nível de permissão selecionado no momento da conexão. Para obter mais informações, consulte Modelo de permissões .

Os seguintes pontos são específicos para as habilidades:

  • Ative o prompt de confirmação do seu cliente para chamadas de ferramenta que criam ou atualizam recursos. As habilidadesmanage-fabric-connection , manage-fabric-networke manage-cloud-routercriam e modificam recursos do Fabric, e alguns desses recursos são cobrados.
  • O servidor não publica ferramentas de exclusão, portanto, as solicitações para excluir uma conexão, rede Fabric ou recurso Fabric Cloud Router falham. Para remover um recurso, use o Equinix Customer Portal ou o Fabric API.

Solução de problemas​

Para erros de autenticação, conectividade e permissão, consulte Solução de problemas na Visão geral do servidor MCP. Os seguintes problemas são específicos do plug-in.

O Marketplace não sincroniza​

Problema: Seu cliente não pode adicionar ou atualizar o equinix-agent-plugins marketplace.

Solução: Confirme se sua rede permite acesso a https://github.com. Verifique se você inseriu o endereço exatamente como https://github.com/equinix/equinix-agent-plugins. Em seguida, selecione Sincronizar na entrada do marketplace ou Executar claude plugin marketplace update equinix-agent-plugins.

O plug-in está instalado, mas o cliente não tem ferramentas Fabric​

Problema: O cliente reconhece a solicitação, mas informa que não tem ferramentas Fabric ou responde com conhecimento geral em vez de sua conta.

Solução: O plug-in está instalado, mas o servidor não está autenticado. Execute /mcp no Claude Code ou vá para Configurações > Conectores no Claude Desktop, selecione equinix-fabrice conclua o login do navegador. Em seguida, inicie uma nova sessão.

O Fabric Server aparece duas vezes​

Problema: O cliente lista ambos fabric-mcp e equinix-fabric, ou mostra cada ferramenta Fabric duas vezes.

Solução: Antes de instalar o plug-in, você adicionou o servidor manualmente seguindo as instruções de instalaçãoe configuração. O plug-in adiciona sua própria cópia chamada equinix-fabric. Remova a entrada manual. Em Código Claude, execute claude mcp remove fabric-mcp. Em outros clientes, exclua a fabric-mcp entrada da configuração do MCP do cliente.

O cliente pede que você restrinja uma pesquisa​

Problema: Você pede seu inventário e o cliente pede um mercado estratégico, um projeto ou um tipo de recurso em vez de retornar resultados.

Solução: Esse comportamento é intencional. A show-fabric-inventory habilidade pede pelo menos um filtro em uma solicitação aberta. Adicione um filtro, como show me my ports in SV, ou peça tudo explicitamente, como show me my full Fabric inventory.

Recursos adicionais​

Esta página foi útil?