Descubra APIs com o servidor MCP do Azure API Center

O servidor MCP do Azure API Center expõe o catálogo de APIs da sua organização como uma superfície nativa de ferramentas para agentes de IA e fluxos de trabalho agentivos. Ao ativar o servidor MCP do API Center, torna as suas APIs e ativos de IA identificáveis pelo ecossistema crescente de clientes de IA compatíveis com MCP, incluindo Visual Studio Code Copilot, Claude Code e agentes personalizados.

O servidor MCP do Azure API Center expõe as seguintes ferramentas que os agentes utilizam para descobrir e recuperar ativos do inventário (registo) do seu centro de API.

Pré-requisitos

• Um centro de API na sua subscrição do Azure. Se você não tiver um, consulte Guia de início rápido: criar sua central de API.

• Uma ou mais APIs ou ativos de IA registados no inventário do seu centro de API, como servidores MCP ou competências.

• O portal do centro de API foi ativado e configurado para o seu centro de API. Para mais detalhes, consulte Configurar e personalizar o portal do seu API Center. O método de acesso que escolhe para o portal (autenticação anónima ou Microsoft Entra ID) determina como os programadores se autenticam quando acedem ao servidor MCP.

• Um cliente compatível com MCP, como Visual Studio Code com Copilot, Claude Code ou um agente personalizado.

• Para utilização da CLI, certifique-se de que a ferramenta MCP CLI está instalada.

Ativar o servidor MCP do Azure API Center

Para ativar o servidor MCP usando o portal Azure:

1. No portal Azure, vai ao teu centro de API.
2. No menu lateral, em Consumo, selecione Definições da API de Dados.
3. Em endpoint MCP, selecione Enable API Center endpoint MCP.

O endpoint do servidor MCP segue esta forma:

https://<service name>.data.<region>.azure-apicenter.ms/mcp

Exemplo: https://myapicenter.data.eastus.azure-apicenter.ms/mcp

Liga-te ao servidor MCP

Depois de ativar o servidor MCP do API Center, os programadores podem descobrir o endpoint do servidor MCP quando iniciam sessão no portal do API Center. Os programadores podem ligar-se ao servidor MCP usando um cliente MCP como o Visual Studio Code ou a CLI MCP. A ligação requer o endpoint do servidor MCP e as credenciais de autenticação apropriadas, se configuradas.

Para se ligar ao servidor MCP usando o Claude Code, veja Adicionar um servidor MCP ao Claude Code.

Liga-te via VS Code

Os programadores podem adicionar a configuração do MCP Server ao seu ficheiro Visual Studio Code settings.json sob a tecla mcp.

1. Abra Visual Studio Code e pressione Ctrl+Shift+P (ou Cmd+Shift+P no Mac).

2. Procure por Definições de Utilizador Abertas (JSON).

3. Cola o seguinte trecho por baixo da mcp chave e guarda o ficheiro. Substitua o valor url pelo endpoint do servidor MCP do seu API Center.

   {
     "servers": {
       "api-center": {
         "url": "https://myapicenter.data.eastus.azure-apicenter.ms/mcp",
         "type": "http"
       }
     },
     "inputs": []
   }
   

4. O VS Code Copilot deteta e liga-se automaticamente ao servidor MCP.

Liga-te via CLI

Os programadores podem usar a CLI MCP para se ligar diretamente ao servidor e invocar as ferramentas do registo.

1. Liga-te ao servidor MCP usando um comando como o exemplo seguinte. Substitua a URL pelo endpoint do servidor MCP do teu API Center.

   mcp connect http https://myapicenter.data.eastus.azure-apicenter.ms/mcp
   

2. Pesquisar no registo de ativos:

   mcp run mcp_registry_search --query "customer-support"
   

3. Obter detalhes para um ativo específico:

   mcp run mcp_registry_fetch --id "my-agent-skill"
   

Conteúdo relacionado

• Configure e personalize o seu portal do API Center
• Permitir a descoberta de plugins do API Center a partir de um mercado de plugins