注释
- 本文档中的工具和示例展示了当前的能力。 工具名称、描述、参数、响应格式和可用功能可能会随时间变化。
- 当你构建代理、集成或编排逻辑时，不要硬编码对特定工具名称、参数结构、工具元数据或响应模式的依赖。 相反，设计解决方案时能在运行时发现并使用可用工具。
- 随着平台的发展，Microsoft可能会添加、移除、重命名或修改工具及工具元数据。 基于能力而非特定工具标识符设计有助于维护服务更新间的兼容性。
当你通过注册管理小部件测试与外部MCP工具服务器的连接时，该功能在幕后工作。
它的作用是什么
当你在MCP服务器注册表单中选择 “测试连接 ”时，该工具会验证服务代理是否能够访问外部服务器端点。 它对URL进行安全检查，利用配置的范围获取认证令牌，并向服务器发送工具/列表请求。
如果连接成功，工具会返回服务器暴露的工具列表。 该工具快照可以选择并随注册保存。 如果连接失败，工具会返回一个稳定的验证码或连接代码，小部件会将其映射到本地化副本;它不会回应提交的端点或依赖响应文本。
试试像这样的提示
不適用。 当你通过管理小部件测试连接时，这个工具会自动调用。 输入提示词不会调用它。
你在聊天中会看到的内容
注册小部件内联显示测试结果。 成功后，你会看到服务器上可用工具的列表及其名称和描述。 失败时，你会看到局部验证或连接错误。
有用的提示
- 保存前一定要测试。 成功测试时，新注册需要工具快照。
- 测试有15秒的超时时间。 如果服务器响应较慢，即使技术上可达，也可能失败。
- 认证失败通常意味着配置的认证范围与服务器的Entra应用注册不匹配。
- 如果测试成功，注册记录上也会标记“最后测试”时间戳。
接下来会发生什么
测试成功后，你可以：
- 保存这张登记。
- 请查看本服务器提供的工具。
这会改变数据吗？
是的，这可能会改变数据。
成功的测试会在注册记录上盖上“最后测试”时间戳。 它不会修改注册的配置。
先决条件
该工具可在 Dynamics 365 Customer Service MCP 服务器上使用。 详情请参见本页顶部的可用性说明。 这种方式无需任何其他配置。
工具摘要
| 资产 | 价值 |
|---|---|
| 面向用户的名称 | 测试外部MCP连接 |
| 内部工具名称 | test_mcp_registration_connection |
| Purpose | 在保存注册前测试与外部MCP服务器端点的连接 |
工具行为
在保存注册前测试与外部MCP服务器端点的连接。 验证端点URL是否符合SSRF限制，利用指定的认证范围获取OBO令牌，并发出 tools/list 请求验证服务器响应。 这是一个从注册管理小部件自动调用的小部件支持工具。
Annotations
| 注释 | 价值 | Meaning |
|---|---|---|
readOnlyHint |
false |
提供后lastTestedAt可在登记表上盖章registrationId。 |
destructiveHint |
false |
测试不会删除或损坏数据。 |
idempotentHint |
false |
成功的测试可以写入新的 lastTestedAt 时间戳。 |
openWorldHint |
未设置 | 使用默认值。 |
输入概念
终结点
| 输入 | Description | 必需 |
|---|---|---|
endpoint |
endpoint （HTTPS URL，必备）。 测试MCP服务器URL。 |
是的 |
身份验证范围
| 输入 | Description | 必需 |
|---|---|---|
authScope |
authScope （字符串，必填）。 Entra OBO 的代币获取目标范围（例如， api://contoso-app/.default）。 |
是的 |
注册 ID
| 输入 | Description | 必需 |
|---|---|---|
registrationId |
registrationId （UUID，可选）。 如提供，成功检测后可在注册记录上盖 lastTestedAt 章。 |
否 |
组织 URL
| 输入 | Description | 必需 |
|---|---|---|
orgUrl |
orgUrl（可选）。 覆盖当前选择的环境URL。 |
否 |
响应与用户界面行为
该 MCP 工具由 MCP 应用支持。
响应类型
带测试结果的小部件更新
成功后返回发现的工具数量和工具快照。 验证失败返回 RegistrationValidationFailed;验证后失败返回 ConnectionTestFailed。
该小部件将这些稳定码映射到局部错误副本。
路由注释
该工具仅由 manage_mcp_registration 小部件调用。 不要直接调用它。
相关工具
| 工具 | 关系 |
|---|---|
manage_mcp_registration |
启动器工具，可以打开注册小部件 |
save_mcp_registration |
成功测试后保存注册 |
delete_registration |
当 type 是时，移除 MCP 注册 "mcp" |
数据变异分类
大多是只读，带有可选副作用。 连接测试本身是只读的。 当 registrationId 提供且测试成功时，会在注册记录上盖 lastTestedAt 章。