AI 整合 / MCP
服務可用 v0.2.0

非小號 MCP

透過 Model Context Protocol,讓支援遠端 MCP 的 AI 助手以統一、唯讀的方式查詢非小號市場資料。

服務連線資訊可用

服務位址、驗證請求標頭、工具和契約版本均由 MCP 公開目錄即時提供。

能力與工具

工具目錄

分類、工具名稱、說明和權限以 MCP 公開目錄傳回的資料為準。

工具邊界

這些工具僅查詢獲准的市場資料,不提供交易、轉帳、帳戶資產、投資建議或事實查核。

整合方式

開始整合

  1. 1
    建立 MCP Token

    前往使用者中心的帳號安全頁面,產生並妥善保存你的專屬 Token。

    管理 MCP Token →
  2. 2
    複製用戶端設定

    將右側設定加入支援 MCP 的 AI 用戶端,並替換為你保存的 Token。

  3. 3
    開始提問

    連接完成後,即可用自然語言查詢已開放的非小號市場資料。

服務位址

Streamable HTTP https://fxhapi.feixiaohao.com/mcp 服務可用

設定範例

{
  "mcpServers": {
    "feixiaohao-mcp": {
      "url": "https://fxhapi.feixiaohao.com/mcp",
      "headers": {
        "X-FXH-API-KEY": "YOUR_MCP_TOKEN"
      }
    }
  }
}

不同用戶端的設定格式和驗證能力可能不同,請以目前用戶端支援的 MCP 設定格式為準。

回應規範

統一回應

業務資料放在 data,來源、資料新鮮度和本地化資訊放在 meta;金額會標明計價資產,時間統一使用 ISO 8601 UTC。

{
  "data": {},
  "meta": {
    "contractVersion": "0.2.0",
    "source": "FXH",
    "sourceUpdatedAt": "2026-10-20T08:30:00Z",
    "fetchedAt": "2026-10-20T08:30:02Z",
    "isStale": false,
    "locale": "zh-TW"
  },
  "warnings": []
}

錯誤處理

錯誤處理

錯誤碼含義建議操作
INVALID_ARGUMENT參數、列舉值或範圍無效修正請求後重試
UNAUTHENTICATED存取金鑰缺失、無效或已撤銷檢查或重新建立金鑰
PERMISSION_DENIED缺少工具或內容範圍權限檢查 scope 與頻道授權
RATE_LIMITED超出呼叫頻率或額度依 retryAfter 等待
UPSTREAM_UNAVAILABLE底層資料服務無法使用有限次數重試

上游異常不會偽裝成成功的空清單。錯誤回應會提供穩定的錯誤碼、是否可重試,以及用於排查的 requestId。

驗證與安全

驗證與安全

使用請求標頭傳遞存取金鑰;金鑰不會放入 URL、查詢字串或錯誤訊息。

X-FXH-API-KEY: YOUR_MCP_TOKEN
  • 完整金鑰只在建立時顯示,伺服器不以明文儲存。

首版邊界

首版邊界

首版包含

公開市場資料、資產資料、行情、榜單、K 線、交易所、板塊以及經授權的資訊內容。

首版不包含

交易執行、個人資料、進階衍生品、鏈上位址分析、技術指標計算、語意搜尋和按次付費。

資訊工具僅傳回獲准的欄位和內容。內容授權狀態未知時預設不開放。

服務狀態

上線狀態

公開目錄目前顯示服務可用。實際可呼叫的工具仍取決於 Token 權限、速率限制、內容授權和目標用戶端相容性。

查看互動示範