MCP 與 API › Summa MCP

安裝 Summa MCP

需要 Summa 帳號(30 天導入期,全部功能免費)。

免費開始30 天導入期,收支筆數不限,不用綁卡
示範資料Summa 的 AI › 連線:MCP 伺服器網址 https://app.summa.com.tw/mcp 與〔複製〕
示範資料接好的連線:Claude Code,範圍是查帳、擬草稿、替我確認,到期日與〔改範圍〕〔撤銷〕

安裝

查帳、寫草稿、導入都能用。

  1. 到 Summa 的「AI」→「連線」,在「MCP 伺服器網址」按〔複製〕。
  2. 在終端機打一行,把 <MCP 伺服器網址> 換成剛剛複製的網址:
    claude mcp add --transport http --scope user summa <MCP 伺服器網址>

    你會看到:終端機回一行:

    Added HTTP MCP server summa with URL: https://…/mcp to user config
  3. 打開 Claude Code。

    你會看到:版本資訊下面一行黃字。這是正常的,代表還沒登入 Summa:

    ⚠ 1 MCP server needs authentication · run /mcp
  4. 輸入 /mcp 按 Enter,在 User MCPs 底下選 summa 按 Enter,再選 1. Authenticate。

    你會看到:選 summa 之後的畫面:

    Status: ⚠ needs authentication Auth: ✘ not authenticated ❯ 1. Authenticate 2. Disable
  5. 瀏覽器會自己打開。登入 Summa(有開兩步驟驗證的,再輸入 6 位數驗證碼),看過授權頁,按最下面的〔允許〕。

    你會看到:授權頁的標題是「其他 AI 工具(Claude Code (summa))想連到你的 Summa」,「授權給這個網站」寫「你的電腦(localhost)」。查帳一定有;擬草稿、導入原檔預設勾;「允許這個連線替我確認、過帳、關帳」預設不勾,要給再勾。權限不會比你多。

  6. 瀏覽器換到一頁寫「Authentication successful」:這樣就連好了,可以關掉這一頁。瀏覽器上的 Claude Code 頁面:Authentication successful,You can close this tab and return to Claude Code.

    你會看到:終端機同時寫:

    ⎿ Authentication successful. Connected to summa.

    停在空白頁或「無法連上這個網站」,也不用重來這時終端機停在「URL >」。把瀏覽器網址列那一整串網址(http://localhost:數字/callback?code=…)複製下來,貼在「URL >」後面,按 Enter,就會連上。

  7. 再輸入一次 /mcp。

    你會看到:summa 前面變成 ✔,後面寫工具數;選進去是「Status: ✔ connected」。連好之後,說「帶我開始用 Summa」。

卡住了怎麼辦

授權頁打不開
在 /mcp 選 summa:寫「MCP endpoint not found」或「ECONNREFUSED」的,是網址貼錯了,用下面這行拿掉,再照第 2 步重裝一次。瀏覽器沒有自己開的,終端機上有一串授權網址,按 c 複製再貼到瀏覽器;不要用滑鼠選,長網址折行會少一段,登入後就會看到「client_id 或 redirect_uri 不正確」。
claude mcp remove summa -s user
按了〔允許〕沒反應,或停在空白頁、無法連上這個網站
照第 6 步:把網址列那一整串網址貼到終端機的「URL >」後面,按 Enter。Claude Code 已經關掉了的,重新打開,在 /mcp 選 summa 再選 Authenticate,不要用舊的瀏覽器分頁(每次授權的網址都不一樣)。
/mcp 還是顯示 needs authentication
在授權頁按了〔取消〕(瀏覽器寫「Authentication failed」,/mcp 寫「OAuth error: access_denied」),或在 /mcp 選過 Clear authentication,都會這樣。在 /mcp 選 summa,再選 Authenticate,這次按〔允許〕。
/mcp 清單裡沒有 summa
之前用沒帶 --scope user 的指令裝的,只在當時那個資料夾看得到;回那個資料夾開 Claude Code,或用第 2 步的指令再裝一次。
/mcp 最上面出現 [Conflicting scopes]
summa 裝了不只一份,網址也不一樣(警告裡會寫是哪兩個 scope)。留 user 那一份,把另一份拿掉:另一份是 local 的打下面這行;是 project 的,把 local 換成 project。
claude mcp remove summa -s local

還是不行就寫信給 service@amplify.com.tw。

能做什麼

查帳

「9 月賺多少?」「誰還欠我們錢?」問了就有數字。

整理資料

網銀對帳單、發票清單、收據照片交給它,整理成草稿。

擬傳票

每一筆附理由,等你確認。

舊帳

Excel 或舊系統的檔交給它,整理成開帳草稿,你逐筆確認後過帳。

由你決定

該不該認列算哪一類稅付款寄給客戶重開已關帳的月份都由你決定。

安全

  • 用你的 Summa 帳號登入授權,你選它能做什麼,隨時可以撤銷。
  • 每一次寫入都留紀錄:誰、哪個 AI、寫了什麼。
  • 寫錯了,整批退回或沖銷。

月底不用再趕帳

30 天導入期:全部功能都能用、收支筆數不限,不用綁卡。