保存外部MCP注册

注释

该工具默认可在以下 MCP 服务器上使用：Dynamics 365 Customer Service。 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。

当你通过注册管理小部件添加或编辑外部 MCP 工具服务器注册时，该功能在幕后工作。

它的作用是什么

当你在MCP服务器管理小部件中填写注册表并选择保存时，该工具会将注册持久化到你的Dynamics 365环境。 它既负责创建新注册，也负责更新现有注册。

该工具会验证端点URL的安全，检查认证范围是否允许，执行注册上限（每个环境20个），并防止终端或工具前缀重复。 成功后，它会存储注册信息并刷新服务代理的工具列表，使新服务器的工具可用。

试试像这样的提示

不適用。 当你从管理小部件保存注册时，这个工具会自动调用。 输入提示词不会调用它。

你在聊天中会看到的内容

注册小部件会更新以确认存档成功，显示注册ID以及是否创建或更新。 如果验证失败（例如，重复端点或保留工具前缀），小部件会显示错误信息，说明需要修复的问题。

有用的提示

  • 你必须先运行测试连接，才能保存新注册。 测试中的工具快照会被持久保存。
  • 每个服务器端点只能注册一次。 如果需要重新注册同一个URL，请先取消现有注册。
  • 工具前缀必须在环境中所有注册中唯一。
  • 保存注册会使工具缓存失效，更新后的工具在下一次对话中生效。

接下来会发生什么

保存后，注册小部件会返回列表视图。 您可以：

  • 再测试一次连接。
  • 编辑我刚保存的注册信息。
  • 再加一个MCP服务器。

这会改变数据吗？

是的，这会改变数据。

保存注册可以在你的 Dynamics 365 环境中创建或更新配置文件记录，并刷新服务代理可用的工具列表。

先决条件

该工具需要以下条件：

  • 系统管理员或 Copilot 服务管理员角色。

工具摘要

资产 价值
面向用户的名称 保存外部MCP注册
内部工具名称 save_mcp_registration
Purpose 保留新的或更新的外部MCP服务器注册

工具行为

保持新的或更新的外部 MCP 服务器注册。 这是一个小部件支持工具，用户在与可扩展性注册小部件交互时会自动调用。 它不适合模型直接调用。

Annotations

注释 价值 Meaning
readOnlyHint false 该工具创建或更新注册数据。
destructiveHint false 更新是非破坏性的（upsert 模式）。
idempotentHint true 同一输入的重复调用会产生相同的结果。
openWorldHint 未设置 使用默认值。

输入概念

注册对象

输入 Description 必需
displayName、name、endpoint、authScope、mode、toolPrefix、tools 包含服务器注册详情，包括 displayName、 name （唯一标识符）、 endpoint （HTTPS URL）、 authScope （Entra OBO 目标范围）、 mode、 toolPrefix和 tools 数组。 否

注册 ID

输入 Description 必需
id id（可选）。 提供后，更新现有注册;省略时，会生成新的。 否

组织 URL

输入 Description 必需
orgUrl orgUrl（可选）。 覆盖当前选择的环境URL。 否

响应与用户界面行为

该 MCP 工具由 MCP 应用支持。

响应类型

小部件更新

小部件刷新显示已保存的注册信息。

路由注释

该工具仅由 manage_mcp_registration 小部件调用。 不要直接调用它。

工具 关系
manage_mcp_registration 启动器工具，可以打开注册小部件
delete_mcp_registration 移除注册
test_mcp_registration_connection 保存前测试连接性

数据变异分类

写（upsert）。 在组织范围的注册存储中创建或更新外部MCP服务器注册。

  • 上次更新时间为