教學：在 Azure Functions 上託管 MCP 伺服器

本文將教你如何在 Azure Functions 上架設遠端 Model Context Protocol（MCP）伺服器。 你也會學習如何利用內建認證來配置伺服器端點授權，並更好地保護你的 AI 工具。

在 Azure Functions 中架設遠端 MCP 伺服器有兩種方式：

本教學涵蓋了 Functions 支援的兩種 MCP 伺服器選項。 選擇最適合你情境的分頁。

uv run func start

func start

npm install
npm run build
func start

遠端 MCP 伺服器授權

有兩種方法可以減少或防止遠端 MCP 伺服器端點被未經授權使用：

啟用 Azure portal 內建的 MCP 認證

Azure 入口網站提供一鍵操作，讓您能設定 MCP 伺服器內建的認證與授權。 此 preview 功能會自動建立並設定 Microsoft Entra ID 作為身份提供者，註冊所需的用戶端應用程式，並為你新增所需的應用程式設定。 使用此功能開啟內建 MCP 認證，會 自動 關閉預設的基於金鑰存取伺服器的權限。

要在 Azure 入口網站啟用內建的 MCP 認證：

1. 在入口網站中開啟伺服器應用程式。

2. 在左側選單，找到 AI（預覽） 分頁。

3. 找到 認證 區塊，點選 啟用 MCP 認證 按鈕。

4. 在開啟的側窗格中，輸入一個獨特的 Entra 應用程式註冊名稱。 需要這個應用程式才能設定驗證。

5. 點 選儲存 ，等待設定完成。

連接伺服器

部署後的彈窗選擇 Connect，Visual Studio Code 會填入 .vscode/mcp.json 伺服器連線資訊。

如果漏掉這個步驟，也可以打開輸出Ctrl/Cmd+Shift+U（）來找到部署日誌末尾的內嵌連線按鈕。

你也可以手動新增連線資訊：

1. 執行以下指令取得伺服器網域：

   az functionapp show --name <FUNCTION_APP_NAME> --resource-group <RESOURCE_GROUP_NAME> --query "defaultHostName" --output tsv
   

2. 在 Visual Studio Code 中，開啟指令面板，搜尋並執行 MCP：新增伺服器... 指令，然後依照以下提示操作：

   • MCP 擴充伺服器
   • 自架伺服器

   Prompt	建議
   待新增伺服器類型	HTTP
   你的 MCP 伺服器網址	https://<FUNCTION_APP_NAME>.azurewebsites.net/runtime/webhooks/mcp
   伺服器名稱	遠端-MCP-伺服器
   伺服器安裝地點	Workspace

3. Visual Studio Code 會幫你打開 mcp.json 設定檔。

根據你設定的認證方式，請依照下一節的指示連接到伺服器。

內建 MCP 認證

1. 透過選擇伺服器名稱上方的 開始 按鈕啟動遠端伺服器。

2. 當系統要求與 Microsoft 進行身份驗證時，選擇允許，然後使用你的電子郵件（即用於登入 Azure 入口的那個）進行登錄。

3. 當你成功連接伺服器時，會看到伺服器名稱上方可用的工具數量。

4. 以代理人模式開啟 Visual Studio Code Copilot 聊天，然後提出問題。 例如： Greet with #your-remote-mcp-server-name 。

5. 測試結束後就停止伺服器。

若想詳細了解 Visual Studio Code 嘗試連接遠端 MCP 伺服器時會發生什麼，請參見 Server 授權協定。

使用存取金鑰

如果你沒有啟用內建的 MCP 認證，伺服器預設應該會使用 Functions 的存取金鑰。 請將存取金鑰包含在伺服器註冊的請求標頭中。

{
	"servers": {
		"remote-mcp-server": {
			"type": "http",
			"url": "https://${input:functionapp-domain}/runtime/webhooks/mcp",
			"headers": {
				"x-functions-key": "${input:functions-key}"
			}
		}
	},
	"inputs": [
		{
			"type": "promptString",
			"id": "functions-key",
			"description": "Functions App Key",
			"password": true
		},
		{
			"type": "promptString",
			"id": "functionapp-domain",
			"description": "The domain of the function app.",
			"password": false
		}
	]
}

{
	"servers": {
		"remote-mcp-server": {
			"type": "http",
			"url": "https://${input:functionapp-domain}/mcp",
			"headers": {
				"x-functions-key": "${input:functions-key}"
			}
		}
	},
	"inputs": [
		{
			"type": "promptString",
			"id": "functions-key",
			"description": "Functions App Key",
			"password": true
		},
		{
			"type": "promptString",
			"id": "functionapp-domain",
			"description": "The domain of the function app.",
			"password": false
		}
	]
}

設定 Microsoft Foundry 代理以使用您的工具

你可以設定 Foundry 代理使用伺服器裡的工具，而不只是 VS Code 裡的 Copilot。 如需逐步操作指示，請參閱 在 Microsoft Foundry 中將 Azure Functions MCP 伺服器作為工具使用。

在 Azure API Center 中註冊伺服器

考慮在 Azure API Center 註冊您的 MCP 伺服器，以維護一個私有的遠端 MCP 伺服器清單，這些伺服器在組織內容易被發現。 如需逐步指示，請參閱 在 Azure API Center 中註冊裝載於 Azure Functions 的 MCP 伺服器。

替代方案：手動設定內建認證

以下說明說明如何手動啟用伺服器應用程式內建的授權與驗證功能，並設定 Microsoft Entra ID 作為身份提供者。 如果你不想使用 一鍵入口網站體驗，請使用這些步驟。

停用基於金鑰的認證

啟用內建認證時，請先關閉預設的金鑰驗證，允許匿名存取。 如果你還沒這麼做，且你的應用程式已經部署，請依照以下指示操作。

az functionapp config appsettings set --name <APP_NAME> --resource-group <RESOURCE_GROUP> \
  --settings "AzureFunctionsJobHost__extensions__mcp__system__webhookAuthorizationLevel=Anonymous"

az functionapp config appsettings set --name <APP_NAME> --resource-group <RESOURCE_GROUP> \
  --settings "AzureFunctionsJobHost__customHandler__http__DefaultAuthorizationLevel=anonymous"

在伺服器應用程式上設定認證

1. 在Azure入口開啟伺服器應用程式，從左側選單選擇Settings>Authentication。

2. 選擇 新增身份提供者>Microsoft 作為身份提供者。

3. 在為您的應用程式及其使用者選擇租戶部分，請選擇員工配置（目前租戶）。

4. 在 應用程式註冊中： 請使用以下設定：

   Setting	Selection
   應用程式註冊類型	建立新的應用程式註冊
   名稱	輸入一個描述性應用程式名稱
   用戶端秘密過期	建議：180天
   支援的帳戶類型	現任租戶 - 單一租戶

5. 在附加檢查：，選擇客戶端應用需求選擇允許特定客戶端應用程式請求，選擇鉛筆圖示，新增Visual Studio Code客戶端 ID aebc6443-996d-45c2-90f0-388ff96faa56，並選擇OK。 其他部分保持原樣。

6. 在 App Service 認證設定 中，請使用以下設定：

   Setting	Selection
   限制存取	需要驗證
   未驗證的要求	HTTP 401 未授權：建議用於 API
   代幣儲存	勾選允許代幣刷新的方框

7. 選取 ，然後新增。 設定擴散後，你應該會看到以下結果：

   

預先授權 Visual Studio Code 作為客戶端

1. 在 Microsoft 旁邊選擇 Entra 應用程式名稱。 此操作會帶您進入 Entra 應用程式 資源的概覽 。

2. 在左側選單中，找到 「管理 -> 公開 API」。

3. 在 授權用戶端應用程式中，選擇 +新增用戶端應用程式。

4. 輸入 Visual Studio Code 的客戶 ID：aebc6443-996d-45c2-90f0-388ff96faa56。

5. 選擇示波器前方看起來像 api://abcd123-efg456-hijk-7890123/user_impersonation的方框。

6. 選取新增應用程式。

設定受保護的資源中繼資料 （預覽版）

1. 在同一個 Expose an API 檢視中，找到 Scopes 區塊，複製允許管理員和使用者同意 Entra 應用程式的範圍。 這個值看起來像 api://abcd123-efg456-hijk-7890123/user_impersonation。

2. 執行與之前相同的指令來新增設定 WEBSITE_AUTH_PRM_DEFAULT_WITH_SCOPES：

   az functionapp config appsettings set --name <function-app-name> --resource-group <resource-group-name> --settings "WEBSITE_AUTH_PRM_DEFAULT_WITH_SCOPES=<scope>"
   

3. 另外，在 Expose an API 檢視中，找到最上方的 應用程式 ID URI （看起來像 api://abcd123-efg456-hijk-7890123），然後儲存以備後續步驟使用。

伺服器授權協定

在 Visual Studio Code 的除錯輸出中，你會看到 MCP 用戶端與伺服器互動時的一系列請求與回應。 當你使用內建的 MCP 伺服器授權時，你會看到以下事件序列：

1. 編輯器會向 MCP 伺服器發送初始化請求。
2. MCP 伺服器會回應錯誤，表示需要授權。 回應中包括一個指向應用程式受保護資源中繼資料（PRM）的指針。 內建的授權功能會為伺服器應用程式生成 PRM。
3. 編輯器會擷取 PRM 並用它來識別授權伺服器。
4. 編輯器嘗試從授權伺服器上的一個知名端點取得授權伺服器的元資料（ASM）。
5. Microsoft Entra ID 不支援在知名端點上使用 ASM，因此編輯器會改為使用 OpenID Connect 中繼資料端點來取得 ASM。 它嘗試透過在其他路徑資訊之前插入已知端點來發現此現象。
6. OpenID Connect 規範實際上將知名端點定義為位於路徑資訊之後，而 Microsoft Entra ID 正是將其託管於此位置。 所以編輯器會用那個格式再試一次。
7. 編輯器成功取得 ASM。 接著，它會利用這些資訊與自己的客戶端 ID 進行登入。 此時，編輯會提示你登入並同意申請。
8. 假設你成功登入並同意，編輯者會完成驗證。 它會重複發送初始化請求給 MCP 伺服器，這次請求中包含授權令牌。 在偵錯輸出層級看不到這個重試，但在追蹤輸出層級可以看到。
9. MCP 伺服器會驗證該令牌，並成功回應初始化請求。 標準的MCP流程從此點持續，最終發現了本樣本中定義的MCP工具。

故障排除

後續步驟

了解如何在 Azure API Center 註冊由 Azure Functions 託管的 MCP 伺服器。