For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
主要導覽

連線並測試你的外掛程式

測試選用的 MCP 伺服器,再封裝並評估完整的外掛程式。

測試已安裝的完整外掛程式之前,請先逐一測試各項能力。如果外掛程式包含 MCP 伺服器,請先在開發人員模式中連線並評估伺服器,再將外掛程式與其技能一併封裝,測試完整體驗。僅含技能的外掛程式可以略過第一節。

在整個開發過程中保留評估提示詞與結果,以便比較不同版本的行為。

測試 MCP 伺服器(選用)

準備端點

確認下列事項:

  • 可以透過公開的 HTTPS 端點或 安全 MCP 通道連線至 MCP 伺服器。
  • 公開端點支援可串流的 HTTP,通常位於 /mcp;或者, 通道可以連線至其設定的 stdio 或 HTTP MCP 伺服器。
  • 工具名稱、說明、結構描述與註記皆已提供。
  • 需要帳戶的工具,其身分驗證探索功能可正常運作。

使用安全 MCP 通道,在開發人員模式中連線至私人 MCP 伺服器, 無須將伺服器暴露於公開網際網路。開發通道或其他 HTTPS 轉送服務也能提供本機測試所需的端點。這些 測試方式無法取代 提交外掛程式時所需的公開 HTTPS 端點。

檢查 MCP 伺服器

使用 MCP Inspector 直接列出並呼叫工具:

npx @modelcontextprotocol/inspector@latest

使用具代表性的輸入、邊界案例、缺少識別碼及空白結果等情境測試每項工具。檢查結構描述驗證、身分驗證錯誤、註記、確認行為,以及模型可讀取的結果。

啟用開發人員模式

在 ChatGPT 中:

  1. 開啟 設定
  2. 選取 安全性與登入
  3. 開啟 開發人員模式

開發人員模式是否可用,可能取決於帳戶與工作區政策。

新增 MCP 伺服器

  1. 前往 ChatGPT 外掛程式
  2. 選取加號按鈕。
  3. 輸入要向使用者顯示的名稱與說明。
  4. 連線下方選擇連線方式:
    • 若使用公開端點,請輸入 MCP 伺服器的 URL,並包含 /mcp 路徑。
    • 若使用安全 MCP 通道,請選取 通道,再選擇可用的通道 或輸入其 tunnel_id
  5. 建立連線。
  6. 審查從伺服器探索到的工具與中繼資料。

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

檢查工具選擇

開始新的對話,並從工具選單新增 MCP 連線。建立包含下列項目的評估集:

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

針對每個請求,記錄所選工具、引數、結果、錯誤與確認行為。每當你變更工具名稱、說明、結構描述或註記時,都請重新執行這組評估。

如果伺服器傳回選用的 UI,請同時測試元件與模型可讀取的結果。

透過 API Playground 測試

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

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

重新整理中繼資料

變更工具名稱、說明、結構描述、註記、身分驗證或 UI 資源後:

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

此重新整理流程適用於在開發人員模式中連線的 MCP 伺服器。 已發布的外掛程式透過 持續審查 處理工具更新。若變更已提交的外掛程式資訊或匯入的技能, 仍須建立新版本、接受審查並發布。

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

  • 工具清單與文件所述的能力一致。
  • 結構化結果符合各工具宣告的輸出結構描述。
  • 身分驗證失敗時會傳回有用的錯誤訊息。
  • 正向測試提示詞會選取預期的工具,反向測試提示詞則不會。
  • 選用的 UI 能正常呈現,不會產生主控台錯誤,並能正確還原狀態。

測試完整的外掛程式

MCP 伺服器正常運作後,請從本機來源封裝並安裝完整的外掛程式;若外掛程式僅含技能,則可直接進行:

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

建立包含下列項目的評估集:

  • 應使用技能的直接請求。
  • 以間接方式表達相同目標的請求。
  • 依賴先前結果的後續請求。
  • 不應使用外掛程式的反向測試請求。
  • 外掛程式刻意不支援的邊界案例。

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

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

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

  • 每項技能都會在收到預期的請求時啟動。
  • 相似的表達方式會產生一致的行為。
  • 不支援的請求不會啟動外掛程式。
  • 安裝後能正確找到隨附的檔案和參照內容。
  • 外掛程式的起始提示詞反映了它能完成的工作流程。
  • 如果外掛程式包含 MCP 伺服器,隨附的技能與工具能如預期協同運作。