Open WebUI 社群提出 MCP 引用欄位映射，盼減少檢索服務對事件 API 的依賴

Open WebUI 的一項新討論，把 MCP 知識庫整合的焦點拉到來源呈現。10 月 8 日，社群成員提出由管理員設定引用欄位映射；翌日，Classic298 回覆強調，外部 MCP 工具目前已可透過事件 API 發送來源。因此，這次提案的實質價值在於減少整合耦合，不能解讀為平台完全不支援 MCP 引用。社群討論

官方文件說明，外部 OpenAPI 與 MCP 工具可向指定聊天訊息的事件端點發送 source 事件。啟用 ENABLE_FORWARD_USER_INFO_HEADERS 後，工具請求會帶有聊天與訊息識別碼；來源資料則以 document 和 metadata 兩個對應陣列表示段落與連結。這條路徑支援原生工具呼叫模式，但服務端需要理解 Open WebUI 的事件介面。事件文件

新提案改由連線設定指定結果清單、標題、正文、網址與文件識別碼的欄位名稱。宿主先解開 MCP 文字內容中的 JSON，再依映射建立來源事件，並按文件分組。對已有固定回傳格式、或經過 MCP 閘道的檢索服務，這可望減少為單一聊天介面修改伺服器的工作；映射限定於指定連線與工具，也避免僅憑工具名稱就套用引用解析。提案與原型

部署端還須區分「工具回傳內容」與「工具發送引用事件」。官方開發文件指出，原生模式只有固定內建工具會自動從結果產生來源，Python 工具仍可主動發送引用；舊教學中的 self.citation 旗標已無實際作用。排查引用缺失時，工程師應先確認使用哪條資料路徑。工具開發文件

目前映射方案只是作者在 v0.11.4 的局部測試，尚非 PR。後續應觀察上游是否採納、管理介面能否保留設定，以及大量結果與第三方 MCP 服務的相容性。對企業 RAG 團隊而言，值得評估的是引用可追溯性與服務耦合成本，現階段仍應以官方事件介面作為可驗證的整合基礎。測試限制