把 OceanToken 加入你的程式設計代理

OceanToken 為程式設計代理提供 MCP 伺服器和外掛。有了它們，你的代理可以搜尋模型目錄、查看請求要花多少錢、生成圖片、影片和配音、轉錄音訊，還能把子任務交給另一個模型，全部從你的 OceanToken 餘額扣款。

這只是新增工具，代理仍使用它自己的模型。若要讓代理本身跑在 OceanToken 的模型上，請看讓代理在 OceanToken 上執行。

外掛、命令列安裝程式及其清單檔都在 github.com/OceanTokenAI/oceantoken-plugins 開源。

Claude Code：安裝外掛

在 Claude Code 中輸入這兩條指令：

/plugin marketplace add OceanTokenAI/oceantoken-plugins
/plugin install oceantoken@oceantoken

然後執行 /mcp，選擇 plugin:oceantoken:oceantoken，再選 Authenticate 登入。外掛會加入下面的工具和技能。其他代理請看用一條指令接入。

代理會得到什麼

工具	作用
`search_models`	依名稱、類型、發布者、能力和價格搜尋目錄
`get_model`	模型的價格、限制，以及接受的尺寸、時長和輸入
`estimate_cost`	請求執行前要花多少錢，以及你的餘額夠不夠
`generate_image`	文字生圖和圖片編輯，附預覽和下載連結
`create_video` 和 `get_job`	從文字、首（尾）幀或參考素材生成影片
`generate_speech`	配音和旁白
`transcribe_audio`	逐字稿，以及 SRT 或 VTT 字幕
`ask_model`	把子任務交給另一個模型：更便宜的，或聽聽第二意見
`upload_file`	把本機檔案當作參考素材
`get_account`	餘額、可用餘額和支出

三個技能教代理用好這些工具：oceantoken-media 為專案製作圖片、影片和音訊，oceantoken-models 負責選模型、估價和委派，oceantoken-setup 讓 Codex 或 Claude Code 本身跑在 OceanToken 上，或幫你的應用接好 OceanToken。

用一條指令接入

對你的代理說：

Install OceanToken for me by following https://mcp.oceantoken.ai/install

或自己在終端機執行：

npx -y @oceantoken/cli@latest connect <client>

需要 Node.js 18.17 或更新版本。<client> 取以下之一：

用戶端	`<client>`	登入
Codex（CLI 或 App）	`codex`	指令會開啟瀏覽器並等待
Claude Code（終端機、IDE 擴充功能或桌面 App）	`claude-code`	指令會開啟瀏覽器並等待
Cursor	`cursor`	在 Cursor 的 Settings → Tools & MCP 中
Gemini CLI	`gemini`	在 Gemini CLI 中：`/mcp auth oceantoken`
OpenClaw	`openclaw`	指令會開啟瀏覽器並等待
OpenCode	`opencode`	指令會開啟瀏覽器並等待
VS Code（GitHub Copilot）	`vscode`	在 VS Code 中，伺服器啟動時
WorkBuddy	`workbuddy`	在 WorkBuddy 中
Hermes Agent	`hermes`	指令會開啟瀏覽器並等待
Windsurf / Devin Desktop	`windsurf`	在 Cascade 中

每個用戶端都會得到 MCP 伺服器和三個技能；Windsurf 沒有技能資料夾，只得到伺服器。

指令會改動什麼：

Codex、Claude Code、Gemini CLI 和 OpenClaw 會用用戶端自己的命令列安裝外掛。加上 --api-key 時，Codex、Claude Code 和 Gemini CLI 改為在設定檔中加入一條 oceantoken 項目。
其他用戶端會在 MCP 設定檔中加入一條 oceantoken 項目。原有項目保留；含註解的檔案永遠不會被改寫，你會拿到一段要自己貼上的設定。
指令第一次修改設定檔前，會把它複製為 <file>.bak-oceantoken，且永不覆寫這份副本，所以不論接入、移除多少次，原檔都在。之後每次修改還會留下 <file>.bak-oceantoken-<UTC time>，內容是修改前的檔案。備份是純複製：原檔裡有 Key，備份裡也有。
技能放進用戶端自己的技能資料夾。

重複執行是安全的，它會更新自己安裝的內容。最後會輸出摘要：Result 為 connected 表示完成；incomplete 會在 Next 下列出剩下的步驟，例如在 App 中登入或重新啟動工作階段。

選項

--api-key <key|->   Use an API key instead of OAuth sign-in ("-" reads it from stdin)
--use-env-key       Use the key in OCEANTOKEN_API_KEY
--no-login          Configure only; do not start the sign-in
--no-skills         Do not install the OceanToken skills
--dry-run           Show what would change without changing anything
--json              Print the report as JSON
--url <mcp-url>     MCP endpoint (default https://mcp.oceantoken.ai/mcp)

npx -y @oceantoken/cli@latest clients 會列出支援的用戶端，以及本機已安裝哪些。

登入使用 OAuth。登入頁提供兩種接入方式：

Sign in：用 OceanToken 的電子郵件和密碼登入。這會為接入的 App 建立一個 API Key，你可以在主控台的 API Keys 中查看和撤銷。新使用者可以在同一頁建立帳號。
API key：貼上你已有的 Key。若想限制代理能花多少，可以給這個 Key 設額度上限。

撤銷 Key 會立即中斷代理的連線。

不用瀏覽器、用 Key 接入時，請透過 stdin 傳入，這樣 Key 不會留在 shell 歷史中。指令永遠不會把 Key 放在其他程式的命令列上，也不會印出它，只會寫進用戶端的設定檔（OpenClaw 從 stdin 接收並寫入自己的設定）：

printf %s "$OCEANTOKEN_API_KEY" | npx -y @oceantoken/cli@latest connect <client> --api-key -

手動設定

和指令的效果相同，逐個用戶端說明。

Codex

codex plugin marketplace add OceanTokenAI/oceantoken-plugins
codex plugin add oceantoken@oceantoken
codex mcp login oceantoken

最後一條指令會開啟登入頁。在 Codex App 中也可以先加入 marketplace，再從 Plugins 面板安裝 OceanToken，依提示登入。

不用瀏覽器

在伺服器、CI 或其他無法用瀏覽器登入的地方，用 API Key 加入伺服器，而不是安裝外掛：

export OCEANTOKEN_API_KEY=sk-...
codex mcp add oceantoken --url https://mcp.oceantoken.ai/mcp --bearer-token-env-var OCEANTOKEN_API_KEY

Codex 只儲存變數名稱，每次啟動時從變數讀取 Key。codex mcp list 會顯示這個伺服器使用 Bearer token 驗證。這樣只加入工具，不含技能。npx -y @oceantoken/cli@latest connect codex --use-env-key 兩者都會加入，但會把 Key 本身寫進 config.toml。

`codex exec` 中的付費工具

codex exec 無法停下來問你，所以會拒絕所有會花餘額或上傳檔案的工具，錯誤為 MCP tool call requires approval, but approval policy is never。這些工具是 generate_image、create_video、generate_speech、transcribe_audio、ask_model 和 upload_file。核准這次執行需要的工具，並給沙箱網路存取權，讓 Codex 能下載工具回傳的內容：

codex exec -s workspace-write \
  -c 'mcp_servers.oceantoken.tools.generate_image.approval_mode="approve"' \
  -c 'mcp_servers.oceantoken.tools.generate_speech.approval_mode="approve"' \
  -c sandbox_workspace_write.network_access=true \
  "Make a hero image for the landing page and save it as hero.png"

-c 'mcp_servers.oceantoken.default_tools_approval_mode="approve"' 一次核准 OceanToken 的所有工具。
工具回傳的是下載連結。沒有 sandbox_workspace_write.network_access=true 時，Codex 的沙箱沒有網路，下載會失敗。
search_models、get_model、estimate_cost、get_account 和 get_job 只讀取，不需核准即可執行。
這些 -c 覆寫只在伺服器位於 config.toml 時有效（上面的 codex mcp add 或 connect codex --use-env-key 會這樣寫入）。若改用外掛，Codex 會以 invalid transport in mcp_servers.oceantoken 停止，所以 codex exec 請走 Key 的方式。

Claude Code

/plugin marketplace add OceanTokenAI/oceantoken-plugins
/plugin install oceantoken@oceantoken
/mcp

在 /mcp 中選擇 plugin:oceantoken:oceantoken，再選 Authenticate。

Claude 桌面 App 和 claude.ai

Settings → Connectors → Add custom connector，URL 填 https://mcp.oceantoken.ai/mcp，然後 Connect。這樣加入的是工具；技能隨 Claude Code 外掛提供。

Cursor

把 MCP 伺服器加入 Cursor。第一次執行工具時 Cursor 會要求你登入。若也要技能，請從儲存庫安裝外掛（其中有 Cursor marketplace 清單檔），或使用上面的指令。

Gemini CLI

gemini extensions install https://github.com/OceanTokenAI/oceantoken-plugins

然後在 Gemini CLI 中執行 /mcp auth oceantoken 並登入。這個擴充功能包含 MCP 伺服器和三個技能。

OpenClaw

openclaw plugins install clawhub:@oceantoken/oceantoken --accept-capabilities
openclaw mcp set oceantoken '{"url":"https://mcp.oceantoken.ai/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login oceantoken

套件包含三個技能。mcp set 會向 OpenClaw 註冊伺服器，讓 mcp login 能幫你登入。

其他 MCP 用戶端

伺服器是 https://mcp.oceantoken.ai/mcp，使用 streamable HTTP。它支援 OAuth 動態用戶端註冊，所以大多數用戶端只需要 URL：

{
  "mcpServers": {
    "oceantoken": { "type": "http", "url": "https://mcp.oceantoken.ai/mcp" }
  }
}

若要改用 API Key，請以 bearer token 傳送：

# Codex, without the plugin
export OCEANTOKEN_API_KEY=sk-...
codex mcp add oceantoken --url https://mcp.oceantoken.ai/mcp --bearer-token-env-var OCEANTOKEN_API_KEY

# Claude Code, without the plugin
claude mcp add --transport http oceantoken https://mcp.oceantoken.ai/mcp \
  --header "Authorization: Bearer $OCEANTOKEN_API_KEY"

這個伺服器也收錄在官方 MCP Registry，名稱為 ai.oceantoken/mcp，會瀏覽 registry 的用戶端可以依名稱找到它。

讓代理用上它

代理會自己選擇工具。遇到自己做不到的事，例如影片、配音、字幕和費用估算，它會去用 OceanToken。其他情況請直接點名：

在 Codex 中用 $oceantoken-media ...，在 Claude Code 中用 /oceantoken:oceantoken-media ...，或直接說「用 OceanToken 來……」。

或在 AGENTS.md（Codex）或 CLAUDE.md（Claude Code）中寫成專案規則：

Generate images, video, voice-overs and subtitles with the OceanToken tools.
Estimate the cost first and ask me before spending more than $2.

費用

工具生成的內容以與 API 相同的價格從你的餘額扣款，見模型。先請代理估價，這正是 estimate_cost 的用途。影片任務開始時會預留預估費用，完成時按實際費用扣款，失敗的任務不收費。每個請求都會出現在主控台的 Logs 中。

移除

npx -y @oceantoken/cli@latest disconnect <client>

這只會移除 connect 加入的內容。要立即切斷存取，請在 API Keys 中撤銷代理的 Key。

Claude Code：安裝外掛​

代理會得到什麼​

用一條指令接入​

選項​

登入​

手動設定​

Codex​

不用瀏覽器​

codex exec 中的付費工具​

Claude Code​

Claude 桌面 App 和 claude.ai​

Cursor​

Gemini CLI​

OpenClaw​

其他 MCP 用戶端​

讓代理用上它​

費用​

移除​