MCP 金鑰、工具與授權連線
逐步操作與欄位說明請見個人 MCP 金鑰。本頁保留整體作業與閱讀順序。
圖：本機練習工作空間的實際介面，資料皆為虛構；可見操作依權限而異。
MCP 是讓外部軟體連接初本財會系統、使用指定功能的方式。本頁適合管理連線的系統管理員；一般使用者可先讀AI 協助帳務。連線綁定金鑰所屬的工作空間；切換瀏覽器中的目前工作空間，不會把既有金鑰改綁到另一家公司。
實際可用工具同時受到工作空間政策、金鑰啟用工具與使用者目前角色權限限制。建立金鑰或完成 OAuth 授權，不會取得原本沒有的帳務權限。
管理入口與前置準備
Section titled “管理入口與前置準備”| 入口 | 用途 | 管理對象 |
|---|---|---|
| 工作空間設定 → MCP 整合 → 啟用工具 | 啟用連線及設定允許工具 | 擁有者修改工作空間政策 |
| 工作空間設定 → MCP 整合 → 授權連線 | 查看工作空間連線、使用者與裝置 | 擁有者撤銷工作空間連線；檢視仍需對應權限 |
| 使用者設定 → API 整合 → MCP 整合 | 建立金鑰、查看工具及撤銷金鑰 | 自己的工作空間 MCP 金鑰 |
| 使用者設定 → API 整合 → 授權連線 | 查看與撤銷個人的授權 | 自己在各工作空間的連線 |
先加入工作空間並取得必要角色，再請擁有者啟用工具。需要修改資料的用戶端，請先確認工具用途及公司內部的覆核分工。
擁有者啟用工具
Section titled “擁有者啟用工具”- 確認目前工作空間，開啟「工作空間設定 → MCP 整合 → 啟用工具」。
- 勾選「啟用 MCP 連線」。
- 在「允許工具」勾選需要的工具；可依分類查看與選取。
- 按「儲存設定」，等待「MCP 設定已儲存，既有連線需要重新授權。」
只有工作空間擁有者可以修改政策。政策修改後，既有連線需要重新授權；請通知使用連線的同事從用戶端重新發起授權。
憑證與傳票工具
Section titled “憑證與傳票工具”草稿移除使用 source_document_discard、journal_entry_discard，僅允許草稿狀態。已同意原件的更正使用 source_document_correct、journal_entry_correct；作廢使用 source_document_void、journal_entry_void。更正及作廢需先讀取詳情，將最新 updatedAt 作為 expectedUpdatedAt 提交；狀態或版本已變更時會拒絕操作，請重新讀取後核對。
使用工具前，先在角色權限授予所需權限，由擁有者在工作空間允許工具開放工具，再建立包含對應工具的金鑰並完成連線授權。
file_download_token_create 建立有效 10 分鐘、限用一次的單筆附件下載憑證，再由用戶端以 HTTP 下載。操作人須有原始憑證檢視權限，不要求修改權限；工作空間政策、金鑰與連線均須允許此工具。
下載用戶端須支援保存檔案及以標頭傳送下載 token。此 token 與 MCP 金鑰、OAuth access token 不同；加密檔案仍以密文傳送。詳見附件下載流程。
多項資源工具另支援 items 批次輸入，沿用原有工具授權，無須額外開啟專屬工具；由於批次執行可能部分成功，完成後需逐項核對結果。支援範圍、預設上限與重試方式見多筆操作。
使用者建立 MCP API 金鑰
Section titled “使用者建立 MCP API 金鑰”- 開啟「使用者設定 → API 整合 → MCP 整合」。
- 按「建立 MCP API 金鑰」，選擇工作空間。
- 輸入清楚的「金鑰名稱」，例如「初本範例公司報表查詢」，最多 100 字。
- 在「啟用工具」選取至少一項工具。切換工作空間會清除目前選取的工具，需重新選擇。
- 按「建立金鑰」。完成後按「複製金鑰」，妥善保存，再按「我已安全保存」。
- 回到清單，確認名稱、工作空間、建立日期及「使用中」狀態；按「查看工具」核對範圍。
完整金鑰只在建立完成的對話框顯示一次，關閉後不能再次查看。遺失時請撤銷舊金鑰再建立新金鑰。沒有可建立金鑰的工作空間時，確認擁有者已啟用 MCP，自己也有對應的工作空間與工具權限。
以 OAuth 連線
Section titled “以 OAuth 連線”使用 Codex、ChatGPT 桌面版或 Claude 的人員，可從 tsubun-api-skill 儲存庫安裝初本外掛或 skills。請依安裝指南操作，再完成以下授權；安裝套件不會改變工作空間、金鑰或角色權限。
- 在支援 MCP OAuth 的用戶端加入此網站的
/mcp端點；完整網址可從「MCP 整合」頁的「MCP 端點」複製。 - 從用戶端發起連線，依引導登入初本財會系統。
- 在「授權 MCP 連線」核對用戶端名稱，於「MCP 金鑰」選擇已建立的金鑰及正確工作空間。
- 按「查看已啟用工具」確認範圍。此授權畫面不會新增工具權限。
- 按「寄送驗證碼」，至目前登入的電子郵件取得六位英文字母或數字驗證碼，於五分鐘內輸入。
- 按「允許連線」，返回原用戶端完成連線。不接受此要求時按「拒絕」。
若授權要求已失效，從原用戶端重新發起連線。找不到可授權金鑰時，先回 API 設定建立金鑰並啟用工具，再重新發起。驗證碼過期可按「重新寄送驗證碼」。
以金鑰標頭連線
Section titled “以金鑰標頭連線”支援自訂 HTTP 標頭的 MCP 用戶端，可在軟體的連線設定填入：
| 設定項目 | 填入內容 |
|---|---|
| 伺服器網址／端點 | 從初本「MCP 端點」複製的完整網址 |
| HTTP 標頭名稱 | X-MCP-Key |
| HTTP 標頭值 | 已安全保存的完整 API 金鑰 |
請在用戶端的金鑰欄位保存，不要放入公開文件、網址或對話內容。
每次請求只使用一種認證方式：OAuth 的 Authorization: Bearer …，或 X-MCP-Key。同時送出兩種標頭或兩者皆未提供，連線會被拒絕。此方式不需要在 OAuth 授權畫面貼上金鑰。
撤銷金鑰與連線
Section titled “撤銷金鑰與連線”撤銷金鑰： 在使用者的「MCP 整合」清單按「撤銷」，核對「撤銷 MCP 金鑰」對話框，再按「確認撤銷」。狀態變為「已撤銷」；使用這把金鑰建立的 MCP 連線也會失效。
撤銷自己的 OAuth 連線： 開啟使用者的「授權連線」，依工作空間、裝置、建立日期及「查看工具」確認目標，按「撤銷」及「確認撤銷」。完成後該連線不再出現在目前連線清單。
擁有者撤銷工作空間連線： 開啟工作空間的「MCP 整合 → 授權連線」，核對用戶電子郵件、裝置、工具及建立日期，再撤銷目標。若顯示「未知裝置」，用其他欄位確認，不要只依裝置名稱判斷。
單一連線與金鑰是不同層級。要停止使用整把金鑰，應撤銷金鑰；單一連線撤銷後，需要使用時可重新發起授權。
範例與常見問題
Section titled “範例與常見問題”初本範例公司希望以外部用戶端查閱 2026 年 1 月報表。擁有者先允許所需查詢工具，使用者建立「初本範例公司報表查詢」金鑰，只選需要的工具。授權完成後，由用戶端查詢正確工作空間與期間；是否可查閱仍以角色為準。完成工作後可撤銷這次連線。
- 工具未出現或無法執行： 分別檢查工作空間政策、金鑰已啟用工具、目前角色權限及方案是否有效。授權畫面無法補加工具。
- 政策修改後舊連線失效： 重新發起 OAuth 授權；若需要不同金鑰工具範圍，建立符合需求的新金鑰。
- 金鑰遺失： 無法重新讀取完整值，撤銷後重建。
- 連線認證失敗： 核對端點、金鑰或授權是否撤銷，以及是否誤同時設定兩種認證標頭。
第一次用 AI 連線，請跟著 AI Agent：完成 MCP 連線與第一次查詢操作；連線完成後可使用提示詞與使用情境。