From fa02a90b524191845eeb26c718cafb9447c8daf8 Mon Sep 17 00:00:00 2001 From: linsamtw Date: Tue, 26 May 2026 23:07:41 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9A=AB=E7=B7=A9=E9=81=A0=E7=AB=AF=20?= =?UTF-8?q?MCP=EF=BC=8C=E7=A7=BB=E9=99=A4=20mcp.finmindtrade.com=20?= =?UTF-8?q?=E4=BD=BF=E7=94=A8=E8=80=85=E6=96=87=E4=BB=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 遠端 MCP（mcp.finmindtrade.com）暫不做：Claude.ai 網頁版 custom connector 只吃 OAuth 2.1（大工程），其他 client 走本機 stdio 已足夠。移除指向尚未存在 endpoint 的使用者文件，避免誤導： - 刪除 install/claude-ai.md（整份是 Claude.ai 網頁版遠端設定） - README：移除 host 表「Claude.ai (Web)」列 + 發佈段的 remote endpoint 註記 - knowledge/token-guide.md：移除「Remote 模式（Claude.ai integrations）」整段、 host 清單去掉 Claude.ai - docs/mcp-original-readme.md：intro 去掉 Claude.ai 保留 docs/spec.md（設計 spec）與 docs/plans/2026-05-17.md（歷史 plan）作為設計記錄， 內含未來真要做時的方向（host 在 api FastAPI mount MCP + backend 做 OAuth）。 Co-Authored-By: Claude Opus 4.7 (1M context) --- README.md | 2 -- docs/mcp-original-readme.md | 2 +- install/claude-ai.md | 36 ------------------------------------ knowledge/token-guide.md | 19 +------------------ 4 files changed, 2 insertions(+), 57 deletions(-) delete mode 100644 install/claude-ai.md 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 模式。