Dela via

Registrera och identifiera fjärranslutna MCP-servrar i API-inventeringen

Den här artikeln beskriver hur du använder Azure API Center för att underhålla en inventering (eller ett register) av MCP-servrar (Remote Model Context Protocol) och hjälper intressenter att identifiera dem med hjälp av API Center-portalen. MCP-servrar exponerar serverdels-API:er eller datakällor på ett standard sätt för AI-agenter och modeller som använder dem.

Om MCP-servrar

AI-agenter börjar bli allmänt antagna på grund av förbättrade funktioner för stor språkmodell (LLM). Men även de mest avancerade modellerna har begränsningar på grund av sin isolering från externa data. Varje ny datakälla kräver potentiellt anpassade implementeringar för att extrahera, förbereda och göra data tillgängliga för modellerna.

MCP (Model Context Protocol) hjälper dig att lösa det här problemet. MCP är en öppen standard för att ansluta AI-modeller och agenter till externa datakällor som lokala datakällor (databaser eller datorfiler) eller fjärrtjänster (system som är tillgängliga via Internet, till exempel fjärrdatabaser eller API:er).

MCP-arkitektur

Följande diagram illustrerar MCP-arkitekturen:

Diagram över MCP-arkitektur (Model Context Protocol).

Arkitekturen består av följande komponenter:

Komponent Beskrivning
MCP-värdar LLM-program som chattappar eller AI-assistenter i dina IDE:er (till exempel GitHub Copilot i Visual Studio Code) som behöver åtkomst till externa funktioner
MCP-klienter Protokollklienter i värdprogrammet som underhåller 1:1-anslutningar med servrar
MCP-servrar Lätta program som var och en exponerar specifika funktioner och ger kontext, verktyg och uppmaningar till klienter
MCP-protokoll Transportskikt i mitten

MCP följer en klient-server-arkitektur där ett värdprogram kan ansluta till flera servrar. När MCP-värden eller MCP-klienten behöver ett verktyg ansluter den till MCP-servern. MCP-servern ansluter sedan till till exempel en databas eller ett API. MCP-värdar och -servrar ansluter till varandra via MCP-protokollet.

Fjärr- och lokala MCP-servrar

MCP använder en klient-värd-server-arkitektur som bygger på JSON-RPC 2.0 för meddelanden. Kommunikationen mellan klienter och servrar sker över definierade transportlager och stöder främst två driftslägen:

  • Fjärr-MCP-servrar – MCP-klienter ansluter till MCP-servrar via Internet, upprättar en anslutning med HTTP- och serverutskickade händelser (SSE) och ger MCP-klienten åtkomst till resurser på användarens konto med hjälp av OAuth.

  • Lokala MCP-servrar MCP-klienter ansluter till MCP-servrar på samma dator med standardindata/utdata som en lokal transportmetod.

MCP-servrar i API-inventeringen

I följande avsnitt beskrivs hur du inventar och identifierar en fjärransluten MCP-server i API Center.

TYP AV MCP-API

Om du vill registrera en MCP-server i API Center-inventeringen anger du API-typen som MCP. Information om hur du registrerar ett API med hjälp av Azure-portalen finns i Självstudie: Registrera API:er i api-inventeringen.

Som beskrivs i följande avsnitt kan du ange en miljö, distribution och definition när du registrerar en MCP-server.

Miljö och distribution för MCP-server

I API Center anger du en miljö och en distribution för MCP-servern. Miljön är platsen för MCP-servern, till exempel en API-hanteringsplattform eller en beräkningstjänst, och distributionen är en körnings-URL för MCP-tjänsten.

Information om hur du skapar en miljö och en distribution finns i Självstudie: Lägga till miljöer och distributioner för API:er.

Definition för fjärr-MCP-server

Du kan också lägga till en API-definition för en fjärransluten MCP-server i OpenAPI 3.0-format. API-definitionen måste innehålla en URL-slutpunkt för MCP-servern. Ett exempel på hur du lägger till en OpenAPI-definition finns i Självstudie: Registrera API:er i api-inventeringen.

Du kan använda följande enkla OpenAPI 3.0 API-definition för MCP-servern, som innehåller en url slutpunkt för MCP-servern:

{
  "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"
    }
  ]
}

Identifiera MCP-servrar med hjälp av API Center-portalen

Konfigurera API Center-portalen så att utvecklare och andra intressenter i din organisation kan identifiera MCP-servrar i API-inventeringen. Användare kan bläddra bland och filtrera MCP-servrar i inventeringen och visa information, till exempel URL-slutpunkten för MCP-servern, om den är tillgänglig i MCP-serverns API-definition.

Skärmbild av MCP-servern i API Center-portalen.

Anmärkning

URL-slutpunkten för MCP-servern visas endast i API Center-portalen om du lägger till en MCP-distribution och en API-definition för MCP-servern.

Relaterat innehåll