diff --git a/README.md b/README.md index 2c610bd..4b0aa42 100644 --- a/README.md +++ b/README.md @@ -26,7 +26,6 @@ pipx install finmind-mcp |---|---| | Claude Desktop | [install/claude-desktop.md](install/claude-desktop.md) | | Claude Code | [install/claude-code.md](install/claude-code.md) | -| Claude.ai (Web) | [install/claude-ai.md](install/claude-ai.md) | | Cursor | [install/cursor.md](install/cursor.md) | | Windsurf | [install/windsurf.md](install/windsurf.md) | | Gemini CLI | [install/gemini-cli.md](install/gemini-cli.md) | @@ -81,7 +80,6 @@ git push origin v0.1.0 # → CI 自動 build + 發 PyPI `knowledge/` 由 hatch `force-include` 打包進 wheel(`finmind_mcp/_knowledge/`),server runtime 直接讀、不用 compile;發版後用戶 `uvx finmind-mcp` / `pipx install finmind-mcp` 即抓到新版。 > 首次需在 PyPI 設好 trusted publisher(project `finmind-mcp` / repo `FinMind/FinMind-MCP` / workflow `publish.yml` / env `pypi`)。 -> Remote endpoint `mcp.finmindtrade.com`(給 Claude.ai integrations)另走 service repo 的 docker compose + traefik,不在此 repo。 ### Custom GPT(ChatGPT 線)— 產物自動 build、建 GPT 手動 diff --git a/docs/mcp-original-readme.md b/docs/mcp-original-readme.md index 85994f6..b4b8771 100644 --- a/docs/mcp-original-readme.md +++ b/docs/mcp-original-readme.md @@ -1,7 +1,7 @@ # finmind-mcp Official FinMind MCP server. Exposes the FinMind v4 API to MCP-compatible -AI tools (Claude Desktop / Code / Claude.ai, Gemini CLI, Cursor, Windsurf). +AI tools (Claude Desktop / Code, Gemini CLI, Cursor, Windsurf, Codex). ## Tools diff --git a/install/claude-ai.md b/install/claude-ai.md deleted file mode 100644 index 38d6ab1..0000000 --- a/install/claude-ai.md +++ /dev/null @@ -1,36 +0,0 @@ -# Claude.ai(Web) - -在 Claude.ai 網頁版透過 remote MCP integration 連接 FinMind 官方 server,免本機安裝即可使用。 - -## 安裝套件 - -Claude.ai 為 remote 模式,**不需要**在本機安裝任何套件,全部由官方 host `https://mcp.finmindtrade.com` 提供。 - -> 目前 remote endpoint 尚在部署中(coming soon)。在正式上線前,Claude.ai 用戶建議改用 [Claude Desktop](./claude-desktop.md) 走本機 stdio 模式。 - -## 設定 - -待 `mcp.finmindtrade.com` 部署上線後,設定步驟如下: - -1. 打開 Claude.ai → 右上角頭像 → **Settings** -2. 進入 **Integrations** 分頁 -3. 點 **Add custom integration** -4. 在 URL 欄位填入: - - ``` - https://mcp.finmindtrade.com/sse - ``` - -5. 按 **Connect**,瀏覽器會跳到 finmindtrade.com OAuth 授權頁,用既有帳號登入並按「允許」即可完成註冊。 - -## 取得 Token - -請先依 [token 取得指引](../knowledge/token-guide.md) 取得 FinMind Token。 - -> Remote 模式採 OAuth flow:首次連線會引導完成 FinMind Token 授權,授權後 token 由 Claude.ai 端管理,您**不需要**手動貼 token 到對話框。要撤銷授權請到 finmindtrade.com 會員中心 → 已授權應用 → 移除。 - -## 驗證 - -回到 Claude.ai 任一對話視窗,輸入「列出 FinMind 可用的 dataset」,應該看到工具圖示出現並回傳 dataset 清單;亦可到 **Settings → Integrations** 確認 FinMind 顯示為 **Connected**。 - -![](../../docs/images/install/claude-ai.png) diff --git a/knowledge/token-guide.md b/knowledge/token-guide.md index 86595fc..a54f520 100644 --- a/knowledge/token-guide.md +++ b/knowledge/token-guide.md @@ -1,7 +1,7 @@ # FinMind Token 取得與設定 FinMind 所有 API 請求都需要 token;本文件說明如何取得,並在 ChatGPT Custom GPT -與各種 MCP host(Claude Desktop / Claude Code / Cursor / Windsurf / Gemini CLI / Claude.ai) +與各種 MCP host(Claude Desktop / Claude Code / Cursor / Windsurf / Gemini CLI) 完成設定。 ## 1. 取得 Token @@ -79,20 +79,3 @@ uvx finmind-mcp --help # 用 uv 即時跑,不長駐安裝 驗證:重啟 host,輸入「列出 FinMind 可用的 dataset」,應出現 MCP 工具圖示並回覆 dataset 清單;若得到 `AuthenticationError`,請檢查環境變數是否正確設定且未含 多餘空白 / 引號。 - -### Remote 模式(Claude.ai integrations) - -Remote 模式由官方 host `https://mcp.finmindtrade.com`(部署後啟用)提供, -Claude.ai 透過 HTTP / SSE 連線,使用 MCP 標準的 OAuth flow 取得授權: - -1. Claude.ai → **Settings → Integrations → Add MCP server** -2. URL 填 `https://mcp.finmindtrade.com`(部署上線後提供,目前 placeholder) -3. 按 **Connect**,瀏覽器會跳到 finmindtrade.com OAuth 授權頁 -4. 用既有帳號登入並按「允許」 -5. Claude.ai 收到 access token 後完成註冊,之後直接在對話中觸發 FinMind 工具 - -Remote 模式下用戶**不需要**手動貼 token;授權後 token 由 Claude.ai 端管理, -撤銷請到 finmindtrade.com 會員中心 → 已授權應用 → 移除。 - -> 注意:remote endpoint 仍在部署中,正式 URL 上線後本檔案會同步更新。 -> 在那之前,Claude.ai 用戶可改用 Claude Desktop 走 stdio 模式。