安裝初本外掛與 skills

本頁適合導入顧問、系統管理員協助安裝。初本提供 tsubun-api-skill 外掛與 skills，可讓支援的 AI 用戶端載入財會操作指引，並透過 MCP 連接初本。

外掛將連線設定與 skills 一起提供；skill 是讓 AI 按照指定工作流程操作的指引。只安裝 skills 時，仍須另外設定 MCP 連線。

套件提供哪些工作流程？

Skill	用途
`prepare-accounting-drafts`	整理原始憑證與傳票草稿，保留待確認資料、核對科目、檢查重複，並讀回驗證保存結果
`upload-account-template`	上傳 UTF-8 CSV 或 JSONL，建立新的科目範本，不自動啟用
`upload-source-document-files`	將圖片或 PDF 附加至新草稿或既有可編輯原始憑證，支援檔案加密工作空間

套件提供英文與臺灣繁體中文指引，未指定語言時預設使用臺灣繁體中文。日常提問可參考提示詞與使用情境。

安裝前準備

準備支援外掛或 skills 的 AI 用戶端；以下終端機指令需要 Git，打包 ZIP 另需 zip。
先依連接 AI 與第一次查詢啟用工作空間工具，並建立自己的 MCP 金鑰。
核對目標工作空間及所需工具。安裝套件不會增加權限；可用功能仍受工作空間政策、金鑰與本人角色限制。

套件預設連接 https://tsubun.com/mcp。若使用其他部署網址，請管理人員依通用連線設定設定該網站的端點。

Codex：安裝本機外掛

在要使用外掛的專案目錄中執行：

mkdir -p plugins .agents/plugins
git clone https://github.com/aqseeker/tsubun-api-skill.git plugins/tsubun

建立 .agents/plugins/marketplace.json，內容如下。Marketplace 是用戶端用來列出可安裝外掛的目錄；若檔案已存在，將外掛項目加入既有 plugins 陣列，後續指令改用既有 marketplace 名稱。

{
  "name": "tsubun-api-skill",
  "interface": {
    "displayName": "Tsubun / 初本財會系統"
  },
  "plugins": [
    {
      "name": "tsubun",
      "source": "./plugins/tsubun",
      "policy": {
        "installation": "AVAILABLE",
        "authentication": "ON_INSTALL"
      },
      "category": "Productivity"
    }
  ]
}

source 路徑以專案根目錄為基準，保留套件內 plugin.json、mcp.json、skills/ 與 assets/ 的完整結構。詳見 OpenAI 本機 marketplace 指南。

在同一專案目錄執行：

codex plugin marketplace add .
codex plugin add tsubun@tsubun-api-skill
codex plugin list

確認外掛已列出，再開始新的 Codex 工作階段並完成下方授權。指令說明見 Codex 外掛指令。

ChatGPT 桌面版：使用本機 marketplace

完成上方專案目錄與 marketplace.json 的準備。
在 ChatGPT 桌面版的 Work 或 Codex 開啟該專案目錄，再重新啟動 app。
開啟 Plugins，在 Tsubun / 初本財會系統 marketplace 中找到初本外掛，按 + 安裝並依提示連線。
開始新對話，輸入 @ 選取外掛，或請 ChatGPT 使用初本。

此方式使用桌面版的本機專案目錄；帳號可用的外掛與安裝介面請依 ChatGPT 外掛說明核對。

Claude Code：從 GitHub 安裝外掛

儲存庫已包含 Claude Code marketplace，不需要建立上方的本機 marketplace。在終端機執行：

claude plugin marketplace add aqseeker/tsubun-api-skill
claude plugin install tsubun@tsubun-api-skill

開始新的 Claude Code 工作階段，執行 /mcp，選取 tsubun 伺服器並按 Authenticate。外掛 skills 使用 tsubun: 前綴，例如 tsubun:prepare-accounting-drafts。詳見 Claude Code 外掛安裝。

只安裝 skills

若要自行管理 Claude Code 的 skills 與連線，在專案目錄執行以下指令；已下載套件時略過 git clone：

git clone https://github.com/aqseeker/tsubun-api-skill.git plugins/tsubun
mkdir -p .claude/skills
cp -R plugins/tsubun/skills/. .claude/skills/
claude mcp add --transport http --scope project tsubun https://tsubun.com/mcp

三個 skill 資料夾須放在同一層，並保留各自的參考文件，因為指引彼此有連結。若已有同名 skills，先核對內容再複製。新增 MCP 後仍須執行 /mcp 完成授權。

Claude 網頁版或桌面版可將每個 skill 資料夾分別打包成 ZIP，再依 Claude skills 上傳說明安裝；另外設定指向 https://tsubun.com/mcp 的自訂連接器。方案、程式碼執行與網路存取須支援這些操作。完整打包與連接器步驟見套件安裝說明。

授權並確認安裝結果

從 AI 用戶端發起初本 OAuth 連線，依登入並同意連線完成登入。
選取目標工作空間的既有 MCP 金鑰，核對公司與工具後允許連線。不要把完整金鑰貼入對話或外掛檔案。
開始新對話，請 AI「列出這條初本連線的工作空間名稱，這次只查詢」。
核對工具確實回傳資料，而且公司名稱與初本一致，再開始處理帳務。

上傳 skills 還需要 AI 能讀取檔案並發送 HTTP 上傳請求。請授權所需的上傳、建立及讀回工具；只有查詢用的金鑰無法完成上傳。附件操作與結果核對見透過 AI 上傳單據圖片。

安裝後工具未出現時，先重新開啟工作階段，再檢查外掛、MCP 授權及金鑰範圍。套件版本與完整安裝說明以 GitHub 儲存庫為準；連線問題見金鑰、工具與授權管理。