在您的 API 庫存中註冊並發現 MCP 伺服器

本文說明如何利用 Azure API 中心來維護遠端或本地模型情境協定（MCP）伺服器的清單（或註冊資料），並協助利害關係人透過 API Center 入口網站發現這些伺服器。 MCP 伺服器會以標準方式向取用它們的 AI 代理程式和模型公開後端 API 或數據源。

如本文所示，你可以透過 Azure 入口網站註冊遠端或本地 MCP 伺服器，類似註冊 API 及其他資產的方式。 API 中心也提供連結至合作夥伴的 MCP 伺服器，您可以註冊在清單中。

關於 MCP 伺服器

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

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

MCP 架構

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

MCP 架構是以 JSON-RPC 2.0 為基礎來建置的。 用戶端與伺服器之間的通訊會透過定義的傳輸層進行，且主要支援兩種作業模式：

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

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

先決條件

• API 中心。 如果你還沒有 API 中心，請參考快速入門的「 建立 API 中心」。
• 一個遠端 MCP 伺服器 URL 端點，或是你想註冊的 MCP 伺服器套件。
• （針對遠端 MCP 伺服器） 在你的 API 中心建立一個環境，可以與 MCP 伺服器連結。 環境是 MCP 伺服器的位置，例如 API 管理平台或運算服務。

註冊遠端 MCP 伺服器

要註冊遠端 MCP 伺服器：

1. 登入 Azure 入口網站，然後前往你的 API 中心。
2. 在側邊欄選單中，在 「物品欄」中選擇 「資產」。
3. 選擇 + 註冊資產>MCP 伺服器。
   
4. 在 註冊 MCP 伺服器 表單中，提供關於 MCP 伺服器的資訊：
   1. 為 MCP 伺服器輸入標題。 API Center 會根據標題自動產生識別碼，但你也可以在需要時編輯。
   2. 輸入 MCP 伺服器的 摘要 與 描述 ，以提供更多相關背景資訊。
   3. 可選擇輸入 圖示 URL ，將圖片與 MCP 伺服器關聯。
   4. 在 使用案例中，可選擇性地為一個或多個 MCP 伺服器的使用案例提供名稱與描述。
   5. 在 遙控器中，請執行以下操作：
      1. 選擇 + 新增遙控器。
      2. 輸入 MCP 伺服器的 執行時 URL 。
      3. 選擇與 MCP 伺服器所在地對應的 API 中心 環境 ，例如 API 管理平台或運算服務。
      4. 選取 [儲存]。
      5. 若 MCP 伺服器有多個端點或部署於多個環境，則可選擇重複前述步驟以增加更多遠端節點。
   6. 可選擇 新增儲存庫 ，提供與 MCP 伺服器相關聯的程式碼儲存庫的網址。
   7. 在 版本標題中，提供 MCP 伺服器的 版本標題、 版本識別及 版本生命週期 。 在 API Center 了解更多版本資訊。
   8. 可選擇性地新增 授權 與 外部文件 連結及相關資訊，以支援 MCP 伺服器。
   9. 選取 ，創建。

遠端 MCP 伺服器的定義

API Center 會自動為遠端 MCP 伺服器產生以下 OpenAPI 定義，並將其與你註冊的伺服器版本關聯起來：

• SSE 定義，用於使用伺服器發送事件（SSE）作為代理協定
• 可串流定義，用於使用傳輸無關的代理協定

註冊本地 MCP 伺服器

你可以使用像 npm or 這樣的 pypi套件管理器註冊本地安裝的 MCP 伺服器。

要註冊本地 MCP 伺服器：

1. 登入 Azure 入口網站，然後前往你的 API 中心。
2. 在側邊欄選單中，在 「物品欄」中選擇 「資產」。
3. 選擇 + 註冊資產>MCP 伺服器。
4. 在 註冊 MCP 伺服器 表單中，提供關於 MCP 伺服器的資訊：
   1. 為 MCP 伺服器輸入標題。 API Center 會根據標題自動產生識別碼，但你也可以在需要時編輯。
   2. 輸入 MCP 伺服器的 摘要 與 描述 ，以提供更多相關背景資訊。
   3. 可選擇輸入 圖示 URL ，將圖片與 MCP 伺服器關聯。
   4. 在 使用案例中，可選擇性地為一個或多個 MCP 伺服器的使用案例提供名稱與描述。
   5. 在 「套件」中，請執行以下操作：
      1. 選擇 + 新增套件。
      2. 輸入一個套件 登錄檔 以安裝 MCP 伺服器。 例如： npm 。
      3. 從套件登錄檔輸入 一個套件名稱 和 一個版本。
      4. 在 執行時提示中，輸入用於執行 MCP 伺服器的執行指令。 例如： npx 。
      5. 在 執行時參數中，執行 MCP 伺服器時可選擇傳遞參數。
      6. 選取 [儲存]。
      7. 若 MCP 伺服器存在多個套件登錄檔或有多個版本，則可選擇重複上述步驟以新增更多套件。
   6. 可選擇 新增儲存庫 ，提供與 MCP 伺服器相關聯的程式碼儲存庫的網址。
   7. 在 版本標題中，提供 MCP 伺服器的 版本標題、 版本識別及 版本生命週期 。 在 API Center 了解更多版本資訊。
   8. 可選擇性地新增 授權 與 外部文件 連結及相關資訊，以支援 MCP 伺服器。
   9. 選取 ，創建。

註冊合作夥伴 MCP 伺服器

Azure API Center 提供一份精選的合作夥伴 MCP 伺服器清單，您可以將它們加入您的 API 庫存中。 此清單包含來自 Microsoft 服務 如 Azure Logic Apps、GitHub 等的 MCP 伺服器。

在 API 詳細目錄中註冊一或多個合作夥伴 MCP 伺服器，以便組織中的開發人員和其他利害關係人可以使用這些伺服器。

若要註冊合作夥伴 MCP 伺服器：

1. 在 Azure 入口網站，前往你的 API 中心。
2. 在側邊欄選單中，在 「發現」下，選擇 MCP。
3. 瀏覽可用的合作夥伴 MCP 伺服器。 選取 註冊 以 將 MCP 伺服器新增至您的 API 庫存。 若螢幕上提供指示，請依指示完成註冊。

當您新增合作夥伴 MCP 伺服器時，API Center 會自動為您配置以下設定：

• 在 API 詳細目錄中建立 API 項目，並將 API 類型設定為 MCP。
• 建立 MCP 伺服器的環境和部署。
• 若合作夥伴提供 OpenAPI 定義，則為 MCP 伺服器新增 OpenAPI 定義。

建立並註冊您自己的 MCP 伺服器

要使用 Azure 運算服務建置 MCP 伺服器並在 API 中心註冊，請參考以下範例：

• 建置並註冊一個 Logic Apps MCP 伺服器
• 建置並註冊一台Azure Functions MCP 伺服器

同步 API 來源的 MCP 伺服器

為了自動化 MCP 註冊並保持庫存最新，你可以將以下上游來源整合至 API 中心：

• Azure API 管理：如果你在 Azure API 管理 管理 MCP 伺服器，可以啟用自動同步，讓 API 中心保持最新。 欲了解更多，請參閱 從 Azure API 管理實例同步 API。

• Git 倉庫：對於儲存在 Git 倉庫中的 MCP 伺服器及其他 AI 資產，您可以啟用自動同步，以保持 API 中心的即時更新。 更多資訊請參閱 從 Git 倉庫同步 API 資產。

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

建立您的 API 中心入口網站 ，讓開發者及組織中的其他利害關係人能夠瀏覽並篩選庫存中的 MCP 伺服器。

• 使用者可以查看 MCP 伺服器的 URL 端點及工具結構等細節，並在 Visual Studio Code 環境中安裝 MCP 伺服器。

• 內建 的測試主控台 讓使用者能測試 MCP 伺服器工具，並直接在入口網站查看回應結果。 在 MCP 伺服器詳細頁面 的文件標籤中 ，選擇一個工具，然後 選擇執行工具 以進入測試主控台。

管理對 MCP 伺服器的存取

可選擇性地使用 API Center 的存取管理功能，管理誰可以查看及存取你庫存中的 MCP 伺服器。 更多資訊，請參閱 在您的 API 中心授權存取 API。

設定 MCP 登錄檔元資料

Azure API Center 會提供一個 MCP 登錄端點，你可以在 Visual Studio Code、GitHub Copilot 或其他工具中設定，來發現並連接庫存中的 MCP 伺服器。

登錄端點的網址格式如下：

https://<your-api-center-name>.data.<region>.azure-apicenter.ms/workspaces/default/v0.1/servers

範例：https://contoso-api-center.data.eastus.azure-apicenter.ms/default/v0.1/servers

MCP 登錄檔儲存 MCP 伺服器的標準發現與配置元資料，如伺服器名稱、URL 及傳輸類型。 你可以選擇性地透過設定自訂屬性來擴充元資料，這些屬性會出現在 _meta MCP 伺服器對工具呼叫的回應區塊中。 你可以將 API 中心的元資料屬性映射成結構化命名空間，供 MCP 用戶端使用。

若要設定 自訂中繼資料屬性 顯示於 MCP 伺服器回應的 _meta 區段中：

1. 在 Azure 入口網站，前往你的 API 中心。
2. 在側邊欄選單中，在 「發現」選項中，選擇 MCP 登錄檔。
3. 選擇 + 配置。
4. 要定義命名空間路徑，請選擇 + 新增路徑。
   1. 要新增自訂中繼資料屬性，請選擇 + 新增屬性 並選擇自訂中繼資料屬性。 也可以選擇重複這個步驟，以增加多個屬性。
   2. 可選擇性地新增命名空間的子路徑。 選擇 + 新增子路徑 ，重複前述步驟，在子路徑下新增屬性。
5. 請透過預覽面板確認設定。
6. 選取 [儲存]。

相關內容

• 關於 API 管理中的 MCP 伺服器
• 從 API 管理將 API 匯入至 API 中心
• 使用 API Center 的 Visual Studio 擴充功能來建立並註冊 Visual Studio Code 的 API。
• 想了解 Azure API Center 如何驅動您的私人、企業級 MCP 登錄檔，請前往 MCP Center。