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

新增自訂 MCP 伺服器

將 MCP 伺服器以外掛程式的形式連接至 ChatGPT,即可使用伺服器提供的讀取和寫入工具。

連接自訂 MCP 伺服器

將你的模型上下文協定(MCP)伺服器以外掛程式的形式連接至 ChatGPT。ChatGPT 支援伺服器提供的讀取和寫入工具。

請只連接你信任的 MCP 伺服器。不受信任的伺服器可能會存取或竊取你在使用應用程式時分享的資訊,也可能誘使 ChatGPT 以非預期的方式使用工具,例如變更或刪除資料。連接伺服器前,請先瞭解提示注入及其他風險。

使用方式

  • 使用條件: 請使用網頁版 ChatGPT。新增和使用自訂 MCP 伺服器時,須遵守工作區權限和安全限制,包括封鎖模式的限制。

  • 將 MCP 伺服器新增為外掛程式:

    1. 前往 ChatGPT 外掛程式。
    2. 選取加號按鈕,再選取「新增自訂 MCP 伺服器」。
    3. 輸入名稱,並視需要填寫說明。在「連線」下輸入伺服器網址,或選取「通道」以使用安全 MCP 通道。
    4. 設定伺服器的驗證方式。
    5. 詳閱風險警告,再選取「我已瞭解並想繼續」。
    6. 選取「建立為外掛程式」。
    • 支援的 MCP 協定包括 SSE 和串流 HTTP。
    • 驗證選項包括「OAuth」、「無驗證」和「OAuth 或無驗證」。
      • 使用 OAuth 時,如果已提供靜態認證資訊,ChatGPT 就會使用該資訊。否則,若授權伺服器宣告支援用戶端 ID 中繼資料文件(CIMD),且應用程式建立者選擇 CIMD,ChatGPT 即可使用這類文件。CIMD 支援公開用戶端權杖交換(none),也支援使用已簽署的用戶端宣告來交換權杖(private_key_jwt)。如果已設定 DCR,ChatGPT 也可以使用 DCR。
      • 混合驗證同時支援 OAuth 和無驗證。初始化和列出工具的 API 都不使用驗證。各工具則依據其中繼資料所設定的安全機制,使用 OAuth 或不使用驗證。
    • 你可以在個人外掛程式清單或建立外掛程式時所在的工作區找到它。請先安裝,再於對話中使用。
  • 管理工具: 在應用程式設定中,每個應用程式都有自己的詳細資料頁面。你可以在該頁面開啟或關閉工具,也可以重新整理應用程式,從 MCP 伺服器取得新的工具、說明和伺服器指示。

  • 在對話中使用應用程式: 在提示詞輸入框中輸入 @,再選取已安裝的外掛程式。在工作區權限和安全限制允許的範圍內,你可以同時使用自訂 MCP 外掛程式和其他應用程式。你可能需要嘗試不同的提示詞寫法,才能讓 ChatGPT 呼叫正確的工具。例如:

    • 明確指定工具:請使用「Acme CRM」應用程式的「update_record」工具來……。必要時,請一併提供伺服器標籤和工具名稱。
    • 排除其他選項,以免產生歧義:「不要使用內建瀏覽功能或其他工具,只使用 Acme CRM 應用程式。」
    • 區分相似工具的用途:「安排會議時優先使用 Calendar.create_event。不要使用 Reminders.create_task 安排行程。」
    • 指定輸入格式和呼叫順序:「先呼叫 Repo.read_file,傳入 { path: "…" }。再呼叫 Repo.write_file,傳入修改後的內容。不要呼叫其他工具。」
    • 如果多個應用程式的功能重疊,請一開始就說明優先使用哪一個,例如:「以 CompanyDB 為權威資料來源。只有在 CompanyDB 未傳回結果時,才使用其他來源。」
    • 自訂 MCP 伺服器無須提供 search/fetch 工具。應用程式提供的所有工具(包括寫入動作)皆可使用,執行時須遵守確認設定。
    • 如需更多指引,請參閱使用工具和撰寫提示詞。
    • 改善工具說明,協助模型選對工具:在 MCP 伺服器中,以具體動作為工具命名並撰寫說明。用「在……時使用此工具」指出適用時機,註明禁止使用的情況及邊界案例,並補上參數說明和列舉值。這樣有助於模型從相似工具中選出合適的工具,並避免在不適合的情況下使用內建工具。
    • 新增伺服器指示,說明如何搭配使用工具:使用 MCP 的 instructions 欄位提供適用於整個伺服器的指引,例如必要的工具呼叫順序、共用的速率限制或工具之間的關係。請確保前 512 個字元單獨閱讀時也能表達完整意思。

    範例:

    請使用「Calendar.create_event」安排一場 30 分鐘的會議,時間是明天太平洋時間下午 3 點,
    與會者為 alice@example.com 和 bob@example.com。
    不要使用其他排程工具。
    請使用「GitHub.open_pull_request」建立一個從「feat-retry」分支合併至「main」的 pull request,
    標題為「Add retry logic」,內文為「…」。
    不要直接推送至 main。
  • 檢查並確認工具呼叫:

    • 檢查工具呼叫的 JSON 資料,以確認內容是否正確並排查問題。展開每次工具呼叫的詳細資料,即可查看工具輸入和輸出的完整 JSON 內容。
    • 寫入動作預設需要確認。請仔細檢查即將傳給寫入動作的工具輸入,確認工具會按預期執行。錯誤的寫入動作可能會意外毀損、變更或分享資料!
    • 唯讀判定:ChatGPT 會依據工具的 readOnlyHint 註解判定工具是否為唯讀(請參閱 MCP 工具註解)。未加上此註解的工具一律視為寫入動作。
    • 你可以讓 ChatGPT 在目前對話中記住你對特定工具的核准或拒絕決定。之後在同一段對話中呼叫該工具時,ChatGPT 都會套用這項決定。只有在你瞭解並信任該應用程式,且願意讓它在未經你再次核准的情況下繼續執行寫入動作時,才應選擇記住核准決定。開啟新對話後,ChatGPT 會再次要求確認。重新整理同一段對話後,ChatGPT 也會在後續對話回合中再次要求確認。