HOME/教學文檔/第十一章:讓外部 AI 助手操作 Scribis(MCP)
官方使用指南

第十一章:讓外部 AI 助手操作 Scribis(MCP)

開啟 Scribis 的 MCP 服務、把設定貼進 Claude Code、Cursor、Codex 等 AI 工具,安裝 Scribis Skills,並用一句話請 AI 幫你轉錄、修字幕、剪影片。

第十一章:讓外部 AI 助手操作 Scribis(MCP)

💡 這一章適合誰? 已經在使用 Claude Code、Cursor 等 AI 工具,而且願意照步驟複製貼上設定的人。Scribis 的其他功能都不需要這一章,沒用過這些 AI 工具可以直接跳過。

11.1 這是什麼?

如果你平常會用 Claude Code、Claude Desktop、Cursor、OpenAI Codex、Google Antigravity、Windsurf 這類 AI 助手,可以讓它們直接操作 Scribis。你只要用文字告訴 AI 想做什麼,例如:

「把桌面上的 meeting.mp4 轉成繁體中文字幕,存成 SRT。」

「打開我剛剛的剪輯專案,把『嗯』、『那個』這些口頭禪剪掉。」

AI 就會透過 Scribis 完成。讓兩邊能溝通的標準叫做 MCP(Model Context Protocol)。

🔒 安全嗎? Scribis 的 MCP 服務只接受你自己電腦上的連線,網路上的其他人和網站都無法使用。會修改字幕、時間軸的操作,也會在 Scribis 裡讓你確認。


11.2 步驟 1:在 Scribis 開啟 MCP

  1. 打開 「設置」,在左邊選單點 「MCP」。
  2. 在 「連線與設定」 分頁,打開 「MCP(模型上下文協定)伺服器」 的開關。
  3. 右上角顯示綠色的 「運作中」,就代表開好了。旁邊的 「MCP: Port 8890」 是連線用的號碼,下一步會自動帶入,不用記。

MCP 協定與開發者 API 設定頁:① MCP 伺服器開關、② 運作中狀態、③ 連線網址、④ MCP 客戶端設定

圖中 ① 是開關、② 是運作狀態、③ 是連線網址;④「MCP 客戶端設定」在下一步會用到。

💡 8890 是預設的「埠號」(可以想成門牌號碼)。如果和其他軟體衝突,可以在 「共用 HTTP 埠號」 改成別的數字。


11.3 步驟 2:把設定貼到你的 AI 工具

在同一頁往下捲到 「MCP 客戶端設定」,點你使用的工具(例如 Claude Code、Claude Desktop、Cursor、Codex、Antigravity)。Scribis 會顯示已經填好埠號的設定內容,按複製,再貼到該工具的 MCP 設定處即可。每個工具的設定位置不同,請照 MCP 安裝與使用說明 裡該工具的步驟找到它。

以 Claude Code 為例,也可以在「終端機」(Mac 的「終端機」App 或 Windows 的 PowerShell)執行下面這行。不會用終端機就跳過,用上面的複製貼上即可:

claude mcp add --transport http scribis http://127.0.0.1:8890/mcp

各工具設定檔的位置與更多細節,請看 MCP 安裝與使用說明。


11.4 步驟 3:安裝 Scribis Skills(建議)

Skills 是一份給 AI 看的「Scribis 使用說明書」,裝了之後 AI 會更懂得怎麼正確操作 Scribis。

  1. 到 MCP 安裝與使用說明 下載 scribis.install-skill.zip。
  2. 解壓縮後,打開 skills 資料夾,會看到六個名稱以 scribis- 開頭的資料夾。把全部六個複製到你 AI 工具的 skills 資料夾,直接放在裡面,不要再多包一層。
    • Claude Code 的位置是你個人資料夾裡的 .claude/skills。Mac:/Users/你的名字/.claude/skills;Windows:C:\Users\你的名字\.claude\skills。
    • 其他工具請看 MCP 安裝與使用說明 的資料夾對照表。
    • Mac 上看不到 .claude 這種開頭是句點的資料夾時,在 Finder 按 ⌘ + ⇧ + .(Command、Shift 和句點)就會顯示。
  3. 重新啟動 AI 工具(或開一個新的對話)。

11.5 試試看

確認 Scribis 開著,然後在 AI 工具裡輸入:

想做的事 可以這樣說
轉錄 「用 Scribis 把 ~/Movies/meeting.mp4 轉成逐字稿,存成 SRT。」
修字幕 「讀取 Scribis 目前打開的字幕,找出可能聽錯的專有名詞,給我修改建議。」
粗剪 「把影片裡的停頓和『嗯』、『那個』剪掉。」
加動畫 「在 0:12 加一個動態標題『新版本月底上線』。」
配樂與音效 「加一段輕快的背景音樂,說話的時候自動把音樂調小。」
配音 「用 AI 語音幫第 3 句重新配音。」

從 Cuts 直接交給 AI

在 Cuts → 最近編輯 或 場景 中,「開啟編輯器」旁邊的複製按鈕會複製一段指令,例如:

/scribis-edit cuts <專案 ID>

按複製後直接貼到 Claude Code 等 AI 工具即可(上面的 <專案 ID> 只是示意,複製時已經自動填好)。AI 會打開那個專案,接著你可以直接說要怎麼剪。使用前請先完成 11.4 安裝 Skills。


11.6 進階:OpenAI 相容 API

這一節是給程式開發者的,一般使用者可以直接跳過。

同一個設定頁右側的 「OpenAI 相容音訊 API」,可以讓其他程式用 OpenAI 的格式呼叫 Scribis 的語音轉文字、語音合成與本機 AI。按 「產生 API key 並啟用」 即可使用。


11.7 連不上怎麼辦?

狀況 解決方法
AI 說找不到 Scribis 確認 Scribis 已經打開,且 MCP 開關是開著的
設定後沒有反應 重新啟動 AI 工具,或開一個新的對話
埠號被占用 在「共用 HTTP 埠號」換一個數字,並重新複製設定
AI 不太會操作 確認六個 scribis- 資料夾都直接放在 skills 資料夾裡,沒有多包一層

更多疑難排解請看 MCP 安裝與使用說明。