Criar conectores de servidor MCP em namespaces de conectores para agentes e integrações com o Azure (pré-visualização)

Important

Esta capacidade de pré-visualização está sujeita aos Termos de Utilização Suplementares para Microsoft Azure Pré-visualizações. Durante a pré-visualização, esta funcionalidade só está disponível nas regiões públicas do Azure.

Para automação e integração, os agentes de IA precisam de ferramentas que possam chamar de forma segura outros serviços e sistemas. No entanto, construir e manter servidores Model Context Protocol (MCP) geridos separadamente, definir ferramentas e gerir credenciais para cada integração acrescenta uma sobrecarga e complexidade significativas. O Espaço de Nomes de Conectores resolve este problema ao hospedar e gerir centralmente servidores MCP como conectores para si. Num recurso de namespace de conectores, pode criar um conector de servidor MCP escolhendo um conector pré-construído, que fornece ações como ferramentas que agentes e serviços Azure podem chamar de forma segura – sem necessidade de código de servidor personalizado ou outra infraestrutura.

Num namespace de conectores, pode criar os seguintes tipos de conectores de servidor MCP:

Tipo	Description
Managed	Este conector de servidor MCP inclui automaticamente todas as ações do conector pré-construído selecionado para que os agentes possam chamar como ferramentas. Precisa de uma configuração mínima.
Configurável	Este conector de servidor MCP inclui apenas as ações que escolhe do conector pré-construído selecionado para os agentes chamarem como ferramentas. Também podes controlar se agentes ou humanos fornecem entradas de ferramentas.

Este guia mostra como criar conectores de servidor MCP geridos e configuráveis num namespace de conectores e validar os seus novos conectores no playground. Para conectores de servidor MCP configuráveis, também se aprende a escolher ações específicas para incluir como ferramentas e a especificar se agentes ou humanos fornecem entradas de ferramenta.

Para mais informações, veja O que é o Espaço de Nomes do Conector.

Pré-requisitos

Uma conta Azure e uma assinatura. Crie uma conta Azure gratuita.
Acesso ao portal Azure com permissões para criar namespaces de conectores e ligações reutilizáveis.
Credenciais do serviço ou sistema para o qual pretende criar uma ligação reutilizável no espaço de nomes do conector.
Um recurso de namespace de conectores existente no portal Azure.
Acesso ao portal Connector Namespaces.
A capacidade de criar ligações reutilizáveis para os serviços que pretende durante o processo de criação de conectores, ou de ter ligações existentes para usar ao criar os seus conectores de servidor MCP.

Limitações e problemas conhecidos

Esta versão suporta a escolha de apenas um conector para criar o seu conector de servidor MCP.

Criar um conector de servidor MCP

Na caixa de pesquisa do portal Azure, introduza connector namespaces, e selecione Espaços de Nomes de Conectores.
Encontre e selecione o recurso de namespace do seu conector.

O portal de Espaços de Nomes de Conectores abre-se e mostra a página de visão geral do seu espaço de nomes de conectores.
Na página de visão geral do espaço de nomes, na secção de conectores MCP , selecione + Criar.

Por exemplo:

A janela seguinte abre-se e mostra conectores pré-construídos onde pode escolher um para criar o seu servidor MCP:
Continue com os passos para um conector gerido ou configurável.

Managed
Configurável

Os passos seguintes criam um conector de servidor MCP a partir de um conector pré-construído selecionado que inclui todas as suas ações para que os agentes possam usar como ferramentas:

Na janela MCP Connector - Escolher Conector, na caixa de pesquisa, selecione Gerido para visualizar conectores geridos pelo Azure.
Encontre e selecione o conector gerido que deseja, como Office 365 Outlook.
Siga o indicador para autenticar a ligação com as suas credenciais.
Depois de o portal criar o seu conector, selecione Criar outro ou Feito.
Continue a testar o seu conector de servidor MCP.

Os passos seguintes criam um conector de servidor MCP a partir de um conector e incluem apenas as ações selecionadas para os agentes usarem como ferramentas:

Na janela do conector MCP - Escolher o conector , na caixa de pesquisa, selecione Configurável.
Encontre e selecione o conector que deseja, como o Armazenamento de Blobs do Azure.
Siga o indicador para autenticar a ligação com as suas credenciais.
Depois de o portal criar o seu conector, escolha um caminho:
- Opcionalmente, continua para a secção seguinte para filtrar as ações que não queres expor no teu servidor MCP.
  
  Por defeito, o conector do servidor MCP que cria inclui automaticamente todas as ações no conector selecionado.
- Selecione Criar outro para criar outro conector de servidor MCP.
- Seleciona Feito para poderes testar o teu servidor MCP.

Ocultar ou filtrar ferramentas em conectores de servidor MCP configuráveis

Os passos seguintes escondem e filtram ferramentas que não queres incluir no teu conector de servidor MCP:

Na página de confirmação do seu novo conector de servidor MCP, selecione Configurar ferramentas.

Tip

Para alterar a disponibilidade da ferramenta num conector de servidor MCP configurável existente, abra esse conector e selecione Editar.
No separador de Ferramentas, selecione Desmarcar tudo para apagar todas as seleções de ação.
Seleciona apenas as ações que queres incluir no teu conector de servidor MCP. Quando terminar, selecione Atualizar.

O exemplo seguinte mostra um conector de servidor MCP, que é baseado no conector Armazenamento de Tabelas do Azure. Para fornecer acesso apenas de leitura, selecione apenas as ações Obter uma tabela, Obter entidades, Obter entidade e Listar tabelas .
Ao lado do separador Ferramentas , selecione Configurar entradas para poder escolher como fornecer entradas para as ações selecionadas.

Para cada parâmetro de ação, selecione Utilizador ou Agente. Para provisionamento automático, selecione Agente para todas as entradas.

Option	Description
Utilizador	Os humanos fornecem os valores de entrada em tempo de execução.
Agente	Os agentes inferem e fornecem os valores de entrada a partir do contexto em tempo de execução.

Note

Nem todas as ações oferecem a opção de especificar o fornecedor de entrada.

Para salvar as alterações, selecione Atualizar.
Continue a testar o seu conector de servidor MCP.

Teste o seu conector de servidor MCP

Não precisas de um cliente MCP separado para testar o teu conector e ferramentas de servidor MCP. Em vez disso, use o playground incorporado para inicializar o servidor MCP, visualizar as ferramentas ativadas, executar chamadas de ferramentas e rever os resultados de pedidos e respostas.

No portal de Espaços de Nomes de Conectores, aceda ao seu conector de servidor MCP.
Antes de começar os testes, permita o acesso ao parque infantil:
1. No separador Definições , na secção de Autenticação , encontre a definição da chave API .
2. Muda a chave API de Desabilitada para Ativada.
Ao lado do nome do conector do servidor MCP, selecione o botão Playground agora ativado.

Para interagir com as ferramentas de conector, execute os seguintes comandos:

Comando	Action
Inicializar	Inicia o servidor MCP.
Ferramentas de lista	Lista as ferramentas ativadas.
Ferramenta de chamada	Na barra de comandos, no separador Ferramentas , expanda cada ferramenta, selecione ferramenta de chamada e forneça as entradas de parâmetros necessárias.

Para confirmar que o seu conector de servidor MCP funciona como espera, reveja os dados de pedidos e respostas nos resultados da ferramenta.

Por exemplo:

Comentários

Esta página foi útil?

Última atualização a 2026-08-13