怎樣在 Codex 中添加 MCP？從一個文件連接開始
瞭解 Codex 的本地 MCP 配置和遠程服務連接方式。以 OpenAI 官方只讀文件服務為例，添加連接、檢查配置，並核對是否真的可以調用。
先準備能使用的 Codex
先按官方指南安裝並登錄 Codex CLI。CLI 是在終端里執行的命令行工具；本文使用這一入口配置 MCP。你需要已能執行 Codex，再添加連接。這裡不要求購買新的外掛服務。
MCP 讓 Codex 使用外部工具和資料。添加服務不是給模型重新訓練，也不代表所有服務自動獲得權限。
選清楚本地服務還是遠程服務
本地服務由 Codex 啓動一個命令，官方稱為 STDIO；按項目說明準備執行環境和啓動參數。遠程服務提供一個地址，官方支持 Streamable HTTP；有些還需要登錄或存取憑據。
Codex 預設把配置保存在 ~/.codex/config.toml；受信任項目也可以使用 .codex/config.toml。CLI 與同一 Codex 主機上的編輯器入口共享配置，不能據此假定另一台電腦或雲端已經能連接。
用官方只讀文件服務做例子
OpenAI 提供公開文件 MCP，讀取開發文件，不替你調用 OpenAI API。它適合用來理解“添加一個遠程連接”是什麼。以下是官方給出的配置示例，本站沒有替你執行。
- 在已安裝 Codex CLI 的終端執行：codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
- 執行：codex mcp list。確認列表包含 openaiDeveloperDocs。
- 在 Codex 的終端界面輸入 /mcp，檢查當前會話的連接狀態。再要求它從官方文件查一個問題並附上來源。
配置已保存，不等於連接已成功
列表裡出現服務名稱，只說明配置存在。還要檢查它是否啓動或連接、是否需要授權，以及實際調用有沒有返回資料。需要 OAuth 登錄的服務，可以按官方指引執行 codex mcp login 服務名；不是每個服務都需要這個步驟。
- 本地服務失敗：核對項目需要的執行環境、可執行命令和參數。
- 遠程服務失敗：核對服務地址、當前網路和服務要求的授權。
- 修改配置後按所用客戶端的說明重啓或重新連接，再檢查實際調用。
下一步按任務添加一個工具
讀文件、查項目資料和操作瀏覽器需要不同的工具。選一個與你當前任務有關的服務，閱讀來源、權限和設定說明，再開始一個可核對的小任務。密鑰或登錄憑據按客戶端的本地配置方式保存，不寫入公開儲存庫。
來源核對日期：2026-10-12。這裡是官方配置的入門解釋，未執行安裝、登錄、連通性或相容性實測；具體操作以當前客戶端與服務文件為準。