Hushscript 支援 Model Context Protocol。將 MCP 用戶端指向單一網址,在瀏覽器中核准連線,助理就能操作您帳戶中的錄音與逐字稿。從頭到尾,這都是您的帳戶、您的分鐘數:伺服器永遠不會看到其他客戶的資料,這裡的一切也不會改變轉錄本身的計價或儲存方式。
連接
伺服器透過單一端點,以 Streamable HTTP 通訊:
https://mcp.hushscript.com/mcp
沒有 SSE 端點,也不需要在本機安裝任何東西。在 Claude Code 中:
claude mcp add --transport http hushscript https://mcp.hushscript.com/mcp
在接受 JSON 設定的用戶端中:
{
"mcpServers": {
"hushscript": {
"type": "http",
"url": "https://mcp.hushscript.com/mcp"
}
}
}
其餘的一切都由您的用戶端自動探索完成。它會動態註冊自己(/oauth/register),讀取
/.well-known/oauth-authorization-server 取得各端點位址,並開啟瀏覽器視窗讓您登入。
您核准的內容
授權採用 OAuth 2.1 搭配 PKCE。瀏覽器視窗顯示的是 Hushscript 的同意畫面,而不是給用戶端輸入密碼的欄位:畫面會列出提出請求的應用程式名稱,以白話文說明它想做什麼,並等待您的回應。在您於畫面中核准之前,不會授予任何權限。
存取權杖的效期為一小時,並可在 30 天內更新。您永遠不會看到、複製或貼上權杖:用戶端與伺服器會直接交換權杖,因此您的硬碟裡不會留下任何存放在設定檔中的機密。
權限
每個連線都持有一組範圍(scope),伺服器只會提供這些範圍所涵蓋的工具。如果用戶端沒有特別要求,預設會取得除了 billing 以外的所有權限。
| 範圍 | 允許的操作 |
|---|---|
transcripts:read |
讀取逐字稿、其中繼資料,以及已刪除清單 |
transcripts:write |
編輯、標記、翻譯、還原並刪除逐字稿 |
transcribe |
上傳錄音、以連結匯入,並執行轉錄 |
insights |
讀取、產生並刪除 Insights |
context |
管理已儲存的詞典與提示詞預設 |
account:read |
讀取餘額、使用量、交易紀錄與暫收款 |
settings:write |
變更帳戶設定 |
org:read |
讀取工作區成員、帳目、發票與稽核紀錄 |
export |
匯出逐字稿,並要求完整帳戶匯出 |
billing |
以已儲存的卡片購買分鐘套餐 |
billing 在各方面都是例外。它絕不會被隱含授予,同意畫面會在您核准前提出警告,而且除非帳戶本身也已啟用購買功能,否則它會保持關閉。
工具涵蓋的範圍
50 個工具,依所涉及的範疇分組:
| 分組 | 工具數 | 範例 |
|---|---|---|
| 逐字稿:讀取 | 4 | list_transcripts, get_transcript, list_deleted |
| 逐字稿:編輯 | 10 | update_body, revert_body, retranslate, tag_transcripts |
| 轉錄 | 8 | create_upload, transcribe_from_url, list_jobs, cancel_job |
| 帳戶 | 6 | get_balance, get_usage, list_transactions |
| Insights | 3 | get_insights, generate_insights, delete_insights |
| 匯出 | 4 | export_transcript, request_account_export |
| 轉錄背景資訊 | 5 | save_dictionary, save_prompt_preset |
| 工作區 | 5 | get_org, list_org_members, get_org_audit_log |
| 購買 | 5 | list_packs, purchase_pack, list_payment_methods |
export_transcript 會回傳 TXT、SRT、VTT、Markdown 或 JSON。完整的 21 種匯出格式則在應用程式中提供。
哪些操作會花費分鐘數
讀取任何內容都是免費的。需要付費的操作,與應用程式中需要付費的操作完全相同,費率相同,也是從同一個餘額扣款:
- 轉錄 一段錄音,會依其長度花費分鐘數。醫療模式會額外增加 100%,每加一種翻譯目標語言則增加 25%。
- Insights 每份逐字稿的首次執行是免費的。之後重新生成,從原文重新開始需錄音長度的 40%,從純淨版更新則需 30%。
- 重新翻譯 一份逐字稿,每種語言需花費其長度 25% 的分鐘數,而且會覆蓋原有內容:這次呼叫收費涵蓋的每一種語言,都會失去該語言先前手動編輯過的版本,且無法復原。
purchase_pack會立即向您已儲存的卡片收費。它需要billing範圍,任何用戶端都不會意外取得這項權限。
套餐本身的詳情請見定價頁面。
檢閱與撤銷連線
每個連線都會顯示在您帳戶的 MCP 頁面的已連接的應用程式底下,包含建立該連線的用戶端,以及它持有的範圍。在那裡撤銷連線會立即中斷連線。請這樣做,而不是刪除用戶端設定檔裡的項目:設定檔的變更只會讓您的裝置不再發出請求。
授權端點的速率限制為每個位址每分鐘 30 次請求。這是為了防止權杖濫發攻擊,而不是限制已連接的助理能做多少工作。