共用方式為


在您的 API 清查中註冊和探索遠端 MCP 伺服器

本文說明如何使用 Azure API 中心來維護遠端模型內容通訊協定 (MCP) 伺服器的清查(或 登錄),並協助專案關係人使用 API 中心入口網站來探索它們。 MCP 伺服器會以標準方式向取用它們的 AI 代理程式和模型公開後端 API 或數據源。

關於 MCP 伺服器

AI 代理程式正因為增強的大型語言模型 (LLM) 功能而廣為採用。 不過,即使是最進階的模型,也會因為與外部數據隔離而面臨限制。 每個新的數據源都可能需要自定義實作來擷取、準備及讓數據可供模型存取。

模型內容通訊協定 (MCP) 可協助解決此問題。 MCP 是一個開放標準,可連接 AI 模型和代理程式與外部數據源,例如本機數據源(資料庫或計算機檔案)或遠端服務(因特網上可用的系統,例如遠端資料庫或 API)。

MCP 架構

下圖說明 MCP 架構:

模型內容通訊協定 (MCP) 架構的圖表。

此架構由下列元件組成:

元件 說明
MCP 主機 需要存取外部功能的 LLM 應用程式,例如 IDE 中的聊天應用程式或 AI 助理(例如 Visual Studio Code 中的 GitHub Copilot)
MCP 用戶端 主機應用程式內的通訊協定用戶端,可維護與伺服器的 1:1 連線
MCP 伺服器 每個公開特定功能的輕量型程式,並提供內容、工具和提示給用戶端
MCP 通訊協定 中間的傳輸層

MCP 遵循用戶端伺服器架構,其中主應用程式可以連線到多部伺服器。 每當 MCP 主機或用戶端需要工具時,它就會連線到 MCP 伺服器。 MCP 伺服器接著會連線到資料庫或 API。 MCP 主機和伺服器會透過 MCP 通訊協定彼此連線。

遠端與本機 MCP 伺服器

MCP 會利用建置在 JSON-RPC 2.0 上的用戶端-主機-伺服器架構來進行傳訊。 用戶端與伺服器之間的通訊會透過定義的傳輸層進行,且主要支援兩種作業模式:

  • 遠端 MCP 伺服器 - MCP 用戶端會透過因特網連線到 MCP 伺服器、使用 HTTP 和伺服器傳送的事件建立連線(SSE),以及使用 OAuth 授權 MCP 用戶端存取使用者帳戶上的資源。

  • 本機 MCP 伺服器 MCP 用戶端會使用標準輸入/輸出作為本機傳輸方法,連線到相同電腦上的 MCP 伺服器。

API 清單中的 MCP 伺服器

下列各節說明如何在 API 中心清查和探索遠端 MCP 伺服器。

MCP API 類型

若要在 API 中心清查中註冊 MCP 伺服器,請將 API 類型指定為 MCP。 若要使用 Azure 入口網站註冊 API,請參閱 教學課程:在 API 清查中註冊 API

如下列各節所述,當您註冊 MCP 伺服器時,您可以指定環境、部署和定義。

MCP 伺服器的環境和部署

在 API 中心中,指定 MCP 伺服器的環境部署 。 環境是 MCP 伺服器的位置,例如 API 管理平臺或計算服務,而部署是 MCP 服務的運行時間 URL。

如需建立環境和部署的相關信息,請參閱 教學課程:新增 API 的環境和部署

遠端 MCP 伺服器的定義

或者,使用 OpenAPI 3.0 格式新增遠端 MCP 伺服器的 API 定義。 API 定義必須包含 MCP 伺服器的 URL 端點。 如需新增OpenAPI定義的範例,請參閱 教學課程:在API清查中註冊 API

您可以針對 MCP 伺服器使用下列輕量型 OpenAPI 3.0 API 定義,其中包含 url 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"
    }
  ]
}

使用 API 中心入口網站探索 MCP 伺服器

設定 API 中心入口網站 ,讓組織中的開發人員和其他項目關係人可以在 API 清查中探索 MCP 伺服器。 用戶可以在清查中瀏覽和篩選 MCP 伺服器,並檢視 MCP 伺服器的 URL 端點等詳細數據,如果 MCP 伺服器的 API 定義中有提供的話。

API 中心入口網站中 MCP 伺服器的螢幕快照。

備註

只有在您為 MCP 伺服器新增 MCP 部署和 MCP 伺服器的 API 定義時,才能在 API 中心入口網站中看到 MCP 伺服器的 URL 端點。