【Azure APIM】通过 API Management 公开API为 MCP Server 的试验 (二)

【Azure APIM】通过 API Management 公开API为 MCP Server 的试验 (二)的重点在于把前置条件、操作顺序和容易误判的地方分清楚。

问题描述

在昨天的博文中“【Azure APIM】通过 API Management 公开现有 MCP Server 的试验 (一) ”，介绍了如何在APIM中配置MCP Server。接下来，将介绍，如何把APIM中已经存在的API转换为MCP Server呢？

问题解答

在APIM MCP的文档介绍中，有将APIM公开为MCP服务器的步骤，下文会根据这个步骤操作并进行验证。

登录 Azure 门户，进入目标 APIM 实例后，按以下步骤创建 MCP Server：

在左侧菜单中选择 APIs > MCP servers。

选择 Create MCP server。

选择 Expose an API as an MCP server。

在 Backend MCP server 中，选择APIM的默认API(Echo API)，并勾选全部的Operations (这里将产生一个隐藏错误)

在 New MCP server 区域填写 APIM 中的 MCP Server 名称与描述，如 mcp echo server

可选地将 MCP Server 加入一个 Product。这样客户端便可以通过该 Product 的订阅密钥访问服务。

选择 Create，等待 APIM 创建完成。

动态展示图：

创建完成后，复制页面中的“MCP Server URL”，作为下一步在VS Code中配置MCP Server的URL。

在VS Code中添加MCP配置

可以通过命令面板执行 MCP: Add Server 添加服务器，也可以直接在工作区的 .vscode/mcp.json 中配置。

示例配置如下：

"my-mcp-server-echo": {

"url": "https://xxxxxxxx.azure-api.cn/mcp-echo-server/mcp",

"type": "http",

"headers": {

"Ocp-Apim-Subscription-Key": "xxxxxxxxxxxxxxxxxxx"

}

}

只是在启动MCP服务的时候，遇见了错误：

2026-08-04 21:00:31.984 [info] Starting server my-mcp-server-echo

2026-08-04 21:00:31.985 [info] Connection state: Starting

2026-08-04 21:00:31.987 [info] Starting server from LocalProcess extension host

2026-08-04 21:00:31.989 [info] Connection state: Running

2026-08-04 21:05:35.085 [info] Error connecting to https://xxxx.azure-api.cn/mcp-echo-server/mcp for async notifications, will retry

2026-08-04 21:05:35.086 [warning] Error reading SSE stream: TypeError: terminated

2026-08-04 21:05:35.091 [info] Connection state: Error Error sending message to https://xxxxx.azure-api.cn/mcp-echo-server/mcp: TypeError: fetch failed

这个错误的原因与已知的Bug有关：https://learn.microsoft.com/zh-cn/azure/api-management/export-rest-mcp-server#prerequisites

如果在 API Management 服务实例的全局范围（所有 API），通过 Application Insights 或 Azure Monitor 启用诊断日志记录，请将“前端响应”的“要记录的有效负载字节数”设置设定为 0。

此设置可防止在所有 API 中意外记录响应主体，并有助于确保 MCP 服务器的正常运行。

若要选择性地记录特定 API 的有效负载，请在 API 范围内单独配置设置，从而允许对响应日志记录进行有针对性的控制。

目前的解决办法是，不要选择所有的API，为测试把API转换为MCP Tools的功能，只需要选择一个 Get 接口用于实验。

导航到APIM的MCP服务页面 -->  选择MCP服务的Tools页面。如下，只勾选 Retrieve Resource 操作作为测试。

测试MCP调用

在 GitHub Copilot Chat 中切换至 Agent 模式，输入“调用apim echo mcp服务的get接口，获取test资源”，并查看mcp的调用情况

参考资料

将 API 管理中的 REST API 公开为 MCP 服务器 : https://learn.microsoft.com/zh-cn/azure/api-management/export-rest-mcp-server

当在复杂的环境中面临问题，格物之道需：浊而静之徐清，安以动之徐生。 云中，恰是如此!