现象
运行FastGPT时，后台日志出现如下内容：2026-07-15 03:16:14 正常响应GET /api/common/system/getInitData接口，状态码304，耗时6ms；随后在03:16:17触发MCP工具模块的连接错误，具体报错为WRN app:mcp-tools MCP client connection error: {requestId: 'e7621bba-9061-4ef5-82ce-0aec785ef04e', url: 'http://192.168.124.249:8080/api/v1/mcp', error: [Error [AbortError]: This operation was aborted] {code: 20, 附带部分DOM错误常量列表}。
可能原因
- 目标MCP服务地址
http://192.168.124.249:8080/api/v1/mcp对应的服务未正常启动或端口未开放； - 网络层面存在阻断，如防火墙、安全组拦截了FastGPT服务器到目标地址的流量；
- 连接请求被主动中止，对应报错
AbortError: This operation was aborted，可能是客户端超时设置过短、网络中断或服务端主动断开连接； - 需按实际环境确认其他潜在配置异常。
排查步骤
- 验证目标MCP服务的可访问性，在FastGPT所在服务器执行
curl http://192.168.124.249:8080/api/v1/mcp，检查是否能获取正常响应； - 检查基础网络连通性，执行
ping 192.168.124.249，确认FastGPT服务器与目标服务所在服务器的网络连接正常； - 核对FastGPT中MCP客户端的超时配置参数，确认是否存在超时时间过短导致请求提前中止的情况；
- 查看目标MCP服务的运行日志，检索requestId为
e7621bba-9061-4ef5-82ce-0aec785ef04e的请求记录，确认服务端是否主动断开了连接； - 检查所在环境的防火墙、安全组规则，确认未拦截8080端口的相关流量。
解决与验证
- 若目标MCP服务未启动或端口未开放，启动对应服务并确认端口监听正常；
- 若存在网络阻断，调整防火墙、安全组规则，放行相关流量；
- 若超时配置过短，调整MCP客户端的超时参数至合理范围（需按实际环境确认具体值）；
- 验证：重启FastGPT服务，观察后台日志是否不再出现该MCP连接报错，同时确认相关依赖MCP服务的业务功能可正常运行。
来源：https://github.com/labring/FastGPT/issues/7307