Hushscript nói Model Context Protocol. Trỏ một MCP client vào một URL duy nhất, phê duyệt kết nối trong trình duyệt của bạn, và trợ lý AI có thể làm việc với các bản ghi và bản phiên âm trong tài khoản của bạn. Xuyên suốt quá trình đó vẫn là tài khoản và số phút của riêng bạn: máy chủ không bao giờ thấy dữ liệu của khách hàng khác, và không có gì ở đây làm thay đổi cách tính giá hay lưu trữ của bản thân việc phiên âm.

Kết nối

Máy chủ nói Streamable HTTP tại một endpoint duy nhất:

https://mcp.hushscript.com/mcp

Không có endpoint SSE nào và không có gì cần cài đặt cục bộ. Trong Claude Code:

claude mcp add --transport http hushscript https://mcp.hushscript.com/mcp

Trong một client nhận cấu hình JSON:

{
  "mcpServers": {
    "hushscript": {
      "type": "http",
      "url": "https://mcp.hushscript.com/mcp"
    }
  }
}

Client của bạn tự khám phá mọi thứ còn lại. Nó tự đăng ký một cách động (/oauth/register), đọc /.well-known/oauth-authorization-server để lấy các endpoint, và mở một cửa sổ trình duyệt để bạn đăng nhập.

Những gì bạn phê duyệt

Việc ủy quyền dùng OAuth 2.1 với PKCE. Cửa sổ trình duyệt đó là một màn hình xin sự đồng ý của Hushscript, không phải một ô nhập mật khẩu cho client: nó nêu rõ tên ứng dụng đang yêu cầu, liệt kê bằng ngôn ngữ dễ hiểu những gì ứng dụng đó muốn làm, và chờ bạn xác nhận. Không có gì được cấp quyền cho đến khi bạn phê duyệt ở đó.

Access token có hiệu lực một giờ và làm mới trong ba mươi ngày. Bạn không bao giờ thấy, sao chép hay dán một token: client và máy chủ trao đổi nó trực tiếp với nhau, nên không có bí mật nào nằm trong một file cấu hình trên ổ đĩa của bạn.

Quyền

Một kết nối nắm giữ một tập scope, và máy chủ chỉ công bố những công cụ mà các scope đó bao phủ. Một client không yêu cầu gì cụ thể sẽ nhận được mọi thứ trừ billing.

Scope	Cho phép làm gì
`transcripts:read`	Đọc bản phiên âm, metadata của chúng, và danh sách đã xóa
`transcripts:write`	Chỉnh sửa, gắn thẻ, dịch, khôi phục và xóa bản phiên âm
`transcribe`	Tải lên bản ghi, nhập từ liên kết, và chạy phiên âm
`insights`	Đọc, tạo và xóa Insights
`context`	Quản lý từ điển đã lưu và mẫu lời nhắc đã lưu
`account:read`	Đọc số dư, mức sử dụng, giao dịch và khoản giữ
`settings:write`	Thay đổi cài đặt tài khoản
`org:read`	Đọc thành viên tổ chức, sổ cái, hóa đơn và nhật ký kiểm toán
`export`	Xuất bản phiên âm và yêu cầu xuất toàn bộ tài khoản
`billing`	Mua gói phút bằng thẻ đã lưu

billing là ngoại lệ theo mọi nghĩa. Nó không bao giờ được cấp ngầm định, màn hình xin đồng ý sẽ cảnh báo bạn trước khi bạn phê duyệt nó, và nó vẫn ở trạng thái tắt trừ khi thanh toán cũng được bật trên chính tài khoản đó.

Các công cụ bao phủ những gì

Năm mươi công cụ, được nhóm theo phần chúng tác động đến:

Nhóm	Số công cụ	Ví dụ
Bản phiên âm, đọc	4	`list_transcripts`, `get_transcript`, `list_deleted`
Bản phiên âm, chỉnh sửa	10	`update_body`, `revert_body`, `retranslate`, `tag_transcripts`
Phiên âm	8	`create_upload`, `transcribe_from_url`, `list_jobs`, `cancel_job`
Tài khoản	6	`get_balance`, `get_usage`, `list_transactions`
Insights	3	`get_insights`, `generate_insights`, `delete_insights`
Xuất	4	`export_transcript`, `request_account_export`
Ngữ cảnh phiên âm	5	`save_dictionary`, `save_prompt_preset`
Tổ chức	5	`get_org`, `list_org_members`, `get_org_audit_log`
Thanh toán	5	`list_packs`, `purchase_pack`, `list_payment_methods`

export_transcript trả về TXT, SRT, VTT, Markdown hoặc JSON. Bộ đầy đủ 21 định dạng xuất nằm trong ứng dụng.

Điều gì tốn phút

Đọc bất cứ thứ gì đều miễn phí. Các hành động tính phí ở đây giống hệt những hành động tính phí trong ứng dụng, cùng mức giá, trừ từ cùng một số dư:

Phiên âm một bản ghi tốn số phút bằng độ dài của nó. Chế độ y tế cộng thêm 100%, và mỗi ngôn ngữ dịch mục tiêu cộng thêm 25%.
Insights miễn phí lần đầu tiên cho mỗi bản phiên âm. Tạo lại sau đó tốn 40% độ dài bản ghi tính từ Bản gốc, hoặc 30% từ Bản làm sạch.
Dịch lại một bản phiên âm tốn 25% độ dài của nó cho mỗi ngôn ngữ, và việc này ghi đè: mọi ngôn ngữ mà lệnh gọi đó tính phí sẽ mất bản dịch đã chỉnh sửa tay, không có cách nào lấy lại.
purchase_pack tính phí ngay vào thẻ đã lưu của bạn. Nó cần scope billing, thứ không client nào có được một cách tình cờ.

Xem bảng giá để biết chi tiết các gói.

Xem lại và thu hồi

Mọi kết nối đều xuất hiện dưới mục Ứng dụng đã kết nối trên trang MCP trong tài khoản của bạn, cùng với client đã tạo ra nó và các scope mà nó nắm giữ. Thu hồi một kết nối ở đó sẽ cắt đứt nó ngay lập tức. Hãy làm vậy thay vì xóa mục đó trong cấu hình của client: cấu hình đó chỉ ngăn máy của bạn gửi yêu cầu, không hơn.

Các endpoint ủy quyền bị giới hạn tốc độ ở 30 yêu cầu mỗi phút cho mỗi địa chỉ. Đây là biện pháp chống dò token hàng loạt, không phải giới hạn khối lượng công việc mà một trợ lý đã kết nối có thể làm.