Criar um catálogo de ferramentas privadas (versão prévia)

Nota

Esse recurso está atualmente em versão prévia pública. Essa versão prévia é fornecida sem um contrato de nível de serviço e não recomendamos isso para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou ter recursos restritos. Para obter mais informações, consulte Supplemental Terms of Use for Microsoft Azure Previews.

Crie um catálogo de ferramentas privadas para que os desenvolvedores em sua organização possam descobrir, configurar e usar ferramentas de servidor MCP por meio das Ferramentas da Foundry. Um catálogo de ferramentas privadas usa Azure Centro de API para registrar ferramentas no escopo da organização que somente os desenvolvedores podem acessar.

Pré-requisitos

  • Um projeto do Foundry. Para obter diretrizes de instalação, consulte Criar projetos no Microsoft Foundry.

  • Permissões para descobrir e configurar ferramentas em seu projeto do Foundry. Para obter mais informações, consulte o controle de acesso baseado em Role no Microsoft Foundry.

  • Um centro de API Azure.

    Nota

    O nome do Centro de APIs é o nome que os desenvolvedores usam para localizar o catálogo nas Ferramentas Foundry. Use um nome descritivo.

  • Um ou mais servidores MCP remotos que você deseja compartilhar com sua organização. Registre-os no Centro de API seguindo Configurar ambientes e implantações no Azure Centro de API.

Planejar o acesso do administrador e do desenvolvedor

Antes de criar o catálogo, decida quem o gerencia e quem o consome.

Objetivo Quem Onde O que fazer
Criar e gerenciar o catálogo de ferramentas Administradores de catálogo Centro de API Azure Crie o recurso do Centro de API, registre servidores MCP e (opcionalmente) defina as configurações de autorização.
Descobrir ferramentas do catálogo privado Desenvolvedores Azure API Center (RBAC) - Centro de API do Azure (RBAC) Atribua acesso para que os desenvolvedores possam exibir os servidores MCP registrados.
Configurar e usar ferramentas Desenvolvedores Projeto de fundimento Confirme se os desenvolvedores podem acessar o projeto Foundry e podem configurar ferramentas nas Ferramentas do Foundry.

Configurar a autenticação do servidor MCP

Se o servidor MCP remoto exigir autenticação, defina as configurações de autenticação no Centro de API Azure. Essa etapa será opcional se o servidor MCP não exigir autenticação.

  1. No Azure portal, acesse o recurso do Centro de API.

  2. Selecione Governança>Autorização.

    Screenshot que mostra o menu Governança expandido com a opção autorização selecionada em Azure API Center.

  3. Selecione Adicionar configuração.

  4. No esquema de segurança, escolha o esquema exigido pelo servidor MCP (por exemplo, chave de API, OAuth ou token de portador HTTP ) e forneça os valores necessários.

    Importante

    Trate as credenciais como segredos. Não cole segredos em solicitações ou controle de versão. Para obter diretrizes sobre abordagens de autenticação no Serviço de Agente (incluindo autenticação compartilhada e por usuário), consulte a autenticação do servidor MCP.

  5. Selecione o servidor MCP e, em seguida, selecione Detalhes>Versões>Gerenciar acesso (pré-visualização).

    Screenshot que mostra a página Versões com a opção Gerenciar acesso para configurar a autorização no Azure API Center.

  6. Selecione a configuração de autorização que você criou.

Depois de concluir essas etapas, o servidor MCP será configurado para usar o esquema de autenticação selecionado quando os desenvolvedores o chamarem a partir do Foundry Tools.

Conceder acesso do desenvolvedor ao catálogo

Atribua permissões de RBAC do Azure para que os desenvolvedores possam identificar servidores MCP no catálogo privado de ferramentas nas Foundry Tools.

  1. Decida se deseja conceder acesso a um grupo de segurança ou a usuários individuais.
  2. Atribua pelo menos a função Azure Leitor de Dados do API Center (ou uma função personalizada equivalente) a esses usuários.

Nota

As atribuições de função podem levar até 24 horas para serem propagadas. Se os desenvolvedores não virem o catálogo imediatamente, aguarde e tente novamente.

Verificar a descoberta do catálogo nas Foundry Tools

Depois de conceder acesso, confirme se os desenvolvedores podem encontrar e usar o catálogo no portal do Foundry.

  1. No portal do Foundry, abra o projeto que os desenvolvedores usam.
  2. Vá até Criar>Ferramentas.
  3. Use a pesquisa e os filtros para localizar seu catálogo de ferramentas privadas pelo nome do Centro de API.
  4. Selecione uma ferramenta no catálogo e examine seus requisitos de instalação.

Se o catálogo for exibido e apresentar os servidores MCP registrados, a configuração estará concluída. Para adicionar uma ferramenta de servidor MCP a um agente, consulte Conectar-se aos servidores do Protocolo de Contexto de Modelo.

Solucionar problemas de catálogo de ferramentas privadas

Se você encontrar problemas ao configurar ou usar seu catálogo de ferramentas privadas, use a tabela a seguir para identificar e resolver problemas comuns.

Questão Causa Resolução
O catálogo de ferramentas privadas não aparece no Foundry Tools. Você não tem acesso ao recurso do Centro de API ou está no projeto Foundry errado. Confirme se você tem a atribuição de função de Leitor de Dados do Centro de API Azure. Em seguida, confirme se você está no projeto Foundry esperado e vá para Build>Tools.
O catálogo é exibido, mas você não pode configurar uma ferramenta. A ferramenta requer valores de autenticação ou configuração que você não tem. Examine os requisitos de instalação da ferramenta e peça a um administrador de catálogo o acesso necessário. Para obter opções de autenticação do MCP, consulte a autenticação do servidor MCP.
As chamadas de ferramenta falham após a configuração. A autenticação está incorreta, expirou ou não tem suporte do servidor MCP. Verifique novamente o método de autenticação exigido pelo servidor MCP e valide o formato de credencial. Para obter diretrizes, consulte a autenticação do servidor MCP.
O catálogo não aparece após a atribuição de função. As atribuições de função do Azure RBAC podem levar até 24 horas para serem propagadas. Aguarde até 24 horas e tente novamente. Se o problema persistir, verifique a atribuição de função no portal do Azure em Execess control (IAM).
O servidor MCP é mostrado como indisponível. A URL do servidor MCP foi alterada ou o servidor está offline. Verifique se o ponto de extremidade do servidor MCP está acessível. Atualize o registro do servidor no Centro de API se a URL for alterada.
Solicitações de autenticação OAuth repetidas. Token expirado ou consentimento não concedido. Verifique se os usuários concedem consentimento quando solicitado. Para sessões de execução prolongada, os tokens podem expirar. Autentique novamente por meio da configuração da ferramenta.

Conteúdo relacionado

Descobrir e gerenciar ferramentas no catálogo de ferramentas do Foundry

Conectar aos servidores do Protocolo de Contexto do Modelo

  • Last updated on