如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題
總覽 智慧體存取權 ChatGPT 與 Codex 使用者文件 使用案例

連接並測試外掛程式

如果外掛程式包含 MCP 伺服器,請先測試伺服器,再封裝並評估完整的外掛程式。

先逐一測試各項功能,再安裝並測試完整的外掛程式。如果外掛程式包含 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 伺服器時,須遵守帳戶與工作區政策。

  1. 前往 ChatGPT 外掛程式。
  2. 選取加號按鈕,再選取新增自訂 MCP 伺服器。
  3. 輸入要顯示給使用者的名稱與說明。
  4. 在連線下選擇連線方式:
    • 如果使用公開端點,請輸入包含 /mcp 路徑的 MCP 伺服器網址。
    • 如果使用安全 MCP 通道,請選取通道,再選擇可用的通道或輸入其 tunnel_id。
  5. 設定身分驗證,閱讀風險警告,然後選取我瞭解並希望繼續。
  6. 選取建立為外掛程式。
  7. 檢查系統從伺服器探索到的工具與中繼資料。

如果 ChatGPT 無法連線,請使用 MCP Inspector 檢查公開 HTTPS 端點,或檢查通道所連結的工作區及 tunnel-client 的狀態。請先排除傳輸、初始化、結構描述或身分驗證錯誤,再繼續操作。

檢查工具選擇是否正確

安裝剛建立的外掛程式,然後開始新對話。在提示詞輸入框中輸入 @,並選取外掛程式。建立一組評估案例,涵蓋下列情境:

  • 應呼叫特定工具的直接請求。
  • 以間接方式表達相同目標的請求。
  • 沿用先前結果中識別碼的後續請求。
  • 需要授權或確認的寫入操作。
  • 不在支援範圍內、因此不應呼叫工具的請求。

針對每個請求,記錄所選工具、引數、結果、錯誤,以及系統如何要求確認。每次變更工具名稱、說明、結構描述或註解後,都要重新執行這組評估案例。

如果伺服器也會傳回選用的使用者介面,請同時測試介面元件及模型可讀取的結果。

透過 API Playground 測試

若要查看原始請求與回應記錄,請開啟 API Playground:

  1. 選擇工具 → 新增 → MCP 伺服器。
  2. 輸入 HTTPS 端點並建立連線。
  3. 執行測試用的提示詞,並檢查請求與回應資料。

重新整理中繼資料

變更工具名稱、說明、結構描述、註解、身分驗證設定或使用者介面資源後,請執行下列步驟:

  1. 部署或重新啟動 MCP 伺服器。
  2. 前往 ChatGPT 外掛程式,開啟該連線。
  3. 選取重新整理。
  4. 確認伺服器對外提供的中繼資料已反映變更。
  5. 開始新對話,並重新執行受影響的測試。

此重新整理流程適用於直接在 ChatGPT 中連接的自訂 MCP 伺服器。已發布外掛程式的工具更新採用持續審查機制。如果變更已提交的外掛程式資訊或匯入的技能,仍須建立新版本,送審後再發布。

封裝外掛程式前,請確認下列事項:

  • 工具清單與文件記載的功能一致。
  • 結構化結果符合各工具宣告的輸出結構描述。
  • 身分驗證失敗時會傳回有助於排查問題的錯誤訊息。
  • 對於應觸發工具的提示詞,系統會選取預期的工具;對於不應觸發工具的提示詞,系統不會選取工具。
  • 選用的使用者介面能正常顯示,主控台不會出現錯誤,且介面能正確還原狀態。

測試完整的外掛程式

確認 MCP 伺服器正常運作後,請封裝完整的外掛程式,並從本機來源安裝。如果外掛程式僅包含技能,可直接執行下列步驟:

  1. 封裝外掛程式時,納入技能與資訊清單。如果有 MCP 伺服器,也要納入其連線設定。
  2. 將外掛程式新增至本機市集,再從外掛程式目錄安裝。
  3. 啟用外掛程式並開始新對話。
  4. 從外掛程式的使用案例清單中選出具代表性的請求並執行。

建立一組評估案例,涵蓋下列情境:

  • 應使用某項技能的直接請求。
  • 以間接方式表達相同目標的請求。
  • 依賴先前結果的後續請求。
  • 不應使用外掛程式的請求。
  • 外掛程式在設計上明確排除的邊界情況。

針對每個請求,檢查外掛程式是否遵循技能指示、使用預期資源、完成所有必要步驟,並產生有用的結果。記錄任何遺漏的步驟、不必要的啟動情形或不一致的結果。

如果外掛程式包含 MCP 伺服器,還要確認技能會呼叫正確的工具、工具會將結果傳回工作流程、安裝後身分驗證能正常運作,且使用者能從頭到尾完成每個結合技能與工具的工作流程。

提交前,請確認下列事項:

  • 每項技能都會在收到預期的請求時啟動。
  • 措辭相近的請求會產生一致的行為。
  • 不支援的請求不會啟動外掛程式。
  • 安裝後能正確找到隨附檔案及參照指向的資源。
  • 外掛程式提供的起始提示詞對應到它能完成的工作流程。
  • 如果外掛程式包含 MCP 伺服器,隨附的技能與工具能如預期搭配運作。