# Eqvero MCP設定：Claude Code

## 串接內容

Eqvero提供美股與港股公司數據、原始披露搜尋、公司研究及金融計算。 MCP負責串接工具，Skill提供研究指引，並非連線必要條件。

## 安裝前

1. 檢查目前客戶端、作業系統與既有MCP設定，說明擬變更位置與範圍，取得用戶確認後才合併，保留其他伺服器。
2. 需要專用Eqvero API金鑰及帳戶API／MCP存取權。可在https://eqvero.com/zh-hant/developers?tab=keys建立金鑰。若沒有金鑰，請用戶在此裝置安全輸入，不要要求在對話傳送完整金鑰。
3. 不要變更模型、全域帳戶設定或其他搜尋工具。不要覆蓋有效憑證，或把金鑰放入網址、記錄、公開程式碼庫或共用檔案。

## 設定

伺服器網址: https://eqvero.com/api/mcp
傳輸方式: Streamable HTTP
身分驗證: Authorization: Bearer <EQVERO_API_KEY>
伺服器名稱: eqvero

在使用Claude Code的終端機執行指令。

```sh
claude mcp add --transport http eqvero https://eqvero.com/api/mcp --header "Authorization: Bearer <EQVERO_API_KEY>"
```

在客戶端安全設定中把佔位符換成實際金鑰。範例不代表連線已成功。Eqvero目前不提供OAuth登入或免金鑰存取。其他客戶端欄位可能不同，應使用該客戶端支援的HTTP MCP設定，不要原樣照抄。

## 驗證連線

列出目前伺服器工具，再以query AAPL、limit 1執行companies_search。只有傳回實際公司名稱、股票代碼與ID才算唯讀測試通過。若設定需重新載入或重啟，應說明尚未生效。寫入設定不等於已驗證連線。

`companies_search({"query":"AAPL","limit":1})`

不要呼叫research_create、analytics_create或任何計費任務測試安裝。401檢查金鑰，402檢查帳戶權限與額度，403檢查權限範圍。不要自動建立或撤銷其他金鑰。

## 選用：安裝研究Skill

公開來源：https://github.com/LJK0719/eqvero-skill。僅在用戶需要研究方法指引時閱讀README與SKILL.md，並在客戶端支援的Skill範圍安裝。未經確認不要全域安裝，也不要執行下載內容附帶的任意腳本。

## 研究與計算

僅在用戶明確要求研究或計算後建立任務。儲存傳回任務ID，使用research_get／analytics_get讀取狀態與結果。離開頁面或MCP斷線不會取消已接收任務。

建立、追問與重試使用穩定idempotencyKey。重送相同操作時重用，僅在輸入變更時建立新操作。回應遺失時，用research_submission檢查接收結果，不要用新key重新提交。僅在明確要求停止時呼叫取消。