Skip to main content
MCP 發票辨識教學 - 步驟 3

設定第三方 MCP 管理工具

支援 MCP 的 AI 工具都有對應的設定方式,但為了更方便地管理,我們推薦使用管理應用程式。

3.1 下載管理應用程式

Toolbase 是一個免費的 MCP 管理工具,內建常見的 MCP 功能,支援多種主流 AI 工具包括 Claude、Cursor、Windsurf、Goose 等。

  • 前往 Toolbase 官網 安裝適合的版本
  • 這裡以 MacOS 系統搭配 Cursor AI 工具為例進行說明

3.2 設定 Asgard MCP

  1. 先準備好 Toolbase 已有支援的 AI 工具,並且先安裝設定完成,範例是使用 Cursor

  2. Toolbase 中選擇你使用的 AI 工具,切換到 Cursor,並點擊右上角安裝 Toolbase 套件

  3. 切換到 Custom 標籤,並點擊 Add Custom Plugin

  4. 基本設定:

    • Name: Asgard-parse-invoice(只能輸入英文和特定符號)
    • Type: 選擇 Local
    • Command: 輸入 Asgard MCP Server 的 Command 資訊,請記得將 /path/to/ 替換成你存放的 MCP 路徑
  5. 點擊 Save 儲存

  6. 將介面上 Asgard-parse-invoice 的切換開關啟動為 on

設定 Asgard MCP

3.3 設定本端資料夾存取 MCP

  1. Toolbase 操作介面中,切換到 Marketplace 標籤
  2. 找到 ToolsFilesystem,點擊齒輪按鈕進入編輯畫面
  3. 點擊 Select folders 選擇你本端的發票圖片資料夾位置
  4. 點擊 Save 儲存
  5. 將介面上 Filesystem 的切換開關啟動為 on

設定本端資料夾位置

tip

大部分的 AI 工具都不支援檔案系統存取權限,所以需要透過 Toolbase 來設定檔案讀取權限,直接會掃描你本地端的資料夾。

但是也有內建檔案系統存取權限的 AI 工具,例如這次示範的 Cursor,可以不需要透過 Toolbase 來設定檔案讀取權限,直接會掃描你本地端的資料夾。

如何與 AI 工具溝通以避免找錯檔案:

  1. 明確指定資料夾路徑:例如「請幫我處理 images/ 資料夾下的檔案」
  2. 提供具體的檔案名稱:例如「請處理 invoice.jpg 這個圖片」
  3. 使用檔案類型篩選:例如「幫我找所有 .jpg 圖片」
  4. 避免模糊描述:不要只說「幫我找相關檔案」,而是具體說明「幫我找 images/ 資料夾下的所有圖片」

這樣可以讓 AI 工具更精確地定位到你要處理的檔案,避免掃描到其他不相關的資料夾。

3.4 檢查 MCP 是否設定成功

如果前面都設定正確的話,你可以透過檢查設定是否成功(以 Cursor 為例):

  1. Cursor APP 中,點選上方 Cursor > Preferences > Cursor Settings
  2. Tools and Integrations 的 MCP Tools 會出現 Toolbase 的選項,並且是 on 的狀態
  3. 下面有個 xxx(數量) tools enabled 的選項,展開會看到你設定成功的 MCP 清單,會有很多筆是因為系統會將 MCP 的每個步驟都拆成細項,所以當裡面有出現開頭為 asgard_parse_invoice 以及 filesystem 的資訊,就代表設定已經成功

Cursor MCP 設定

tip

如果發現未設定成功,你可以回到 Toolbase 的左下角,點擊 Logs 會移動到特定資料夾,有 {你的 AI 工具名稱}-toolbase-proxy.log 的檔案,打開後會有詳細的錯誤訊息,請根據錯誤訊息進行調整

3.5 測試發票分析功能

現在我們來測試整個流程是否正常運作。

3.5.1 準備測試資料

  1. 準備至少一張發票圖片作為測試資料
  2. 確保圖片清晰可讀,並且圖片大小不要超過 10MB
  3. 放置在剛才設定好的 Filesystem 資料夾中

3.5.2 讓 AI 工具執行發票分析

AI 工具 中下達指令,請將 {資料夾路徑} 替換成你存放發票圖片的資料夾路徑:

請幫我辨識 {資料夾路徑} 資料夾內的發票檔案內容

等待分析結果回傳後,檢查回傳的資料是否正確。