概覽
你的 AI assistant 可以透過 fcontext MCP server，使用你的 fcontext 帳戶存取已認證、按量計費的市場資料。第一個版本提供即時行情、證券靜態資料、計算指標、K 線、市場新聞、財務日曆和熱門異動等工具。 遠端 MCP endpoint：認證
MCP server 使用 OAuth 2.1。互動式 MCP 用戶端首次連線時，它會重新導向你登入並核准市場資料存取。MCP 用戶端不需要 API key。 授權伺服器：market_data scope。
API key 用於
https://openapi.fcontext.com/api/market-data 的 HTTP Market Data API。MCP 用戶端應使用 OAuth，除非你正在建構自己的伺服器端整合。開始使用
選擇支援遠端 MCP server 的用戶端，並新增 fcontext endpoint：- Codex Desktop
- Claude / Claude Code
- Cursor
新增一個遠端 MCP server，URL 為：當 Codex 提示時完成 OAuth 登入，然後在需要市場資料的聊天中啟用該 server。
MCP 工具
連線後，你的 AI assistant 可以呼叫這些工具：| 工具 | 描述 |
|---|---|
fcontext_get | 在 /api/market-data 之後透過相對路徑呼叫允許的 fcontext 市場資料 GET 介面。 |
fcontext_quote | 取得一個或多個標的的即時行情。 |
fcontext_static_info | 取得證券靜態資訊。 |
fcontext_calc_index | 取得計算類行情指標。 |
fcontext_candlestick | 取得某個標的的歷史 K 線資料。 |
fcontext_news | 取得市場新聞。 |
fcontext_finance_calendar | 取得財務日曆事件。 |
fcontext_top_movers | 取得熱門市場異動。 |
使用範例
連線後，可以試著向 AI assistant 提問：- “What is Apple’s latest quote?”
- “Show me one month of daily candlesticks for Nvidia.”
- “What are today’s top US market movers?”
- “Find recent news for Tesla.”
- “Check upcoming finance calendar events for this week.”
- “Compare static information for AAPL.US and MSFT.US.”
疑難排解
| 問題 | 檢查項目 |
|---|---|
| 用戶端無法發現授權中繼資料 | 確認它可以存取 https://openapi.fcontext.com/api/auth/.well-known/oauth-authorization-server 或 https://openapi.fcontext.com/.well-known/oauth-authorization-server/api/auth。 |
MCP 請求回傳 401 | 重新連接 MCP server，並再次完成 OAuth。回應會包含帶有 protected resource metadata URL 的 WWW-Authenticate。 |
MCP 請求回傳 403 | Token 有效，但不包含 market_data scope。請重新授權用戶端。 |
| 工具呼叫因路徑錯誤失敗 | 使用 fcontext_get 時請使用相對路徑，例如 quote 或 content/news；絕對 URL 和路徑穿越會被拒絕。 |