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