Criar um catálogo privado de ferramentas (pré-visualização)

Nota

Esta funcionalidade está atualmente em pré-visualização pública. Esta pré-visualização é fornecida sem um acordo de nível de serviço, e não a recomendamos para cargas de trabalho em produção. Certas funcionalidades podem não ser suportadas ou podem ter capacidades limitadas. Para mais informações, consulte Termos de Utilização Suplementares para Microsoft Azure Pré-visualizações.

Crie um catálogo privado de ferramentas para que os programadores da sua organização possam descobrir, configurar e utilizar ferramentas de servidor MCP através das Foundry Tools. Um catálogo privado de ferramentas utiliza Azure API Center para registar ferramentas com âmbito organizacional a que apenas os seus programadores podem aceder.

Pré-requisitos

Acesso do administrador do plano e do programador

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

Objetivo Quem Onde O que fazer
Crie e gere o catálogo de ferramentas Administradores de catálogo Centro de API do Azure Criar o recurso do API Center, registar servidores MCP e (opcionalmente) configurar as definições de autorização.
Descubra ferramentas do catálogo privado Desenvolvedores Azure API Center (RBAC) Atribuir acesso para que os programadores possam ver os servidores MCP registados.
Configurar e usar ferramentas Desenvolvedores Projeto da fundição Confirme que os programadores podem aceder ao projeto Foundry e configurar ferramentas no Foundry Tools.

Configurar autenticação do servidor MCP

Se o seu servidor MCP remoto exigir autenticação, configure as definições de autenticação no Azure API Center. Este passo é opcional se o seu servidor MCP não exigir autenticação.

  1. No portal Azure, aceda ao seu recurso do API Center.

  2. Selecione Governação>Autorização.

    Captura de ecrã que mostra o menu de Governação expandido com a opção de Autorização selecionada no Azure API Center.

  3. Selecionar Adicionar configuração.

  4. Em esquema de Segurança, escolha o esquema exigido pelo seu servidor MCP (por exemplo, API Key, OAuth ou token portador HTTP ), depois forneça os valores exigidos.

    Importante

    Trate quaisquer credenciais como segredos. Não coles segredos em campos de introdução ou controlo de versão. Para orientações sobre abordagens de autenticação no Serviço de Agente (incluindo autenticação partilhada e por utilizador), veja autenticação do servidor MCP.

  5. Selecione o servidor MCP, depois selecione Detalhes>Versões>Gerir acesso (pré-visualização).

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

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

Depois de completar estes passos, o servidor MCP é configurado para usar o esquema de autenticação selecionado quando os programadores o invocam a partir das Foundry Tools.

Conceder o acesso dos programadores ao catálogo

Atribua permissões ao Azure RBAC para que os programadores possam descobrir servidores MCP a partir do teu catálogo privado de ferramentas no Foundry Tools.

  1. Decida se concede acesso a um grupo de segurança ou a utilizadores individuais.
  2. Atribuir pelo menos o papel Azure API Center Data Reader (ou um papel personalizado equivalente) a esses utilizadores.

Nota

As atribuições de funções podem demorar até 24 horas a propagar-se. Se os programadores não virem o catálogo imediatamente, esperem e tentem novamente.

Verificar a descoberta de catálogos nas ferramentas Foundry Tools

Depois de concederes o acesso, confirma que os programadores podem encontrar e usar o catálogo no portal da Foundry.

  1. No portal Foundry, abra o projeto que os seus programadores utilizam.
  2. Vai a Construir>Ferramentas.
  3. Use pesquisa e filtros para encontrar o seu catálogo de ferramentas privadas pelo nome do API Center.
  4. Selecione uma ferramenta do catálogo e reveja os seus requisitos de configuração.

Se o catálogo aparecer e mostrar os seus servidores MCP registados, a configuração está completa. Para adicionar uma ferramenta de servidor MCP a um agente, veja Ligar a servidores de Protocolo de Contexto de Modelo.

Resolver problemas com catálogos privados de ferramentas

Se tiver dificuldades a configurar ou a usar o seu catálogo de ferramentas privadas, utilize a tabela seguinte para identificar e resolver problemas comuns.

Problema Causa Resolução
O catálogo privado de ferramentas não aparece na Foundry Tools. Não tens acesso ao recurso do API Center, ou estás no projeto Foundry errado. Confirme que tem a atribuição de função de Leitor de Dados do Azure API Center. Depois confirma que estás no projeto Foundry esperado e vai a Build>Tools.
O catálogo aparece, mas não se pode configurar uma ferramenta. A ferramenta requer valores de autenticação ou configuração que não tens. Revê os requisitos de configuração da ferramenta e depois pergunta a um administrador de catálogo o acesso necessário. Para opções de autenticação MCP, consulte autenticação do servidor MCP.
As chamadas de ferramenta falham após a configuração. A autenticação está incorreta, expirada ou não é suportada pelo servidor MCP. Verifique novamente o método de autenticação exigido pelo servidor MCP e valide o formato da credencial. Para orientações, consulte autenticação do servidor MCP.
O catálogo não aparece depois da atribuição de funções. As atribuições de funções RBAC no Azure podem demorar até 24 horas a propagar-se. Espere até 24 horas e tente novamente. Se o problema persistir, verifique a atribuição de funções no portal Azure em Controlo de Acesso (IAM).
O servidor MCP aparece como indisponível. A URL do servidor MCP mudou, ou o servidor está offline. Verifica se o endpoint do servidor MCP está acessível. Atualize o registo do servidor no API Center se o URL mudou.
A autenticação OAuth é solicitada repetidamente. Expiração do token ou consentimento não foi concedido. Garanta que os utilizadores concedem consentimento quando solicitados. Para sessões de longa duração, os tokens podem expirar. Re-autenticar pelo menu de configuração da ferramenta.

Conteúdo relacionado

Descubra e gere ferramentas no catálogo de ferramentas da Foundry

Liga-te aos servidores do Model Context Protocol

  • Last updated on