Bitget Agentic 帳戶連線指南

2026-09-03 08:38010

本文是什麼： Bitget Agentic 首次接入指南（線上文件）。把它交給 AI Agent 後，Agent 會引導你完成「安裝 Skill + MCP → 瀏覽器 OAuth 授權 → 自動產生憑證」的首次連線，全程不需要你手動建立或複製 API Key。

Agent 要做什麼： 讀取本文後，按 Step 0–5 依序執行：安裝本機 Skill 與 MCP → 呼叫 MCP 授權 tool 觸發 OAuth → 等待使用者在瀏覽器完成授權 → 確認 MCP 已儲存憑證 → 給出完成提示。你不要讓使用者手動建立或貼上 Key，也不要自行拼 OAuth URL 或監聽回呼。

之後： 首次授權完成後本文使命結束；後續 Key 失效、重新授權、交易與風控由本機 bitget-agentic skill 處理（npx @bitget-ai/bitget-agent-skill --skill agentic）。

Step 0 · 裝本機 Skill

npx @bitget-ai/bitget-agent-skill --target all --skill agentic # 預設安裝到全部支援的用戶端（cursor / claude / codex）

若你的用戶端不在預設清單，用 --target <用戶端> 指定，或按用戶端要求手動放置 skill 檔案到對應目錄。
必須帶 --skill agentic；不帶該參數預設只裝 UTA（手填 Key）skill。

Step 1 · 裝 MCP

前置： Node 20+（node -v 確認）。

安裝（全域）：

npm i -g @bitget-ai/bitget-agent-mcp

設定約束：

不要設定 BITGET_API_* 環境變數（憑證由 OAuth 回呼落盤，不走 env）
MCP 使用 stdio 協定，註冊進用戶端時的啟動命令為：npx -y @bitget-ai/bitget-agent-mcp（見下方「用戶端差異 · MCP 註冊」）

用戶端差異 · MCP 註冊

MCP 需註冊進目前用戶端後 Agent 才能呼叫其 tool。由 Agent 偵測自身所在用戶端並執行對應註冊：

Claude Code： claude mcp add bitget-agentic -- npx -y @bitget-ai/bitget-agent-mcp（或改 ~/.claude.json / 專案 .mcp.json）
Cursor： 在 Cursor 設定 → MCP 中新增 stdio server，command 填 npx -y @bitget-ai/bitget-agent-mcp
其他用戶端： Agent 按目前用戶端的 MCP 註冊方式自行註冊一個 stdio server，command 填 npx -y @bitget-ai/bitget-agent-mcp

註冊後重啟會話或用用戶端 MCP 重連（如 Claude Code 的 /mcp），工具才會出現。若呼叫報「工具不存在」，先檢查註冊與重連，再查 MCP 是否執行，不要誤判為授權問題。

Step 2 · 觸發 OAuth

必須調 MCP 授權 tool authorize_start，禁止 LLM 拼 URL / 監聽 callback。

呼叫後授權 tool 回傳授權連結（data.authorizeUrl 欄位）與 sessionId。若瀏覽器未自動開啟，Agent 必須手動開啟，不等使用者複製貼上：

macOS: open "<authorizeUrl>"
Linux: xdg-open "<authorizeUrl>"
Windows: start "" "<authorizeUrl>"
開啟失敗（無 GUI／無瀏覽器／命令不存在）才把連結文字發給使用者自行開啟。連結原樣使用授權 tool 回傳值，禁止自行拼接或修改。

拿回什麼： 使用者在瀏覽器完成授權後，MCP/SDK 透過回呼接收並本機儲存憑證（見 Step 5）。Agent 需確認已授權才算完成：呼叫 authorize_wait（傳入 authorize_start 回傳的 sessionId）等待回傳，或呼叫 get_auth_status 確認狀態為已授權。

提示：

即將開啟瀏覽器完成 Agentic 帳戶授權：登入 → 選 Create new 或 Use existing → Allow → Bitget App 裝置鑑權 → Use existing 須填 Key 備註。無需複製 API Key。

Step 3–4 · 瀏覽器（使用者操作，Agent 等待）

Step 3： 登入；KYC 未完成 → 站內完成後再 OAuth（Case L）
Step 4： Create new 或 Use existing → App 裝置鑑權
- Create new：建立新的 Agentic 帳戶
- Use existing：選擇既有 Agentic 帳戶，須填 Key 備註
- 不含 Playbook · 再授權 = 新 Key、舊 Key 保留（再次授權會更新本機憑證，Web 上舊 Key 預設保留）
- 選戶由 OAuth 前端完成，Agent 只負責觸發授權並等待結果

Step 5 · 成功

MCP 本機落盤三件套 + 瀏覽器到資產頁。調 get_auth_status = 已授權。

三件套 = API Key、Secret Key、Passphrase；由 MCP/SDK 在回呼側接收並本機儲存；Web 不存；使用者無需複製或貼上。
成功判定：只有 MCP 確認憑證已儲存且授權狀態成功，才算完成；瀏覽器頁面完成不作為成功依據。

提示：

首次授權完成。之後如果 Key 失效或你說「重新授權」，我會重新開啟 OAuth。若要取消這個 Agent 的交易權限，請在 Bitget 網頁端中刪除該 Agentic 帳戶對應的 API Key；刪除 Key 不會自動平倉或撤銷掛單。接下來請你手動從 Bitget 主帳戶向 Agentic 帳戶轉入一筆你願意承擔的小額資金，到帳後先對我說「查看 Agentic 帳戶餘額」，再嘗試交易。轉帳和主帳戶操作由你自己完成；我不會操作你的主帳戶，只能操作已授權的 Agentic 帳戶。實際可交易資產以帳戶目前開放範圍為準。

不要讓使用者貼上 Key。此後交給本機 Skill。 若本會話未載入 bitget-agentic skill（skill 清單在會話啟動時掃描，本會話內新裝的 skill 可能不可用），提示使用者新開一個對話再繼續——新會話會自動載入該 skill，Agent 才有其執行時規則。

首次 OAuth 失敗（僅 Guide）

只按錯誤碼歸因： 授權 tool 回傳明確錯誤碼時按錯誤碼處理；無明確錯誤碼時一律兜底，不猜原因，重新走授權流程。

錯誤碼 → 動作：

錯誤碼

動作

提示

配額錯誤碼（K 配額滿）	Use existing	「請改選 Use existing。」
KYC 錯誤碼（L KYC 未完成）	完成後再 OAuth	「請先完成 KYC。」
`MCP_CONNECTION_ERROR`（M MCP 未執行）	排查後 OAuth	「請檢查 Node 20+、MCP 設定，終端機跑 npx @bitget-ai/bitget-agent-mcp。」
工具不存在 / 方法不存在（M2 MCP 未安裝／未註冊）	引導安裝註冊後重試	「MCP 工具不存在：請執行 npm i -g @bitget-ai/bitget-agent-mcp 安裝並註冊後重試。」