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

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.

MCP-arkitekturen 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.

Registrera en MCP-server manuellt i API-inventeringen

I följande avsnitt beskrivs hur du manuellt inventar en mcp-fjärrserver i API-centret.

TYP AV MCP-API

Registrera en MCP-server manuellt i API Center-inventeringen på samma sätt som du registrerar andra API:er och ange 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.

Tip

Om du hanterar MCP-servrar i Azure API Management kan du aktivera automatisk synkronisering för att hålla DITT API Center uppdaterat med MCP-servrar och andra API:er från din API Management-instans. Mer information finns i Synkronisera API:er från Azure API Management-instansen.

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

Registrera en MCP-partnerserver

Azure API Center innehåller en lista över partner-MCP-servrar som du kan lägga till i API-inventeringen. Den här listan innehåller MCP-servrar från Microsoft-tjänster som Azure Logic Apps, GitHub och andra.

Registrera en eller flera av MCP-partnerservrarna i DIN API-inventering för att göra dem tillgängliga för utvecklare och andra intressenter i din organisation.

Skärmbild av MCP-partnerservrar i portalen.

Så här registrerar du en MCP-partnerserver:

  1. I Azure-portalen navigerar du till ditt API-center.
  2. I sidomenyn under Identifiera väljer du MCP (förhandsversion).
  3. Bläddra bland de tillgängliga MCP-partnerservrarna. Välj Registrera för att lägga till en MCP-server i API-inventeringen. Följ anvisningarna på skärmen om de tillhandahålls för att slutföra registreringen.

När du lägger till en MCP-partnerserver konfigurerar API Center automatiskt följande åt dig:

  • Skapar en API-post i API-inventeringen med API-typen inställd på MCP.
  • Skapar en miljö och en distribution för MCP-servern.
  • Lägger till en OpenAPI-definition för MCP-servern om den är tillgänglig från partnern.

Information om hur du skapar och registrerar en Logic Apps MCP-server finns i Skapa och registrera en Logic Apps MCP-server.

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.

Note

URL-slutpunkten för MCP-servern visas endast i API Center-portalen om en MCP-distribution och en API-definition för MCP-servern konfigureras i API-centret.

Relaterat innehåll