# 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ório[Equinix-agent-plugins](https://github.com/equinix/equinix-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](mailto:fabric-intelligence-support@equinix.com). ## O que o plug-in contém[​](#o-que-o-plug-in-contém "Link direto para O que o plug-in contém") O marketplace publica um plug-in, `equinix-fabric`que contém quatro habilidades. | Habilidade | O que você pode pedir ao cliente para fazer | | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `show-fabric-inventory` | PESQUISE 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-connection` | Crie, 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-network` | Planeje, 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-router` | Crie 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](https://docs.equinix.com/pt-BR/equinix-api/mcp-servers/fabric-mcp-server.md) . ## Pré-requisitos[​](#pré-requisitos "Link direto para 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](#install-in-other-clients). * 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](https://docs.equinix.com/pt-BR/equinix-api/mcp-servers/overview.md#authentication). ## Instale no Claude Code[​](#instale-no-claude-code "Link direto para 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-plugins`marketplace. 3. Autenticar. Execute `/mcp`, selecione `equinix-fabric`e 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[​](#instale-no-claude-desktop "Link direto para 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[​](#instalar-para-uma-equipe "Link direto para 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[​](#instalar-no-codex "Link direto para 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[​](#instalar-em-outros-clientes "Link direto para 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](https://docs.equinix.com/pt-BR/equinix-api/mcp-servers/overview.md#setup-and-configuration). 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[​](#verifique-a-instalação "Link direto para 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](#troubleshooting). 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[​](#atualize-ou-remova-o-plug-in "Link direto para 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[​](#permissões-e-aprovações "Link direto para 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](https://docs.equinix.com/pt-BR/equinix-api/mcp-servers/overview.md#permissions-model) . 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 habilidades`manage-fabric-connection` , `manage-fabric-network`e `manage-cloud-router`criam 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[​](#solução-de-problemas "Link direto para Solução de problemas") Para erros de autenticação, conectividade e permissão, consulte [Solução de problemas](https://docs.equinix.com/pt-BR/equinix-api/mcp-servers/overview.md#troubleshooting) na Visão geral do servidor MCP. Os seguintes problemas são específicos do plug-in. ### O Marketplace não sincroniza[​](#o-marketplace-não-sincroniza "Link direto para 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[​](#o-plug-in-está-instalado-mas-o-cliente-não-tem-ferramentas-fabric "Link direto para 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-fabric`e conclua o login do navegador. Em seguida, inicie uma nova sessão. ### O Fabric Server aparece duas vezes[​](#o-fabric-server-aparece-duas-vezes "Link direto para 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](https://docs.equinix.com/pt-BR/equinix-api/mcp-servers/overview.md#setup-and-configuration) instalação[e configuração](https://docs.equinix.com/pt-BR/equinix-api/mcp-servers/overview.md#setup-and-configuration). 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[​](#o-cliente-pede-que-você-restrinja-uma-pesquisa "Link direto para 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[​](#recursos-adicionais "Link direto para Recursos adicionais") * [Visão geral do servidor MCP](https://docs.equinix.com/pt-BR/equinix-api/mcp-servers/overview.md) - Configuração, autenticação, permissões e segurança do servidor. * [Fabric Tools](https://docs.equinix.com/pt-BR/equinix-api/mcp-servers/fabric-mcp-server.md) - as ferramentas que o servidor publica e o nível de acesso de que cada um precisa. * [Referência do Fabric API](https://docs.equinix.com/pt-BR/api-catalog/fabricv4.md) - O API que as ferramentas chamam. * [Equinix-agent-plugins](https://github.com/equinix/equinix-agent-plugins) - Origem do plug-in, definições de habilidades e orientação de contribuição.