跳轉至

常見問題

本文列出了使用Meegle MCP 時常見的問題。

連線 404 報錯與工具相容性問題（Trae 等 IDE 新增失敗）

問題描述 ：使用者在 Trae 或其他部分 AI 工具中直接新增 MCP Server URL 後，提示 sse 連結 404 錯誤，或者長時間等待無響應。 原因分析：部分 AI 編碼工具（如 Trae） 不支援 OAuth 協議 ，因此無法直接使用基於個人 MCP 的 OAuth 連線方式。 解決方法： 針對不支援 OAuth 的工具，可以使用 HTTP Header 方式連線Meegle MCP，或使用本地連線。

環境域名與租戶不匹配（invalid tenant id / CheckScope）

問題描述 ：配置好 MCP 後，呼叫一直報錯 invalid tenant id 或 CheckScope ，無法訪問工作項資料。 原因分析 ： 使用者所在的實際專案空間是專用 SaaS 環境，但卻參考了公網 SaaS 的開發文件，配置了公網的 API 域名（如 project.feishu.cn ）。 解決方法 ：核對當前空間所在域名，使用相互匹配的 MCP Server 域名進行配置。

欄位型別不支援與複雜查詢報錯（MQL 報錯 / 欄位不支援）

問題描述 ：

  1. 呼叫 MCP 建立/更新工作項時，報錯“不支援該欄位”（如沒有 AI 標識的欄位）。

  2. 在使用 OpenClaw 等 AI 代理對接 Meego MCP 進行查詢時，頻繁出現 MQL 報錯，查不到資料。 原因分析 ：

  3. 目前 MCP 的寫入暫時不支援投票欄位，其他型別欄位均已支援，包含富文字、附件、複合欄位等。

  4. AI 獲取資料底層依賴的是 MQL（Meegle擴充套件的 SQL 語法）查詢。部分模型能力波動，將自然語言轉化時生成了存在語法錯誤的 MQL。 解決方法 ：

  5. 避免透過 MCP 寫入或修改不支援的欄位型別（投票欄位），可查閱幫助文件確認受支援的欄位。

  6. 針對查詢報錯，可以讓 AI 將生成的 MQL 列印出來，人工根據官方 MQL 語法規範給予糾正，透過多輪對話引導 AI 掌握正確的寫法。