MCP

託管研究引擎 MCP

讓 Cursor、VS Code 和其他 MCP 用戶端呼叫與研究台相同的分析工作、自選、積分與模擬交易。設定只需 URL,然後登入。不要把 token 寫進設定檔。

傳輸
Streamable HTTP
登入
研究台 OAuth · PKCE
工具
27 個研究台工具

同一套研究台,從編輯器呼叫

MCP 端點掛在研究台 Node BFF。工具走同一套 /api、同一使用者、同一積分門檻與模擬交易開關。分析是非同步:start_analysis 立刻回傳 id,輪詢 get_analysis,再取 get_analysis_report。不是實盤券商,也不是 TradingView 行情 MCP 的複製。

一鍵或一條指令安裝

Cursor 與 VS Code 不必手改 JSON。其他用戶端貼上託管 URL。首次連線會開啟研究台登入,然後是授權頁。

一鍵安裝

Cursor

開啟 Cursor 並加入託管服務。依提示用研究台同一帳號登入。

加入 Cursor

貼上 URL

Claude Desktop / claude.ai

Customize → Connectors → Add custom connector。貼上託管 URL,然後登入。

開啟 Claude Connectors →
MCP URL
https://mcp.tradingagentsreport.com/mcp

命令列用戶端

複製指令,再在用戶端完成研究台登入。

Claude Code
claude mcp add --transport http tradingagents-report https://mcp.tradingagentsreport.com/mcp

然後在工作階段執行 /mcp,完成瀏覽器登入。

Codex
codex mcp add tradingagents-report --url https://mcp.tradingagentsreport.com/mcp
codex mcp login tradingagents-report

第二行會在瀏覽器開啟研究台。

Gemini CLI
gemini mcp add --transport http tradingagents-report https://mcp.tradingagentsreport.com/mcp

若 Gemini 要求驗證,執行 /mcp auth tradingagents-report。

其他用戶端與 JSON 設定

沒有安裝連結或 CLI 時使用這些。舊用戶端可能寫 streamable-http 而不是 http,URL 相同。不要加 Authorization 標頭,token 由 OAuth 發給。

mcpServers
{
  "mcpServers": {
    "tradingagents-report": {
      "type": "http",
      "url": "https://mcp.tradingagentsreport.com/mcp"
    }
  }
}

Cursor:~/.cursor/mcp.json。Claude Desktop:~/Library/Application Support/Claude/claude_desktop_config.json。

VS Code · servers
{
  "servers": {
    "tradingagents-report": {
      "type": "http",
      "url": "https://mcp.tradingagentsreport.com/mcp"
    }
  }
}

工作區:.vscode/mcp.json。VS Code 使用 servers,不是 mcpServers。

VS Code CLI
code --add-mcp '{"name":"tradingagents-report","type":"http","url":"https://mcp.tradingagentsreport.com/mcp"}'
Windsurf
{
  "mcpServers": {
    "tradingagents-report": {
      "serverUrl": "https://mcp.tradingagentsreport.com/mcp"
    }
  }
}

Windsurf:~/.codeium/windsurf/mcp_config.json。遠端欄位是 serverUrl,不是 url。

工具涵蓋什麼

二十七個工具轉發研究台 API。分析工作保持非同步。報價與新聞是研究台快照,不是完整指標包。模擬下單扣產品積分作手續費,不會到達券商。

分析工作

提交標的、輪詢進度、讀取決策卡與報告、查看歷史或取消。提交前檢查積分。

行情快照

解析上市地後取得報價、K 線、時段快照、新聞與公司身分。完整報表在已完成的研究報告裡。

自選股

列出、加入或移除目前使用者的自選。加入時可以只傳 ticker,由工具解析上市地。

積分與方案

查看方案/普通帳戶餘額、發票,以及能否開跑新分析。結帳仍在瀏覽器完成。

模擬交易

開通模擬帳戶、查看權益與成交、領取簽到、下單或撤單。受功能開關控制;不是實盤成交。

研究

resolve_listing

Normalize a ticker into exchange, symbol, and provider_symbol.

研究

start_analysis

Submit an async research job and return its id immediately.

研究

get_analysis

Job status and progress. Use get_analysis_report after success.

研究

get_analysis_events

Stage timeline for a running or finished job.

研究

get_analysis_report

Decision card and report sections after the job succeeded.

研究

list_analyses

List the signed-in user's recent analysis jobs.

研究

cancel_analysis

Request cancellation of a queued or running job.

積分

estimate_analysis

Check whether credits cover the start threshold.

行情

get_quote

Latest quote for an EXCHANGE:SYMBOL ticker.

行情

get_ohlcv

OHLCV bars. Timeframe defaults to D.

行情

get_ta_summary

Snapshot of last price, session, and identity. Not a full TA pack.

行情

get_news

Recent news headlines for a ticker.

行情

get_fundamentals

Company name, exchange, and logo. Statements are on reports.

自選

list_watchlist

List watchlist rows for the signed-in user.

自選

add_watchlist_item

Add a listing. A ticker is enough; the tool resolves the rest.

自選

remove_watchlist_item

Remove a watchlist row by id.

積分

get_usage

Period credits, bonus credits, and this cycle's ledger.

積分

get_subscription

Current plan, pending change, and invoices. Read-only.

模擬

open_paper_account

Open the default $10,000 simulated account, or return it.

模擬

get_paper_account

Cash, equity, P&L, and open positions.

模擬

list_paper_orders

Paper orders for the default or given account.

模擬

list_paper_fills

Paper fills (executions).

模擬

list_paper_cash_ledger

Opening grant, check-in, and cash adjustments.

模擬

get_paper_checkin

Daily simulated-USD check-in status.

模擬

claim_paper_checkin

Claim today's simulated-USD check-in.

模擬

place_paper_order

Place a simulated market or limit order. Not a live broker.

模擬

cancel_paper_order

Cancel a pending or triggered paper order.

可以這樣問助手

登入後通常不必重新啟動。使用能對應到工具的提示詞。

  • 用市場、新聞與基本面分析今天的 NASDAQ:AAPL。
  • 我的自選有哪些,哪些有未平倉模擬持倉?
  • 我還有多少積分,能不能一次開兩個分析?
  • 給我 HKEX:700 的最新報價與近期新聞。
  • 如有需要就開通模擬帳戶,並顯示現金與權益。
  • 以市價模擬買入 10 股 NASDAQ:AAPL。

在研究台登入

首次連線會開啟研究台登入,然後是授權頁。與網頁研究台使用同一帳號。營運無需在 Clerk Dashboard 開啟 OAuth applications 或 Dynamic Client Registration。嵌入式瀏覽器登不進去時,把連結複製到系統瀏覽器。

MCP 不會做什麼

託管 MCP 是研究台轉接層,沿用產品界線。

  • 不下真實券商訂單,也不持有真實資金。
  • 不發起 Stripe Checkout 或客戶入口。
  • 不暴露管理端、佇列或 API Key 工具。
  • 模擬交易關閉時,相關工具回傳 PAPER_FEATURE_DISABLED。
  • 分析仍從與網頁研究台相同的積分帳本扣費。

若需要更深的報價、選股器與行事曆,可併用 TradingView MCP。此端點是研究引擎,不是第二套行情 MCP。 TradingView MCP

MCP 常見問題

關於託管 MCP 的常見問題

MCP 設定裡要放 API key 嗎?

不需要。Cursor、VS Code 與 CLI 只加 URL。研究台登入後會發短期 access token。不要貼上 Clerk、Stripe 或 Core 金鑰。

用的是哪個帳號?

與瀏覽器研究台相同的帳號。自選、工作、積分與模擬交易都是該使用者的資料。

分析工作在 MCP 裡怎麼跑?

start_analysis 立刻回傳 id。輪詢 get_analysis 直到 succeeded,再呼叫 get_analysis_report。不要把提交當成已經出報告。

助手能替我交易嗎?

只能下模擬單,且僅在模擬交易開啟時。手續費扣產品積分。不會發到券商。