在本地调试 MCP 和 API 插件

提示

受到推崇的: 从 Work IQ 开发工具 开始,用于受支持的专业代码声明代理和插件方案。 请参阅 WIQD 快速入门。 基于工具包的说明仍然可用于需要它们的现有项目和工作流。 在选择工具之前,请检查 功能和目标体验支持 : WIQD 不面向自定义引擎代理。

插件使 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶® 中的声明性代理能够调用模型上下文协议 (MCP) 服务器或 REST API 来检索数据并执行任务。 智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®必须通过 Internet 访问 MCP 或 API 服务器。 通常,调试工具在 (127.0.0.1) 上 localhost 托管调试会话,该只能从运行调试工具的计算机访问。 通过使用反向代理(如开发隧道),可以将调试会话公开到 Internet,以启用来自智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®的调试调用。

本文介绍如何使用该 devtunnel 工具为 MCP 服务器或 API 启用本地调试。

注意

你的调试工具可能已提供反向代理解决方案。 建议查看开发人员工具文档以进行确认。 例如,如果使用 Microsoft 365 代理工具包创建了一个新 API,该工具包将为你处理反向代理的配置。

先决条件

  • 安装在devtunnel托管调试会话的计算机上的 CLI
  • 调试工具使用的 HTTP 端口号

创建持久性开发隧道

使用 devtunnel CLI,可以创建持久性开发隧道 - 可以在不更改托管 URL 的情况下根据需要停止和启动隧道。 使用具有持久性 URL 的隧道可简化插件调试,因为无需使用新 URL 更新声明性代理应用程序包。

  1. 如果尚未登录到 devtunnel CLI,请使用 devtunnel user login --help 查看可用选项。 在继续操作之前,请登录到 CLI。

  2. 创建允许匿名访问的隧道。 匿名访问是允许智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®访问隧道所必需的,并且与 API 所需的任何身份验证无关。

    devtunnel create --allow-anonymous
    

    提示

    创建新隧道会将默认隧道切换到新创建的隧道。 这允许您省 tunnel-id 略后续命令的参数。 如果创建多个隧道,则可能需要使用 tunnel-id 参数来确保使用的是预期的隧道。 有关详细信息,请使用该 devtunnel --help 命令或参阅 开发人员隧道命令行参考。

  3. 添加调试工具使用的 HTTP 端口号。 替换<port>为端口号,并将参数https设置为--protocol调试工具是否在端口http上使用 HTTPS 或未使用 HTTPS。

    devtunnel port create --port-number <port> --protocol https
    
  4. 启动开发隧道。

    devtunnel host
    
  5. 首次运行此开发隧道时,请复制标记为“ 通过浏览器连接”的 URL。 在浏览器中打开此 URL,然后选择 “继续” 以启用隧道。

    注意

    选择 “继续”后,浏览器将显示错误。 这是预期的,可以忽略。

启用隧道后,可以使用 CTRL + C 停止隧道。可以使用以下 devtunnel host host-id 命令重新启动隧道。

使用开发隧道

要使用开发隧道进行调试,请使用开发隧道的 URL 旁加载应用包来取代服务器的 URL。

在插件清单中设置 urlMCP 服务器规格对象 的属性。

"runtimes": [
  {
    "type": "RemoteMCPServer",
    "spec": {
      "url": "<your-dev-tunnel-url>",
    }
  }
]

如果在 Visual Studio Code 中使用 Agents Toolkit 管理声明式代理,可以将环境变量添加到名为 PLUGIN_SERVER_URL/env/.env.dev.user 的文件,并使用它来代替开发隧道 URL。 使用“生命周期”窗格中的“预配”步骤旁加载代理。 在 /env/.env.dev.user 文件中,添加:

OPENAPI_SERVER_URL=<your-dev-tunnel-url>

在插件清单中,更新 url 属性:

"runtimes": [
  {
    "type": "RemoteMCPServer",
    "spec": {
      "url": "${{PLUGIN_SERVER_URL}}",
    }
  }
]

如果未使用代理工具包,可以生成新的应用包 ZIP 文件并 上传代理。