跳至主要內容
SPREVA

AI 代理程式

Codex

OpenAI 的程式設計代理程式，可在終端機、IDE 擴充功能和 ChatGPT 桌面應用程式中使用。

連結方式
登入 API 金鑰 CLI Skill
連接器
SPREVA
方案
包含在 ChatGPT Free、Go、Plus、Pro、Business、Enterprise 和 Edu 中，或搭配 OpenAI API 金鑰使用。

開始之前

  • 已安裝並登入 Codex。

設定步驟

  1. 1

    新增 SPREVA：

    終端機
    codex mcp add spreva \
  --url https://dev-app.spreva.ai/api/mcp
  2. 2

    登入。你的瀏覽器會開啟 SPREVA：選擇工作空間，然後點選允許。

    終端機
    codex mcp login spreva
  3. 3

    確認它已經在清單中。在 Codex 中，/mcp 也會列出它。

    終端機
    codex mcp list

其他連結方式

  • 放在標頭中的 API 金鑰

    以 Bearer 權杖傳送 SPREVA API 金鑰，適合不需要有人在場的自動化流程。

    終端機
    export SPREVA_API_KEY=spreva_sk_...
codex mcp add spreva \
  --url https://dev-app.spreva.ai/api/mcp \
  --bearer-token-env-var SPREVA_API_KEY
  • CLI 和 Agent Skill

    安裝 spreva 命令列工具和它的 Agent Skill，適合在終端機中工作的代理程式。

    終端機
    export SPREVA_API_KEY=spreva_sk_...
npx -y @spreva/cli skill install --target codex
  • CLI 的 stdio 橋接

    把 spreva mcp 當成本機 MCP 伺服器執行，適合只會在你的電腦上啟動伺服器的應用程式。

    終端機
    export SPREVA_API_KEY=spreva_sk_...
codex mcp add spreva \
  --env SPREVA_API_KEY=$SPREVA_API_KEY \
  -- npx -y @spreva/cli mcp

確認是否正常運作

開始新的對話，然後問：

詢問你的代理程式
這週 SPREVA 上有哪些內容要發布？

Codex 會呼叫 SPREVA 的 overview 工具，並回覆工作空間的時區、接下來要發布的內容，以及需要處理的事項。第一次使用時，Codex 可能會請你允許這個工具。

注意事項

  • Codex CLI、IDE 擴充功能和 ChatGPT 桌面應用程式共用 ~/.codex/config.toml，所以 SPREVA 會同時在這三者中完成設定。
  • 雲端任務不會使用你在自己電腦上新增的伺服器。

疑難排解

登入沒有開始

再執行一次 codex mcp login spreva；如果 Codex 版本較舊，請更新。

遇到其他問題？疑難排解涵蓋了反覆要求登入、方案、上限和時區等狀況。

官方說明文件