Kết nối BigQTools với trình AI của bạn
BigQTools có máy chủ MCP: Claude Code, Cursor, Codex, opencode hay Antigravity gọi thẳng các công cụ nén, chuyển đổi, ghép, cắt tệp của BigQTools — bạn chỉ cần nói việc cần làm.
Kết nối trong 3 bước
-
Tạo khóa
Đăng nhập, mở Tài khoản › Kết nối AI và bấm Tạo khóa. Khóa có dạng bqt_live_… và chỉ hiện một lần — sao chép và cất ngay.
Mở Kết nối AI -
Thêm máy chủ vào trình AI
Dán đoạn cấu hình bên dưới vào đúng công cụ bạn dùng, thay bqt_live_… bằng khóa của bạn rồi khởi động lại trình AI.
-
Nhờ AI xử lý tệp
Ví dụ: “Nén tệp https://example.com/bao-cao.pdf rồi gửi tôi link tải”. AI tự chọn công cụ, chạy và trả về link kết quả.
Cấu hình cho từng trình AI
Máy chủ: https://mcp.bigqtools.com/mcp (Streamable HTTP). Khóa đi trong header Authorization: Bearer … — thay bqt_live_… bằng khóa của bạn.
Claude Code
Chạy trong terminal
claude mcp add --transport http bigqtools https://mcp.bigqtools.com/mcp --header "Authorization: Bearer bqt_live_…" Cursor
Thêm vào ~/.cursor/mcp.json
{
"mcpServers": {
"bigqtools": {
"url": "https://mcp.bigqtools.com/mcp",
"headers": {
"Authorization": "Bearer bqt_live_…"
}
}
}
} Codex
Thêm vào ~/.codex/config.toml
[mcp_servers.bigqtools]
url = "https://mcp.bigqtools.com/mcp"
[mcp_servers.bigqtools.http_headers]
Authorization = "Bearer bqt_live_…" opencode
Thêm vào opencode.json
{
"mcp": {
"bigqtools": {
"type": "remote",
"enabled": true,
"url": "https://mcp.bigqtools.com/mcp",
"headers": {
"Authorization": "Bearer bqt_live_…"
}
}
}
} Antigravity
Thêm vào ~/.gemini/config/mcp_config.json
{
"mcpServers": {
"bigqtools": {
"serverUrl": "https://mcp.bigqtools.com/mcp",
"headers": {
"Authorization": "Bearer bqt_live_…"
}
}
}
} Antigravity đọc khóa serverUrl, không phải url — ghi url thì máy chủ sẽ không được nạp.
Trình AI làm được gì
Máy chủ cung cấp các công cụ MCP sau; trình AI tự gọi theo đúng thứ tự:
-
my_limits— gói hiện tại, số lượt còn lại trong ngày và dung lượng tối đa mỗi tệp. -
list_tools— danh sách công cụ, định dạng nhận được và các tùy chọn. -
add_file_from_url— để BigQTools tự tải tệp từ một liên kết tải trực tiếp. -
add_file— gửi thẳng một tệp nhỏ (tối đa 8 MB). -
run_tool— chạy công cụ trên các tệp đã thêm và chờ kết quả. -
job_status · get_result— theo dõi tiến trình, lấy link tải kết quả kèm hạn dùng.
Mỗi lượt chạy qua MCP được tính như khi dùng trên web: cùng hạn mức, cùng dung lượng tệp, cùng thời gian giữ tệp của gói bạn.
Không kết nối được?
Nếu trình AI báo lỗi 401, hoặc kết nối được nhưng chạy công cụ thì lỗi, hãy kiểm tra lần lượt:
- Khóa còn hạn và chưa bị thu hồi — xem trong Tài khoản › Kết nối AI. Khóa hết hạn thì tạo khóa mới.
- Trình AI chỉ cho đặt một số header nhất định? Gửi khóa bằng header
X-BQ-Key: bqt_live_…thay cho Authorization.
Hai lỗi đã biết của trình AI
- Cursor: có báo cáo Cursor chỉ chuyển tiếp một số header khi gọi tools/call, nên khóa rơi mất giữa chừng — bắt tay được nhưng chạy công cụ thì bị 401.
- Claude Code: có lỗi không gửi header lúc thiết lập phiên, nên máy chủ từ chối ngay từ bước đầu dù khóa đúng.
Lối thoát: đưa khóa vào đường dẫn
Khi trình AI làm rơi header, dùng địa chỉ có khóa ở cuối và bỏ phần header đi:
Ví dụ với Claude Code:
Cảnh báo: khóa nằm trong đường dẫn sẽ bị ghi vào nhật ký máy chủ, proxy và lịch sử của trình AI. Chỉ dùng khi cách header không chạy, dùng một khóa riêng cho việc này và thu hồi ngay khi không cần nữa. Khóa từng đi đường này được gắn nhãn URL trong trang Tài khoản.
Trình AI cũ chỉ hỗ trợ kiểu HTTP + SSE: dùng địa chỉ https://mcp.bigqtools.com/sse.
Vẫn không được? Gửi yêu cầu hỗ trợ kèm tên trình AI, phiên bản và thông báo lỗi — đừng gửi khóa.
Câu hỏi thường gặp
Gửi tệp lớn cho AI thế nào?
Đừng gửi tệp lớn trực tiếp qua MCP. Hãy đưa cho AI một liên kết tải trực tiếp (Google Drive, Dropbox, máy chủ của bạn…) để BigQTools tự tải về. Chỉ tệp nhỏ, tối đa 8 MB, mới gửi thẳng được.
Tệp và kết quả được giữ bao lâu?
Như khi dùng trên web: tệp tải lên và tệp kết quả tự xóa sau thời gian giữ tệp của gói bạn đang dùng. Hãy tải kết quả về trước khi link hết hạn.
Gói miễn phí có dùng được không?
Có. Khóa dùng hạn mức của tài khoản bạn: gói miễn phí chạy được trong số lượt mỗi ngày và dung lượng tệp của gói. Hết lượt, AI nhận lỗi QUOTA_EXCEEDED — đợi lượt mới hoặc nâng gói.
Khóa hết hạn thì sao?
Trình AI sẽ nhận lỗi 401. Tạo khóa mới trong Tài khoản › Kết nối AI, thay vào đoạn cấu hình rồi khởi động lại trình AI. Khóa cũ không gia hạn được.
Khóa làm được gì với tài khoản của tôi?
Chỉ chạy công cụ xử lý tệp dưới tên bạn, trong hạn mức của gói. Khóa không xem được hồ sơ, không đổi được gói hay thanh toán, và bạn thu hồi được bất cứ lúc nào.
Làm mất khóa thì sao?
BigQTools chỉ lưu bản băm của khóa nên không thể hiện lại. Thu hồi khóa cũ trong Tài khoản › Kết nối AI và tạo khóa mới.