如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題
Codex

Codex 應用案例

將你的應用程式整合到 ChatGPT

針對不同使用情境,打造用途明確的 ChatGPT 應用程式。

難度 Advanced
任務時間跨度 1h

打造能讓使用者完成一項明確任務的 ChatGPT 應用程式。先定義工具,再為 MCP 伺服器及選用的小工具建立基本架構。接著將應用程式連接到 ChatGPT,反覆測試與調整,直到核心流程能順利運作。

最適合的對象

  • 以使用者想完成的一項任務為出發點,規劃第一個 ChatGPT 應用程式
  • 建立 MCP 伺服器的基本架構、定義工具中繼資料,並視需要加入小工具,避免過度設計
  • 在本機透過 HTTPS 測試,再到 ChatGPT 中驗證自訂 MCP 伺服器,根據結果快速調整並重新測試

目錄

    ← 所有應用案例

    將你的應用程式整合到 ChatGPT

    針對不同使用情境,打造用途明確的 ChatGPT 應用程式。

    打造能讓使用者完成一項明確任務的 ChatGPT 應用程式。先定義工具,再為 MCP 伺服器及選用的小工具建立基本架構。接著將應用程式連接到 ChatGPT,反覆測試與調整,直到核心流程能順利運作。

    Advanced
    1h

    打造能讓使用者完成一項明確任務的 ChatGPT 應用程式。先定義工具,再為 MCP 伺服器及選用的小工具建立基本架構。接著將應用程式連接到 ChatGPT,反覆測試與調整,直到核心流程能順利運作。

    Advanced
    1h

    最適合的對象

    • 以使用者想完成的一項任務為出發點,規劃第一個 ChatGPT 應用程式
    • 建立 MCP 伺服器的基本架構、定義工具中繼資料,並視需要加入小工具,避免過度設計
    • 在本機透過 HTTPS 測試,再到 ChatGPT 中驗證自訂 MCP 伺服器,根據結果快速調整並重新測試

    技能與外掛程式

    • 規劃工具、串接 MCP 資源,並依照最新流程開發 ChatGPT 應用程式。
    • 在 Codex 撰寫程式碼或提出架構建議之前,先查閱最新的 Apps SDK 官方指南。
    • 透過精選技能與 Vercel 官方 MCP 伺服器,讓 Codex 在開發時參考 Vercel 生態系的指引。
    技能 使用理由
    ChatGPT Apps 規劃工具、串接 MCP 資源,並依照最新流程開發 ChatGPT 應用程式。
    OpenAI Docs 在 Codex 撰寫程式碼或提出架構建議之前,先查閱最新的 Apps SDK 官方指南。
    Vercel 透過精選技能與 Vercel 官方 MCP 伺服器,讓 Codex 在開發時參考 Vercel 生態系的指引。

    入門提示詞

    搭配使用 $chatgpt-apps 和 $openai-docs,在這個程式碼庫中針對 [use case] 規劃一個 ChatGPT 應用程式。 需求: - 先明確指出使用者要完成的一項核心任務。 - 提出 3 至 5 個工具,清楚列出各工具的名稱、說明、輸入與輸出。 - 評估第一版是否需要小工具,或可先只提供資料,並給出建議。 - MCP 伺服器優先使用 TypeScript,小工具優先使用 React。 - 列出身分驗證與授權、部署及測試需求。 請提供: - 工具規劃 - 建議的檔案樹狀結構 - 一組作為測試基準的提示詞 - 風險與待釐清的問題
    搭配使用 $chatgpt-apps 和 $openai-docs,在這個程式碼庫中針對 [use case] 規劃一個 ChatGPT 應用程式。 需求: - 先明確指出使用者要完成的一項核心任務。 - 提出 3 至 5 個工具,清楚列出各工具的名稱、說明、輸入與輸出。 - 評估第一版是否需要小工具,或可先只提供資料,並給出建議。 - MCP 伺服器優先使用 TypeScript,小工具優先使用 React。 - 列出身分驗證與授權、部署及測試需求。 請提供: - 工具規劃 - 建議的檔案樹狀結構 - 一組作為測試基準的提示詞 - 風險與待釐清的問題

    你將建置的外掛程式

    每個以 MCP 為基礎的外掛程式都有三個部分:

    • MCP 伺服器,負責定義工具、傳回資料、執行驗證與授權檢查,並告知 ChatGPT 從哪裡載入所需的介面資源。
    • 選用的網頁元件,會顯示在 ChatGPT 的 iframe 中。你可以使用 React 建置,也可以直接使用 HTML、CSS 和 JavaScript。
    • 模型,會根據你提供的中繼資料,決定何時呼叫外掛程式的工具。

    開發這些部分時,最適合交給 Codex 的是反覆要做的工程工作:

    • 規劃要提供哪些工具,以及各工具的中繼資料。
    • 建立伺服器和小工具的基本架構。
    • 設定在本機執行所需的指令碼。
    • 分階段加入驗證與授權機制,並調整部署設定。
    • 撰寫可反覆執行的驗證流程,確認外掛程式能在 ChatGPT 中正常運作。

    為什麼適合使用 Codex

    • 以 MCP 為基礎的外掛程式可以清楚分成伺服器、選用的使用者介面,以及由模型發起的工具呼叫。
    • 交給 Codex 的任務越明確、範圍越清楚、結果越容易驗證,提示詞的效果就越好。外掛程式開發正好符合這些條件。
    • 技能和 AGENTS.md 提供可重複使用的指示與專案規則,讓 Codex 在開發時有所依循。

    如需瞭解如何安裝和使用技能,請參閱技能文件。

    使用方式

    事前準備

    • 先選定一項要協助使用者完成的核心任務,避免一開始就把整個產品移植到對話中。
    • 先選好技術組合:伺服器使用 TypeScript 或 Python,小工具則使用 React,或直接使用 HTML、CSS 和 JavaScript。
    • 決定開發期間要如何透過 HTTPS 存取本機伺服器,例如使用 ngrok 或 Cloudflare Tunnel。
    • 部分設定仍使用舊名稱來表示 MCP 伺服器連線。在本機測試時,這些標籤指的就是已註冊的伺服器。
    1. 先選定一項範圍明確的外掛程式任務,請 Codex 提出三到五個工具,並清楚列出各工具的名稱、說明、輸入和輸出。
    2. 決定第一版是否只需傳回資料,或是需要小工具。先依照程式碼庫現有的做法,建立 MCP 伺服器和選用小工具的基本架構,再加入相依套件。
    3. 在本機執行 MCP 伺服器,讓它可透過 HTTPS 存取。在 ChatGPT 中使用新增自訂 MCP 伺服器建立連線,再用少量提示詞測試三種情況:直接要求使用工具、間接需要工具,以及不應使用工具。
    4. 反覆調整中繼資料、狀態處理方式,以及 structuredContent 和 _meta 的承載資料,直到核心讀取流程能在 ChatGPT 中穩定運作。
    5. 只有在存取特定使用者的資料或執行寫入操作需要授權時,才加入 OAuth 2.1,並讓匿名或唯讀流程維持簡單。
    6. 部署預覽版本,提供穩定的 /mcp 端點,確認串流回應正常且介面資源可從主機載入。分享或提交外掛程式前,逐項核對上線檢查清單。

    建議提示詞

    適合這套工作流程的提示詞都包含以下要素:

    • 明確的目標:說明外掛程式應協助使用者在 ChatGPT 中完成什麼任務。
    • 具體的技術組合:指定伺服器要使用 TypeScript 還是 Python,以及小工具要使用 React 還是採用輕量的做法。
    • 清楚的工具職責:請 Codex 規劃或建置少量工具,每個工具只負責一項工作。
    • 驗證與授權需求:說明第一版是否可匿名使用,或是需要連結帳戶並執行寫入操作。
    • 本機開發方式:說明預計使用哪種通道或託管方式,在 ChatGPT 中透過 HTTPS 測試。
    • 驗證步驟:告訴 Codex 要執行哪些指令、測試哪些提示詞,以及回報哪些證據。

    避免用一個龐大的提示詞要求 Codex 一次完成規劃、實作、驗證與授權、部署、提交和細部調整。把工作拆成較小的階段,逐步完成。

    先規劃外掛程式,再建立基本架構

    搭配使用 $chatgpt-apps 和 $openai-docs,在這個程式碼庫中為 [use case] 規劃一個以 MCP 為基礎的外掛程式。 需求: - 先選定一項要協助使用者完成的核心任務。 - 提出 3 到 5 個工具,清楚列出各工具的名稱、說明、輸入和輸出。 - 建議第一版是否需要小工具,或是可以先只傳回資料。 - MCP 伺服器優先使用 TypeScript,小工具優先使用 React。 - 列出驗證與授權、部署和測試的需求。 請提供: - 工具規劃 - 建議的檔案樹狀結構 - 一組基準測試提示詞 - 風險與待釐清的問題

    建立第一個可運作版本的基本架構

    搭配使用 $chatgpt-apps 和 $openai-docs,為這個以 MCP 為基礎的外掛程式建立第一版的基本架構。 技術組合: - 使用 TypeScript 建置 MCP 伺服器 - 使用 React 建置小工具 - 使用 Vite 建置專案 - 使用 ngrok 提供本機 HTTPS 連線 限制: - 限縮外掛程式的範圍:提供一個讀取流程,最多再加一個寫入流程。 - 在 structuredContent 中傳回精簡的資料給模型,只有小工具會用到的資料則放在 _meta 中。 - 確保工具處理函式具備冪等性。 - 新增相依套件前,優先沿用程式碼庫現有的做法。 驗證: - 啟動本機伺服器 - 說明如何在 ChatGPT 中使用「新增自訂 MCP 伺服器」連線到 MCP 伺服器 - 逐字列出要測試的提示詞

    核心流程運作正常後,再加入驗證與授權

    搭配使用 $chatgpt-apps 和 $openai-docs,為這個外掛程式的 MCP 伺服器加入驗證與授權機制。 需求: - 盡可能讓唯讀工具支援匿名使用。 - 僅針對特定使用者的資料或寫入操作加入 OAuth 2.1。 - 使用現有的身分識別提供者,例如 Auth0 或 Stytch。 - 在文件中說明授權範圍、權杖檢查方式,以及如何在 ChatGPT 中測試自訂 MCP 伺服器。 請提供: - 驗證與授權流程摘要 - 伺服器的變更項目 - 必要的環境變數 - 端對端測試計畫

    準備部署及審查外掛程式

    搭配使用 $chatgpt-apps、$openai-docs 和 @vercel,準備部署這個外掛程式的預覽版本。 需求: - 提供穩定的 HTTPS /mcp 端點。 - 確保 /mcp 的串流回應能正常運作。 - 正確託管小工具的資源檔案。 - 新增上線前檢查清單,涵蓋中繼資料、工具使用提示、隱私和測試提示詞。 請提供: - 部署計畫 - 預覽網址或託管步驟 - 審查清單 - 尚待處理的風險

    上線前檢查

    • 外掛程式的目標單一、範圍明確,使用者容易理解。
    • 工具數量少,每個工具都有明確的中繼資料、輸入和輸出。
    • MCP 伺服器的端對端流程運作正常,傳回的 structuredContent 精簡,只有小工具會用到的資料放在 _meta 中。
    • 如果需要小工具,它能在 ChatGPT 中正常顯示。
    • 在 ChatGPT 中連線到自訂 MCP 伺服器後,可以透過 HTTPS 反覆執行本機測試。
    • 用少量提示詞測試直接要求使用工具、間接需要工具和不應使用工具的情況。各項測試都能通過,對話流程和工具承載資料也符合預期。
    • 只有在存取特定使用者的資料或執行寫入操作有需要時,才加入驗證與授權機制。
    • 分享或提交外掛程式前,部署計畫與上線前審查均已涵蓋中繼資料、工具使用提示、隱私和測試提示詞。

    常見問題與做法

    • 要求 Codex 把整個產品移植到 ChatGPT。可以先指定一項使用者的核心任務,請 Codex 提供三到五個工具,以及一個功能範圍明確的小工具。
    • 一開始就用龐大的提示詞要求完成實作。可以把工作拆成規劃、建立基本架構、加入驗證與授權、部署和審查等階段。
    • 工具介面規格還沒釐清,就開始撰寫使用者介面。應先規劃要提供哪些工具及其回應結構描述,再建置小工具。
    • 略過以官方文件為依據的接地步驟。搭配使用 $chatgpt-apps 和 $openai-docs,讓基本架構符合目前的外掛程式開發指引。
    • 最後才處理中繼資料。可以及早撰寫工具說明和參數文件,再用同一組提示詞反覆測試這些說明的效果。
    • 還沒確認匿名或唯讀流程可行,就加入驗證與授權機制。應先讓核心工具流程正常運作,再為確實需要授權的工具加入 OAuth。
    • 還沒在 ChatGPT 中測試,就認定外掛程式已完成。應在 ChatGPT 中連線到自訂 MCP 伺服器,檢查工具的承載資料,並驗證實際的對話流程。

    技術堆疊

    需求

    小工具框架

    預設選項

    React

    為何需要

    開發需要管理狀態的小工具時,可優先選用 React,尤其是介面需要篩選功能、表格或多步驟互動時。

    需求

    代管服務

    預設選項

    Vercel

    為何需要

    可快速部署,提供預覽環境並自動啟用 HTTPS,也方便設定代管的 MCP 端點。

    需求 預設選項 為何需要
    小工具框架 React 開發需要管理狀態的小工具時,可優先選用 React,尤其是介面需要篩選功能、表格或多步驟互動時。
    代管服務 Vercel 可快速部署,提供預覽環境並自動啟用 HTTPS,也方便設定代管的 MCP 端點。

    相關應用案例