Registre e descubra servidores MCP remotos em seu inventário de API

Este artigo descreve como usar a Central de API do Azure para manter um inventário (ou registro) de servidores MCP (protocolo de contexto de modelo remoto) e ajudar as partes interessadas a descobri-los usando o portal da Central de API. Os servidores MCP expõem APIs de back-end ou fontes de dados de forma padrão para agentes e modelos de IA que os consomem.

Sobre os servidores MCP

Os agentes de IA estão se tornando amplamente adotados por causa dos recursos aprimorados de modelo de linguagem grande (LLM). No entanto, mesmo os modelos mais avançados enfrentam limitações devido ao seu isolamento de dados externos. Cada nova fonte de dados potencialmente requer implementações personalizadas para extrair, preparar e tornar os dados acessíveis para os modelos.

O protocolo de contexto de modelo (MCP) ajuda a resolver esse problema. O MCP é um padrão aberto para conectar modelos e agentes de IA com fontes de dados externas, como fontes de dados locais (bancos de dados ou arquivos de computador) ou serviços remotos (sistemas disponíveis na internet, como bancos de dados remotos ou APIs).

Arquitetura MCP

O MCP segue uma arquitetura cliente-servidor em que um aplicativo host pode se conectar a vários servidores. Sempre que seu host ou cliente MCP precisar de uma ferramenta, ele se conecta ao servidor MCP. Em seguida, o servidor MCP se conecta, por exemplo, a um banco de dados ou a uma API. Os anfitriões e servidores MCP ligam-se uns aos outros através do protocolo MCP.

A arquitetura MCP é construída no JSON-RPC 2.0 para mensagens. A comunicação entre clientes e servidores ocorre em camadas de transporte definidas e suporta principalmente dois modos de operação:

• Servidores MCP remotos - os clientes MCP se conectam aos servidores MCP pela Internet, estabelecendo uma conexão usando HTTP e eventos enviados pelo servidor (SSE) e autorizando o acesso do cliente MCP aos recursos na conta do usuário usando OAuth.

• Servidores MCP locais Os clientes MCP se conectam a servidores MCP na mesma máquina, usando entrada/saída padrão como um método de transporte local.

Registrar manualmente um servidor MCP em seu inventário de API

As seções a seguir descrevem como inventariar manualmente um servidor MCP remoto em seu centro de API.

Tipo de API MCP

Registre manualmente um servidor MCP em seu inventário do centro de APIs, semelhante à maneira como você registra outras APIs, especificando o tipo de API como MCP. Para registrar uma API usando o portal do Azure, consulte Tutorial: Registrar APIs em seu inventário de API.

Conforme descrito nas seções a seguir, ao registrar um servidor MCP, você pode especificar um ambiente, implantação e definição.

Ambiente e implantação para servidor MCP

Na Central de APIs, especifique um ambiente e uma implantação para seu servidor MCP. O ambiente é o local do servidor MCP, como uma plataforma de gestão de API ou um serviço de computação, e o deployment é uma URL de execução para o serviço MCP.

Para obter informações sobre como criar um ambiente e uma implantação, consulte Tutorial: Adicionar ambientes e implantações para APIs.

Definição para servidor MCP remoto

Opcionalmente, adicione uma definição de API para um servidor MCP remoto no formato OpenAPI 3.0. A definição de API deve incluir um endpoint de URL para o servidor MCP. Para obter um exemplo de adição de uma definição de OpenAPI, consulte Tutorial: Registrar APIs em seu inventário de APIs.

Você pode usar a seguinte definição de API OpenAPI 3.0 simplificada para o seu servidor MCP, que inclui um endpoint url para o servidor MCP:

{
  "openapi": "3.0.0",
  "info": {
    "title": "Demo MCP server",
    "description": "Very basic MCP server that exposes mock tools and prompts.",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://my-mcp-server.contoso.com"
    }
  ]
}

Registrar um servidor MCP parceiro

A Central de API do Azure fornece uma lista selecionada de servidores MCP parceiros que você pode adicionar ao seu inventário de API. Esta lista inclui servidores MCP de serviços da Microsoft, como Aplicativos Lógicos do Azure, GitHub e outros.

Registre um ou mais dos servidores MCP parceiros em seu inventário de API para disponibilizá-los para desenvolvedores e outras partes interessadas em sua organização.

Para registrar um servidor MCP parceiro:

1. No portal do Azure, navegue até o centro de APIs.
2. No menu da barra lateral, em Descobrir, selecione MCP (visualização).
3. Navegue pelos servidores MCP parceiros disponíveis. Selecione Registrar para adicionar um servidor MCP ao seu inventário de API. Siga as instruções no ecrã, se fornecidas, para concluir o registo.

Quando você adiciona um servidor MCP parceiro, a Central de API configura automaticamente o seguinte para você:

• Cria uma entrada de API em seu inventário de API com o tipo de API definido como MCP.
• Cria um ambiente e uma implantação para o servidor MCP.
• Adiciona uma definição de OpenAPI para o servidor MCP, se disponível do parceiro.

Para criar e registrar um servidor MCP de Aplicativos Lógicos, consulte Criar e registrar um servidor MCP de Aplicativos Lógicos.

Descubra servidores MCP usando o portal do Centro de API

Configure o portal do Centro de API para que os desenvolvedores e outras partes interessadas em sua organização possam descobrir servidores MCP em seu inventário de API. Os usuários podem procurar e filtrar servidores MCP no inventário e exibir detalhes, como o ponto de extremidade de URL do servidor MCP, se disponível na definição de API do servidor MCP.

Conteúdo relacionado

• Sobre servidores MCP no Gerenciamento de API
• Importar APIs para o seu centro de API a partir do Gerenciamento de API
• Use a extensão do Visual Studio para o Centro de API para criar e registrar APIs do Visual Studio Code.
• Para obter um exemplo ao vivo de como o Centro de API do Azure pode alimentar seu registro MCP privado pronto para a empresa, visite o Centro MCP.