
新版connector添加mcp时,http请求头无法保存
快速结论:该问题发生在 LobeChat 新版 Connector 配置 MCP 工具时,HTTP 请求头填写保存后重新打开配置会丢失。优先检查 LobeChat 版本是否低于 v2.2.5,并确认保存逻辑中存在不可达代码分支导致请求头被静默清除。
问题场景
用户在 LobeChat Web 端(Windows / Chrome / Self hosting Docker)使用新版 Connector 功能添加 MCP 工具时,填写 HTTP 请求头并保存。再次进入技能管理查看 MCP 配置时,发现之前填写的 HTTP 请求头已丢失。同时用户检查数据库表,发现没有存储 HTTP 请求头的字段。
报错原文
新版connector添加mcp时,http请求头无法保存,填写保存后,再次管理技能,查看mcp配置,发现http配置丢失,同时,发现数据库表里面并没有存储http请求头的字段
原因分析
这是一个已确认的 Bug,由保存逻辑中的代码分支错误引起。编辑自定义 Connector 时,保存逻辑中存在不可达的代码分支(authType === 'header'),当 authType === 'none' 时,credentials 被设置为 null,导致 HTTP 请求头因此被静默清除。
注意:HTTP 请求头在数据库中并不是以单独字段存储的,而是作为加密的 JSON 保存在 user_connectors 表的 credentials 列中(格式为 { type: 'header', headers: Record })。所以直接查看数据库时不会看到明文的 headers 字段。
环境排查
- LobeChat 版本:v2.2.5 及以下版本存在此问题
- 部署方式:Self hosting Docker
- 客户端类型:Web (Desktop Browser) / Chrome
解决步骤
- 确认当前使用的 LobeChat 版本号,可以通过设置页面查看或运行
docker logs确认容器版本。 - 如果版本为 v2.2.5 或更早版本,请升级到包含 PR #15909 修复的版本(v2.2.5 之后的版本)。
- 升级完成后,如果之前配置的 MCP 工具中的 HTTP 请求头已丢失,请重新配置并保存。
验证方法
重新添加 MCP 工具并填写 HTTP 请求头后保存,再次进入技能管理查看 MCP 配置,确认 HTTP 请求头仍然存在且显示正确。尝试使用该 MCP 工具,确认请求可以正常携带配置的请求头发送。



