測試已安裝的完整外掛程式之前,請先逐一測試各項能力。如果外掛程式包含 MCP 伺服器,請先在開發人員模式中連線並評估伺服器,再將外掛程式與其技能一併封裝,測試完整體驗。僅含技能的外掛程式可以略過第一節。
在整個開發過程中保留評估提示詞與結果,以便比較不同版本的行為。
測試 MCP 伺服器(選用)
準備端點
確認下列事項:
- 可以透過公開的 HTTPS 端點或 安全 MCP 通道連線至 MCP 伺服器。
- 公開端點支援可串流的 HTTP,通常位於
/mcp;或者, 通道可以連線至其設定的 stdio 或 HTTP MCP 伺服器。 - 工具名稱、說明、結構描述與註記皆已提供。
- 需要帳戶的工具,其身分驗證探索功能可正常運作。
使用安全 MCP 通道,在開發人員模式中連線至私人 MCP 伺服器, 無須將伺服器暴露於公開網際網路。開發通道或其他 HTTPS 轉送服務也能提供本機測試所需的端點。這些 測試方式無法取代 提交外掛程式時所需的公開 HTTPS 端點。
檢查 MCP 伺服器
使用 MCP Inspector 直接列出並呼叫工具:
npx @modelcontextprotocol/inspector@latest
使用具代表性的輸入、邊界案例、缺少識別碼及空白結果等情境測試每項工具。檢查結構描述驗證、身分驗證錯誤、註記、確認行為,以及模型可讀取的結果。
啟用開發人員模式
在 ChatGPT 中:
- 開啟 設定。
- 選取 安全性與登入。
- 開啟 開發人員模式。
開發人員模式是否可用,可能取決於帳戶與工作區政策。
新增 MCP 伺服器
- 前往 ChatGPT 外掛程式。
- 選取加號按鈕。
- 輸入要向使用者顯示的名稱與說明。
- 在 連線下方選擇連線方式:
- 若使用公開端點,請輸入 MCP 伺服器的 URL,並包含
/mcp路徑。 - 若使用安全 MCP 通道,請選取 通道,再選擇可用的通道
或輸入其
tunnel_id。
- 若使用公開端點,請輸入 MCP 伺服器的 URL,並包含
- 建立連線。
- 審查從伺服器探索到的工具與中繼資料。
如果 ChatGPT 無法連線,請使用 MCP Inspector 驗證公開的 HTTPS 端點,
或檢查通道的工作區關聯與 tunnel-client 狀態。請先解決
傳輸、初始化、結構描述或身分驗證錯誤,再繼續操作。
檢查工具選擇
開始新的對話,並從工具選單新增 MCP 連線。建立包含下列項目的評估集:
- 應呼叫特定工具的直接請求。
- 以間接方式表達相同目標的請求。
- 沿用先前結果中識別碼的後續請求。
- 需要授權或確認的寫入動作。
- 不受支援且不應呼叫工具的請求。
針對每個請求,記錄所選工具、引數、結果、錯誤與確認行為。每當你變更工具名稱、說明、結構描述或註記時,都請重新執行這組評估。
如果伺服器傳回選用的 UI,請同時測試元件與模型可讀取的結果。
透過 API Playground 測試
若要查看原始請求與回應記錄,請開啟 API Playground:
- 選擇 工具 → 新增 → MCP 伺服器。
- 輸入 HTTPS 端點並連線。
- 執行測試提示詞,並檢查請求與回應資料。
重新整理中繼資料
變更工具名稱、說明、結構描述、註記、身分驗證或 UI 資源後:
- 部署或重新啟動 MCP 伺服器。
- 在 ChatGPT 外掛程式中開啟該連線。
- 選取 重新整理。
- 確認伺服器對外提供的中繼資料已變更。
- 開始新的對話,並重新執行受影響的測試。
此重新整理流程適用於在開發人員模式中連線的 MCP 伺服器。 已發布的外掛程式透過 持續審查 處理工具更新。若變更已提交的外掛程式資訊或匯入的技能, 仍須建立新版本、接受審查並發布。
封裝外掛程式之前,請確認下列事項:
- 工具清單與文件所述的能力一致。
- 結構化結果符合各工具宣告的輸出結構描述。
- 身分驗證失敗時會傳回有用的錯誤訊息。
- 正向測試提示詞會選取預期的工具,反向測試提示詞則不會。
- 選用的 UI 能正常呈現,不會產生主控台錯誤,並能正確還原狀態。
測試完整的外掛程式
MCP 伺服器正常運作後,請從本機來源封裝並安裝完整的外掛程式;若外掛程式僅含技能,則可直接進行:
- 封裝外掛程式時,請納入其技能、資訊清單,以及 適用時的 MCP 伺服器連線。
- 將外掛程式新增至本機市集,並從外掛程式目錄安裝。
- 啟用外掛程式,並開始新的對話。
- 從外掛程式的使用案例清單中,挑選具代表性的請求並執行。
建立包含下列項目的評估集:
- 應使用技能的直接請求。
- 以間接方式表達相同目標的請求。
- 依賴先前結果的後續請求。
- 不應使用外掛程式的反向測試請求。
- 外掛程式刻意不支援的邊界案例。
針對每個請求,檢查外掛程式是否遵循技能指示、使用預期的資源、完成所有必要步驟,並產生實用的結果。記錄任何遺漏的步驟、不必要的啟動或不一致的結果。
如果外掛程式包含 MCP 伺服器,也要確認技能會呼叫正確的工具、工具結果會傳回工作流程、安裝後身分驗證能正常運作,而且使用者能從頭到尾完成每個結合技能與工具的工作流程。
提交前,請確認下列事項:
- 每項技能都會在收到預期的請求時啟動。
- 相似的表達方式會產生一致的行為。
- 不支援的請求不會啟動外掛程式。
- 安裝後能正確找到隨附的檔案和參照內容。
- 外掛程式的起始提示詞反映了它能完成的工作流程。
- 如果外掛程式包含 MCP 伺服器,隨附的技能與工具能如預期協同運作。