7.5. Ansible MCP 服务器错误故障排除
本节包含可帮助您诊断和解决部署 Ansible MCP 服务器的问题并将其连接到外部 AI 代理的信息。
7.5.1. API 输出格式拒绝 406 Status Code 复制链接链接已复制到粘贴板!
问题 :如果 MCP 服务器的请求输出不是 JSON 格式,则 Ansible Automation Platform 会拒绝 API 请求(例如,检索作业 stdout)。
临时解决方案 :要以特定格式获取输出,请指示您的 AI 工具首先使用 JSON 格式。然后,您可以将 JSON 输出转换为所需的格式。
7.5.2. 用户请求使用 400 状态代码拒绝 复制链接链接已复制到粘贴板!
问题 :Ansible MCP 服务器可能会拒绝来自外部 AI 工具的用户请求,其具有 400 Bad Request 状态代码。当 Ansible Automation Platform 使用自签名证书时,会出现这个错误。
临时解决方案 :配置 Ansible MCP 服务器,以忽略证书错误,执行以下步骤:
-
对于基于容器的安装:将变量
mcp_ignore_certificate_errors的值设置为true。 对于基于 operator 的安装:
将
IGNORE_CERTIFICATE_ERRORS设置添加到 AnsibleAutomationPlatform 自定义资源的mcp:部分,格式为:spec: mcp: extra_settings: - setting: IGNORE_CERTIFICATE_ERRORS value: true
7.5.3. Ansible MCP 服务器权限在部署后更改 复制链接链接已复制到粘贴板!
问题 :如果您在创建并部署 Ansible MCP 服务器后更改了其权限,您必须删除 AnsibleMCPServer 自定义资源并重新创建它。
临时解决方案 :执行以下步骤:
- 进入 Ansible Automation Platform 门户。
- 在 Resources 下,搜索 AnsibleMCPServer 自定义资源。
-
选择活动的 AnsibleMCPServer 实例。一个活跃的 AnsibleMCPServer 实例由附加到 Ansible Automation Platform 自定义资源名称中的
-mcp后缀来标识。 - 选择实例右侧的 Settings 菜单 (3-dot 菜单图标),然后单击 Delete AnsibleMCPServer。
- 协调过程完成后,现有 Ansible MCP 服务器实例会被删除并创建新的 Ansible MCP 服务器实例。