Bitget Agentic 帳戶 連線指南

本文是什麼：Bitget Agentic 賬戶首次接入指南（在線文檔，以前叫 Agent 子賬戶）。交給 AI Agent 讀完後，會引導你完成「連接雲端 MCP → 舊版快檢 → 瀏覽器 OAuth 授權」的首次連接，全程不需要你手動創建或粘貼 API Key。

Agent 要做什麼：讀完本文後按 Step 1–5 執行：把雲端 MCP https://agent.bitget.com/mcp 直接寫進當前客戶端的 MCP 配置，多數情況下工具會立刻在本對話可用，不必新開對話 → 做舊版快檢，檢測到舊版就提醒用戶先處理持倉和未完成委託、升級後在授權頁新建賬戶 → 觸發客戶端側鑑權（Cursor 等客戶端的 mcp_auth/Connect 動作，不是服務端 tool），打開授權窗口觸發 OAuth，等用戶在瀏覽器完成登錄確認 → 用一次具體的賬戶類接口（如 getAccountAssets）確認雲端 MCP 已記住登錄態 → 給出完成提示。不要讓用戶手動創建或粘貼 API Key，也不要自己拼授權鏈接或監聽回調。

之後：首次授權完成後本文使命結束。本版本不依賴安裝本地 bitget-agentic skill——後續 Key 失效、重新授權、交易與風控規則，仍按本文 Step 1–5 的結論處理；本地 skill 暫緩更新，如已安裝且內容與本文不一致，以本文最新結論爲準。

只有用戶明確說不要授權時，才不發起 OAuth。只說「先看行情」不算拒絕授權。

先看這幾條

• 行情可以不登錄就查。交易、賬戶、Reality / rToken 要 OAuth。調用前用 guide 核對，沒有的接口就說明沒有。標準調用鏈：行情 guide(surface="market_data") → 拿到入參 → do_query；交易/賬戶 guide(surface="open_api") → 拿到 operation_id → do_request_open_api。

• 不做：提現、主賬戶劃到子賬戶、改主賬戶郵箱 / 手機 / 雙重驗證。美股直連、CFD、稅務、質押借貸、機構借貸不接入。

• 新版登錄態是 OAuth token，不是 API Key。一個 Agentic 賬戶只能授權給一個 Agent，一個 Agent 也只能接入一個 Agentic 賬戶——換綁（同一個 Agent 換綁新賬戶，或另一個 Agent 接已授權過的賬戶）都會替換掉原有授權（原有的監控掛單可能會失效，務必要提示給用戶）

• 舊版 SDK / npm 創建的 Agentic 賬戶無法走新版 OAuth：授權頁上選已有子賬戶會失敗。第一次用新版 OAuth 時，引導用戶新建賬戶，不要選舊賬戶。若該賬戶已是新版 OAuth 建過或連過的，重新授權時可複用。

• 可以同時用多個 Agent，每個各綁一個子賬戶，來實現管理多個 Agent 子賬戶目的；想讓一個 Agent 管理多個子賬戶，提示用戶進群反饋給產品團隊

• 授權窗口由雲端 MCP 打開。不要自己編授權鏈接。

• 用戶在使用過程中如果表現出明顯的產品層面困惑或疑問（不是這篇文檔能講清楚的操作細節），可以提示用戶進群向產品團隊反饋。

Step 1 · 連接雲端 MCP

不要配置 BITGET_API_*。只註冊這一個 HTTP 地址：https://agent.bitget.com/mcp。

• Claude Code：claude mcp add bitget-mcp-server -s user --transport http https://agent.bitget.com/mcp（-s user 讓這條註冊在用戶級生效，不是隻在當前項目裏；Claude Code 側不需要、也沒有 Cursor 那套 auth.CLIENT_ID 機制）

• Cursor：Agent 直接把下面這段配置寫進 ~/.cursor/mcp.json（已有其他 server 配置時合並進去，不要整份覆蓋）。不用等用戶自己去設置界面手填，寫完後這個工具通常會立刻出現在當前對話裏（狀態爲待授權）

• 其他客戶端：按該客戶端的 HTTP MCP 方式填同一地址

{ "mcpServers": { "bitget-mcp-server": { "url": "https://agent.bitget.com/mcp", "auth": { "CLIENT_ID": "cursor" } } } }

寫完配置後，先在本對話裏看這條連接是否已經可用：服務端只有 guide / do_query / do_request_open_api 三個 tool，mcp_auth 不是其中之一，不要當成 tool 去 tools/call，看不到它不代表 MCP 沒連上——真正的連接信號是看得到 guide 等三個 tool。多數情況下，剛寫入的這條連接會立刻在本對話可用，不需要新開對話，也不用重啓客戶端——不要默認假設看不到。

只有確認寫入配置、並在本對話裏實際看過仍然看不到 guide / do_query / do_request_open_api 這三個 tool 時，才需要繼續排查，不要把新開對話當成默認步驟。最常見的原因：當前客戶端的 MCP 配置裏還同時留着舊版本地 stdio MCP 包 @bitget-ai/bitget-agent-mcp，或手填了 API Key 的本地 MCP——舊版和新版配置技術上可能同時寫在文件裏、不會互相報錯（軟衝突），但產品設計上只認一套，舊版留在那裏會擋住新連接生效，這是硬衝突，要跟用戶講清楚、引導清理，不能只說"再檢查一下"。確認沒有這類舊版殘留、仍然看不到工具時，才新開對話。Claude Code：退出後重開 claude。Cursor：新開一個 Agent 對話。其他客戶端：按其重連方式處理。新對話裏發：

我已經把 https://agent.bitget.com/mcp 寫進本地 MCP 配置，但這個對話裏還是看不到 guide / do_query / do_request_open_api 這三個工具。請檢查一下我的 MCP 配置裏是不是還留着舊版本地 stdio MCP 包 @bitget-ai/bitget-agent-mcp，或手填了 API Key 的本地 MCP——如果有，這可能是擋住新連接的原因，請先告訴我要怎麼清理，再幫我確認新連接能不能用。

Step 2 · 授權前快檢舊版

即將 OAuth 時順手看一眼即可——不用建狀態文件，也不用跨對話記住這個結論，每次看當前客戶端存放 MCP 配置的位置就行。用戶明確不要授權則跳過這一步。命中下面兩樣之一就是舊版：

• 配置用本地 stdio 啓動 @bitget-ai/bitget-agent-mcp

• 這條 MCP 配置裏手填了 BITGET_API_KEY / BITGET_SECRET_KEY / BITGET_PASSPHRASE

舊版和新的雲端 MCP 技術上可能同時寫在配置文件裏、不會互相報錯（軟衝突），但產品設計上只認一套——兩邊都留着會讓調用混亂，這是硬衝突。看到舊版還在，調用時只用新版雲端 MCP 的三個服務端 tool（guide / do_query / do_request_open_api），不要碰舊版 stdio MCP 的工具，也不要用舊版留下的 API Key。

不算舊版：只配置了雲端地址 https://agent.bitget.com/mcp；@bitget-ai/bitget-agent-skill 是 skill。bgc、bitget-signal、它的行情 MCP、upgrade-all、不帶 --skill agentic 的 UTA skill 也都不是這一步的舊版，不要攔住 OAuth，用戶正要使用它們時提醒一句即可。

本機到底裝過哪個 npm 包、有沒有跑過 npm list / npm view，都不能拿來判斷——不要聯網查，也不要跑這些命令，只看上面兩條配置內容。不要假設配置文件在某個固定路徑，不要代用戶改配置。

找不到配置位置時，不要當成沒有舊版。告訴用戶沒查到，請用戶自己確認這臺電腦還有沒有舊版本地 stdio MCP 包 @bitget-ai/bitget-agent-mcp，或手填 API Key 的本地 MCP。用戶確認沒有，就按新版流程繼續；用戶不確定或說還有，就給出下面的提醒。

看到舊版還在，把下面這段發給用戶即可繼續往 Step 3 走——不需要等用戶明確回覆「同意升級」才能打開授權窗口；只有用戶明確說不想升級、不想處理舊版時才停下來，不發起 OAuth。

Step 3 · 打開授權窗口

觸發 OAuth 有兩條路徑，看當前客戶端支持哪種：① 客戶端原生鑑權動作——Cursor 等客戶端在這條 MCP 連接旁邊會有「Connect」/鑑權入口（有的地方顯示成 mcp_auth，但它不是服務端 tools/list 裏的 tool，不能當 tool 用 tools/call 調）；② 沒有這個入口時，直接調用一次私有接口，例如 do_request_open_api(operation_id="getAccountAssets", params={...})——未授權會返回 HTTP 401，客戶端會據此自動彈出 OAuth 授權頁，不需要 Agent 自己處理這個 401。

1. 先按上面兩條路徑之一觸發鑑權（客戶端側 Connect 動作，或私有接口的 401）。

2. 沒有彈出窗口、但返回了鏈接時，用當前環境打開瀏覽器的方式打開，不要先把鏈接發給用戶。

3. 打不開時，才發送鏈接原文，並說明是因爲當前環境沒有打開窗口的權限。

告訴用戶：即將打開瀏覽器完成授權，不用複製 API Key。不要改用戶提示語裏的 Bitget 域名。

Cursor：整段流程只觸發一次客戶端側鑑權動作；不要連點 Authenticate / 重連。登錄用當次打開的瀏覽器頁。若出現「Authorization session ended」且回調鏈接裏已經帶 code，說明是舊會話作廢，重新只走一輪再授權即可。

支援的 client_id：打開 OAuth 時按當前客戶端對照選用；授權窗口仍由雲端 MCP / 客戶端鑑權打開。不要自己拼授權鏈接，也不要改 redirect_uri。

[
  {
    "client_id": "https://claude.ai/oauth/claude-code-client-metadata",
    "client_name": "Claude Code",
    "redirect_uris": [
      "http://localhost/callback"
    ],
    "loopback_port_agnostic": true,
    "fetch_cimd": false
  },
  {
    "client_id": "https://claude.ai/oauth/mcp-oauth-client-metadata",
    "client_name": "Claude / Duet",
    "redirect_uris": [
      "https://claude.ai/api/mcp/auth_callback"
    ],
    "loopback_port_agnostic": false,
    "fetch_cimd": true
  },
  {
    "client_id": "https://chatgpt.com/oauth/client.json",
    "client_name": "ChatGPT / Dot",
    "redirect_uris": [
      "https://chatgpt.com/connector_platform_oauth_redirect"
    ],
    "redirect_uri_prefixes": [
      "https://chatgpt.com/connector/oauth/"
    ],
    "loopback_port_agnostic": false,
    "fetch_cimd": false
  },
  {
    "client_id": "cursor",
    "client_name": "Cursor",
    "redirect_uris": [
      "https://www.cursor.com/agents/mcp/oauth/callback",
      "https://www.cursor.com/bot/mcp/oauth/callback",
      "https://grok.com/connectors-oauth-exchange-code/"
    ],
    "loopback_port_agnostic": false,
    "fetch_cimd": false
  },
  {
    "client_id": "https://cursor.com/oauth/mcp-client.json",
    "client_name": "Cursor CIMD / Grok Bot",
    "redirect_uris": [
      "https://www.cursor.com/agents/mcp/oauth/callback",
      "https://www.cursor.com/bot/mcp/oauth/callback",
      "https://grok.com/connectors-oauth-exchange-code/"
    ],
    "loopback_port_agnostic": false,
    "fetch_cimd": true
  },
  {
    "client_id": "codex",
    "client_name": "OpenAI Codex",
    "redirect_uris": [
      "http://localhost/callback"
    ],
    "loopback_port_agnostic": true,
    "fetch_cimd": false
  },
  {
    "client_id": "muse",
    "client_name": "Meta Muse",
    "redirect_uris": [
      "https://agent.meta.ai/api/hatch/oauth/callback"
    ],
    "loopback_port_agnostic": false,
    "fetch_cimd": false
  },
  {
    "client_id": "minimax",
    "client_name": "MiniMax Code",
    "redirect_uris": [
      "http://localhost/callback",
      "http://localhost/auth/callback"
    ],
    "loopback_port_agnostic": true,
    "fetch_cimd": false
  }
]

Step 4 · 網絡與代理（bitget.com）

授權頁和回調要訪問 bitget.com。超時、ECONNREFUSED、ENOTFOUND、network、fetch failed、無法連接 bitget.com，或用戶說打不開 Bitget，按網絡問題處理，不要當成普通授權失敗立刻重試。

1. 看當前環境裏已經生效的代理，不要默認某一個端口或某一種配置文件。

2. 有代理：讓 shell 或 MCP 啓動環境走代理，從 Step 3 重試。

3. 沒有代理：請用戶打開。等用戶說已經開好，再從 Step 3 重試。

4. 不要未查網絡就讓用戶反覆點允許，不要自己拼 bitget.com 鏈接，不要讓用戶手填 API Key。

Step 5 · 成功

用戶在頁面登錄並確認。Agent 不代填密碼。

已登錄的標誌：客戶端顯示該 MCP 已登錄，且 do_request_open_api(operation_id="getAccountAssets", params={...}) 這類要登錄的調用能通過。頁面看起來走完了不算。除 getAccountAssets 外，也可用其他只讀賬戶類 operation_id 確認（如 getDeductInfo，具體以 guide(surface="open_api") 返回的列表爲準）。

後續 Key 失效、重新授權、交易規則仍按本文結論處理；不要把 token 寫進任何本地文件。

用戶要刪掉舊版 API Key：新版賬戶沒有 API Key，也不能在網頁單獨刪 Key。先用 guide(surface="open_api") 找到能拿到賬戶名稱的 operation_id 並調用，查不到就說明沒查到，不要編。再用這段話，把名稱填進去：

沒成功

沒有明確原因就不要猜，問要不要再發起一次。