Permitir a descoberta de plugins do API Center a partir de um mercado de plugins

Este artigo mostra como permitir a descoberta de plugins através de um endpoint de marketplace de plugins no Azure API Center. O endpoint do marketplace de plugins utiliza a API do plano de dados do API Center para catalogar os plugins de IA, como servidores MCP e as competências disponíveis no inventário do API center.

Os programadores podem adicionar o marketplace de plugins ao seu ambiente de desenvolvimento GitHub Copilot CLI ou Claude Code para descobrir e instalar plugins a partir do seu centro de APIs.

Note

Atualmente, o endpoint do marketplace suporta apenas acesso anónimo.

Pré-requisitos

Ativar endpoint do marketplace de plugins

Para ativar o endpoint do marketplace de plugins usando o portal Azure:

  1. No portal Azure, vai ao teu centro de API.
  2. No menu lateral, em Consumo, selecione Definições da API de Dados.
  3. No endpoint do marketplace de plugins, selecione Ativar o endpoint do marketplace de plugins.

O endpoint do marketplace tem a seguinte forma:

https://<service name>.data.<region>.azure-apicenter.ms/workspaces/default/plugins/marketplace.git

Clonar localmente o endpoint do marketplace de plugins

Pode confirmar que o endpoint do marketplace de plugins está ativado para o seu centro de APIs clonando-o localmente.

Para o clonar, use um comando semelhante ao seguinte no seu terminal, substituindo o nome do serviço e a região pelos valores do seu centro API:

git clone https://myapicenter.data.eastus.azure-apicenter.ms/workspaces/default/plugins/marketplace.git

A pasta marketplace do repositório clonado contém pastas para configuração do marketplace em Claude Code e GitHub Copilot CLI, e pastas para cada plugin no inventário do teu API Center. Por exemplo:

marketplace/
    .claude-plugin/
    .github/
    plugins/
        plugin1/
        plugin2/
        ...

Cada pasta de plugin contém ficheiros JSON com os metadados e configuração do plugin.

Adicionar marketplace de plugins à CLI do GitHub Copilot

Os programadores podem adicionar o marketplace de plugins ao GitHub Copilot CLI a partir do endpoint do marketplace do respetivo centro de API, utilizando o comando plugin marketplace add. Por exemplo, adicione-o numa sessão CLI do GitHub Copilot com um comando semelhante ao seguinte. Substitua o nome do serviço e a região pelos valores do seu centro API:

/plugin marketplace add https://myapicenter.data.eastus.azure-apicenter.ms/workspaces/default/plugins/marketplace.git

Siga as instruções para adicionar o marketplace de plugins à sua CLI do GitHub Copilot.

Depois de adicionares o marketplace, usa o /plugin marketplace browse comando para ver os plugins do inventário do teu API Center.

/plugin marketplace browse myapicenter

Adicione um plugin do marketplace a uma sessão de CLI GitHub Copilot com o comando /plugin install. Por exemplo:

/plugin install plugin-name@myapicenter

Para mais informações sobre como instalar plugins do marketplace na GitHub Copilot CLI, consulte documentação da GitHub Copilot CLI.

Adicionar o marketplace de plugins ao Claude Code

Os programadores podem adicionar o marketplace de plugins a partir do endpoint marketplace do seu centro de API usando o /plugin marketplace add comando. Por exemplo, adicione-o numa sessão Claude Code com um comando semelhante ao seguinte. Substitua o nome do serviço e a região pelos valores do seu centro API:

/plugin marketplace add https://myapicenter.data.eastus.azure-apicenter.ms/workspaces/default/plugins/marketplace.git

Siga as instruções para adicionar o marketplace de plugins.

Depois de adicionares o marketplace, usa o /plugin comando para ver os plugins do inventário do teu API Center.

Adiciona um plugin do marketplace a uma sessão Claude Code com o /plugin install comando. Por exemplo:

/plugin install plugin-name@myapicenter

Para mais informações sobre como instalar plugins no marketplace no Claude Code, consulte a documentação do Claude Code.