1.5. MCP 服务器和客户端问题故障排除

流程

1. 登录到运行 RHDH 的 OCP 集群，并使用以下代码进入 RHDH 项目：

   oc project {my-product-namespace}

   Copy to Clipboard Toggle word wrap

2. 使用以下代码检查 RHDH 动态插件安装的日志：

   oc logs -c install-dynamic-plugins deployment/<my-product-deployment>

   Copy to Clipboard Toggle word wrap

验证

1. 您必须看到 MCP 后端服务器插件的条目，如以下代码所示：

   ..... prior logs ....
   ======= Installing dynamic plugin oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-plugin-mcp-actions-backend:bs_1.42.5__0.1.2!backstage-plugin-mcp-actions-backend
   	==> Copying image oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-plugin-mcp-actions-backend:next__0.2.0 to local filesystem
   	==> Successfully installed dynamic plugin oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-plugin-mcp-actions-backend:bs_1.42.5__0.1.2!backstage-plugin-mcp-actions-backend

   Copy to Clipboard Toggle word wrap

2. 您必须看到您安装的任何 MCP 工具插件的条目，如以下代码所示：

   ..... prior logs ....
   ======= Installing dynamic plugin oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-software-catalog-mcp-tool:bs_1.42.5__0.2.3!red-hat-developer-hub-backstage-plugin-software-catalog-mcp-tool
   	==> Copying image oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-software-catalog-mcp-tool:bs_1.42.5__0.2.3!red-hat-developer-hub-backstage-plugin-software-catalog-mcp-tool to local filesystem
   	==> Successfully installed dynamic plugin oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-software-catalog-mcp-tool:bs_1.42.5__0.2.3!red-hat-developer-hub-backstage-plugin-software-catalog-mcp-tool

   Copy to Clipboard Toggle word wrap

流程

1. 请参考您的模型文档，以确认其支持进行工具调用。
2. 如果当前模型不支持工具调用，请将 MCP 客户端使用的模型改为调用工具的兼容模型。

流程

1. 验证身份验证令牌。

   1. 为 RHDH MCP 服务器配置静态令牌。
   2. 将此令牌设置为 MCP 客户端中的 bearer 令牌，并确保授权标头是在令牌之前指定 Bearer 的配置，如 Bearer < mcp_token>。

2. 检查 MCP 端点配置。

   1. 确认 MCP 服务器 URL 正确解析，特别是如果您使用桌面客户端。
   2. 如果您的 MCP 客户端需要而不是 Streamable 端点，请使用旧的 SSE 端点。（更多详情请参阅 配置 主题）。

3. 为重复后端条目验证 RHDH app-config.yaml 文件，并确保缩进准确。

   1. 确保静态令牌和 MCP 插件源的配置位于现有的 backend 字段中（如果存在）。
   2. 如果您不确定，请参阅 参考流程 中提供的示例应用程序配置。

1. 为工具调用选择适当的模型。

   1. 验证该模型是否对工具调用有很好的支持。
   2. 确保您的模型太小。我们建议具有至少 7 亿参数和 32k 上下文窗口的模型。

2. 优化查询。

   1. 使用更明确的查询来限制工具响应中返回的数据量。
3. 如果可能，请增加模型的上下文窗口大小。我们建议至少 32k 用于这些 MCP 工具。