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

Important

Esse recurso em versão prévia está sujeito aos Termos de Uso Suplementares para Versões Prévias do Microsoft Azure. Durante a versão prévia, essa funcionalidade está disponível apenas nas regiões públicas do Azure.

Para automação e integração, agentes de IA precisam de ferramentas que possam chamar outros serviços e sistemas com segurança. No entanto, construir e manter servidores gerenciados separadamente com o Protocolo de Contexto Modelo (MCP), definir ferramentas e gerenciar credenciais para cada integração adiciona uma sobrecarga e complexidade significativas. O Espaço de Nomes de Conectores resolve esse problema hospedando e gerenciando centralmente servidores MCP como conectores para você. Em um recurso de namespace de conectores, você pode criar um conector de servidor MCP escolhendo um conector pré-construído, que oferece ações como ferramentas que agentes e serviços Azure podem chamar com segurança – sem precisar de código de servidor personalizado ou outra infraestrutura.

Em um namespace de conectores, você pode criar os seguintes tipos de conectores de servidor MCP:

Tipo Description
Gerenciado Esse 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 configuração mínima.
Configurável Esse conector de servidor MCP inclui apenas as ações que você escolhe do conector pré-construído selecionado para que agentes possam chamar como ferramentas. Você também pode controlar se agentes ou humanos fornecem entradas de ferramenta.

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

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

Pré-requisitos

Limitações e problemas conhecidos

Esta versão permite escolher apenas um conector para criar seu conector de servidor MCP.

Criar um conector de servidor MCP

  1. Na caixa de busca do portal do Azure, insira connector namespaces, e selecione Espaços de Nomes do Conector.

  2. Encontre e selecione o recurso de namespace do seu conector.

    O portal de Espaços de Nomes de Conectores se abre e mostra a página de visão geral do seu espaço de nomes de conectores.

  3. Na página de visão geral do namespace, na seção de conectores MCP , selecione + Criar.

    Por exemplo:

    A captura de tela mostra o portal de Espaços de Nomes de Conectores com a página de Visão Geral aberta, a seção de Conectores MCP e o botão Criar selecionado.

    A janela a seguir se abre e mostra conectores pré-construídos onde você pode escolher um para criar seu servidor MCP:

    A captura de tela mostra a janela Escolher o conector onde você escolhe um conector para usar.

  4. Continue com os passos para um conector gerenciado ou configurável.

Os passos a seguir 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:

  1. Na janela MCP Connector - Escolher Conector, na caixa de busca, selecione Gerenciado para visualizar conectores gerenciados pelo Azure.

    A captura de tela mostra a janela MCP Connector - Choose Connector com filtro Gerenciado selecionado para mostrar apenas conectores gerenciados.

  2. Encontre e selecione o conector gerenciado que você deseja, como Office 365 Outlook.

  3. Siga o prompt para autenticar a conexão com suas credenciais.

  4. Depois que o portal criar seu conector, selecione Criar outro ou Feito.

  5. Continue testando seu conector de servidor MCP.

Teste seu conector de servidor MCP

Você não precisa de um cliente MCP separado para testar seu conector e ferramentas de servidor MCP. Em vez disso, use o playground embutido para inicializar o servidor MCP, visualizar as ferramentas habilitadas, executar chamadas de ferramenta e revisar os resultados de requisição e resposta.

  1. No portal de Namespaces do Conector, vá para o conector do seu servidor MCP.

  2. Antes de começar os testes, permita o acesso ao parquinho:

    1. Na aba Configurações , na seção Autenticação , encontre a configuração da chave da API .

    2. Mude a chave da API de Desabilitada para Habilitada.

  3. Ao lado do nome do seu conector de servidor MCP, selecione o botão Playground agora ativado.

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

    Comando Ação
    inicializar Inicie o servidor MCP.
    Ferramentas de lista Liste as ferramentas habilitadas.
    Ferramenta de chamada Na barra de comandos, na aba Ferramentas , expanda cada ferramenta, selecione ferramenta Chamada e forneça as entradas de parâmetros necessárias.
  5. Para confirmar que seu conector de servidor MCP funciona como você espera, revise os dados de solicitação e resposta nos resultados da ferramenta.

    Por exemplo:

    A captura de tela mostra a página do Playground com o conector Office 365 Outlook servidor MCP e os painéis abertos de solicitação e resposta.