Registrar e descobrir servidores MCP remotos em seu inventário de API

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

Sobre servidores MCP

Os agentes de IA estão se tornando amplamente adotados devido a funcionalidades avançadas de LLM (modelo de linguagem grande). No entanto, mesmo os modelos mais avançados enfrentam limitações devido ao isolamento dos 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 MCP ( protocolo de contexto de modelo ) 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 pela Internet, como bancos de dados remotos ou APIs).

Arquitetura do MCP

O MCP segue uma arquitetura cliente-servidor em que um aplicativo host pode se conectar a vários servidores. Sempre que o cliente ou o host MCP precisar de uma ferramenta, ele se conecta ao servidor MCP. Em seguida, o servidor MCP se conecta a, por exemplo, um banco de dados ou uma API. Hosts e servidores MCP se conectam entre si por meio do protocolo MCP.

A arquitetura do MCP é criada no JSON-RPC 2.0 para mensagens. A comunicação entre clientes e servidores ocorre em camadas de transporte definidas e dá suporte principalmente a dois modos de operação:

• Servidores MCP remotos – os clientes MCP se conectam a 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 o OAuth.

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

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

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

Tipo de API do MCP

Registre manualmente um servidor MCP no inventário do seu centro de API 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 o servidor MCP

No Centro de API, especifique um ambiente e uma implantação para o servidor MCP. O ambiente é o local do servidor MCP, como uma plataforma de gerenciamento de API ou um serviço de computação, e a implantação é uma URL de runtime 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 do 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 como adicionar uma definição de OpenAPI, consulte Tutorial: Registrar APIs em seu inventário de API.

Você pode usar a seguinte definição de API OpenAPI 3.0 com leveza para 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 do parceiro

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

Registre um ou mais servidores MCP parceiros no seu inventário de API para disponibilizá-los para desenvolvedores e outros stakeholders na sua organização.

Para registrar um servidor MCP parceiro:

1. No portal do Azure, navegue até o centro de API.
2. No menu da barra lateral, em Descobrir, selecione MCP (versão prévia).
3. Navegue pelos servidores MCP do parceiro disponíveis. Selecione Registrar para adicionar um servidor MCP ao inventário da sua API. Siga as instruções na tela se for fornecido para concluir o registro.

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

• Cria uma entrada de API no 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.

Descobrir servidores MCP usando o portal do Centro de API

Configure o portal do Centro de API para que os desenvolvedores e outros stakeholders em sua organização possam descobrir servidores MCP no 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 da API do servidor MCP.

Conteúdo relacionado

• Sobre servidores MCP no Gerenciamento de API
• Importar APIs para o centro de API 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 dinâmico de como o Centro de API do Azure pode alimentar seu registro MCP privado e pronto para a empresa, visite o MCP Center.