Ephemeral Artifact Delivery Bridge for AI Agents

Have a file that needs to reach a human?
Create → BOP → Deliver → Done.

BOP Share Machine Gateway cung cấp hạ tầng giao tệp tin tự hủy tạm thời cho các tác tử AI (coding agents, research bots, chat assistants). Khi AI tạo PDF, ảnh, bảng tính, hoặc mã nguồn nén, gửi qua BOP để nhận đường dẫn tải an toàn cho người nhận. Không cần đăng ký tài khoản, không lưu trữ vĩnh viễn.

1BOP Share là gì?

BOP Share là hạ tầng cầu nối phân phối tệp tin tạm thời, phi tập trung và không yêu cầu tài khoản. Tệp tin được lưu trong bộ nhớ đám mây riêng tư (S3) và tự động hủy sau 1 đến 7 ngày.

2AI sử dụng BOP Share để làm gì?

Khi bot hoặc agent sinh ra một tệp tin (bản báo cáo PDF, đồ thị PNG, bảng tính Excel, kho lưu trữ ZIP), agent gửi tệp lên BOP để nhận link chia sẻ trực tiếp gửi lại cho người dùng cuối.

3Các giao diện tương tác máy tính (Interfaces)

Hỗ trợ 3 phương thức chuẩn: HTTP REST API v1 (cURL, Python, Node.js), Model Context Protocol (MCP Server JSON-RPC 2.0 cho Claude Desktop & Cursor), và WebMCP trong trình duyệt.

4Tài liệu cho Machine & LLM nằm ở đâu?

Các endpoint công khai chuẩn hóa dạng plain text và JSON: /llms.txt, /llms-full.txt, /openapi.json/api/mcp.

Thư Mục Khám Phá Máy Học (Machine Discovery Directory)

Tất cả các tài nguyên máy học được phục vụ nguyên bản, độc lập với JavaScript và chuẩn định dạng REST/JSON/Text:

Hướng Dẫn Theo Nhu Cầu Tác Vụ (Job-First Quick Start)

📄 AI tạo file PDF / Báo cáo

Yêu cầu tạo slot tải lên với application/pdf, đưa nội dung binary lên presigned URL qua HTTP PUT, rồi gửi receiver URL cho người dùng.

📊 AI tạo Bảng tính / Dữ liệu CSV

Người nhận có thể xem trước (Safe Preview) dữ liệu bảng trực tiếp trên trình duyệt mà không bắt buộc tải về, hoàn toàn không chạy mã độc hại.

📦 Coding Agent tạo Kho mã ZIP

Hỗ trợ tệp nén lên tới 50 MiB. Sau khi người nhận tải xong hoặc khi hết hạn (mặc định 24 giờ), liên kết sẽ vô hiệu hóa và đối tượng được xóa theo chu kỳ lưu trữ.

Giao Thức HTTP REST API (Phiên bản v1)

Endpoint: /api/v1/transfers

Luồng chuẩn 2 bước (Direct-to-S3 Presigned Upload)

Bước 1Khởi tạo slot chuyển giao tệp:

# 1. Gọi POST để lấy URL tải lên và link nhận tệp

curl -X POST "https://share.bop.ink/api/v1/transfers" \

-H "Content-Type: application/json" \

-d '{"filename": "report.pdf", "contentType": "application/pdf", "fileSizeBytes": 1048576, "expiryDays": 1}'

Bước 2Đẩy khối nhị phân trực tiếp lên S3 qua HTTP PUT:

# 2. Upload binary bytes tới upload.url nhận được ở Bước 1

curl -X PUT "<upload.url_tu_buoc_1>" \

-H "Content-Type: application/pdf" \

--data-binary "@report.pdf"

Bước 3Trả đường dẫn nhận tệp cho người dùng:

# Gửi đường dẫn transfer.url cho người nhận:

https://share.bop.ink/d/f_4a8b9c0d1e2f

(Tự động vô hiệu hóa sau 24 giờ và dọn dẹp theo chu kỳ lưu trữ)

Model Context Protocol (MCP Server)

Spec 2026-07-28

BOP Share cung cấp MCP Server tuân thủ đặc tả Model Context Protocol phiên bản 2026-07-28 với kiến trúc Stateless HTTP Request/Response qua JSON-RPC 2.0. Không yêu cầu duy trì kết nối persistent stateful hay sticky session, tối ưu cho môi trường container serverless. AI Host (như Claude Desktop, Cursor, AI IDEs) có thể kết nối trực tiếp để tự động hóa quy trình phân phối tệp tạm thời.

Danh sách Tools cung cấp

  • create_temporary_transfer

    Tạo slot phân phối tệp, trả về URL tải lên và URL nhận tệp cho người dùng.

  • finalize_temporary_transfer

    Xác nhận việc tải nhị phân hoàn tất và kiểm tra trần dung lượng 50 MiB (52.428.800 bytes).

  • revoke_temporary_transfer

    Thu hồi và tiêu hủy tệp ngay lập tức trước hạn bằng revocation token.

Cấu hình Host Đã Kiểm Thử (Verified Hosts)

1. Claude Code CLI (Terminal):1 lệnh duy nhất
claude mcp add bop-share https://share.bop.ink/api/mcp --transport http
2. Cursor IDE (.cursor/mcp.json) & Claude Desktop:HTTP Remote
{
  "mcpServers": {
    "bop-share": {
      "url": "https://share.bop.ink/api/mcp"
    }
  }
}
3. Terminal Coding Agent (cURL 1-bước):REST API
curl -s -X POST https://share.bop.ink/api/v1/transfers -F "file=@output.zip"

Hạn Mức Vận Hành & Phòng Chống Lạm Dụng

Tiêu Chí (Parameter)Machine Gateway (AI)Human Web UI
Dung lượng tệp tối đa50 MiB (52.428.800 bytes)100 MiB (104.857.600 bytes)
Thời hạn mặc định1 ngày (24 giờ)3 ngày (72 giờ)
Thời hạn tối đa7 ngày7 ngày
Thời hạn hiệu lực URL PUT15 phút (900 giây)15 phút (900 giây)
Giới hạn tần suất (Rate Limit)15 lượt tạo / phút / IP10 lượt / phút / IP
Yêu cầu đăng ký / Tài khoảnKhông (URL năng quyền)Không

Ranh Giới: Khi Nào KHÔNG Nên Sử Dụng BOP Share

Để đảm bảo chất lượng tài nguyên chung và không tạo ảo tưởng sai lầm cho các mô hình AI, tuyệt đối không sử dụng BOP Share trong các trường hợp sau:

Lưu trữ đám mây vĩnh viễn (Permanent backup / Drive)
CDN công khai lưu trữ hình ảnh/video cho website
Lưu trữ video streaming hoặc nội dung phân giải cao
Cơ sở dữ liệu lưu trữ trạng thái người dùng

Tiêu Chuẩn Công Nghệ & Tuân Thủ (Standards Compliance)

MCP (JSON-RPC 2.0)Đặc tả Model Context Protocol 2026-07-28 (Stateless HTTP Request/Response).
WebMCPDự thảo W3C Web Machine Learning Community Group qua document.modelContext (Progressive Enhancement).
llms.txt / llms-full.txtQuy ước cộng đồng Answer.AI cung cấp tài liệu hướng dẫn súc tích và toàn diện cho LLM agents.
OpenAPI 3.1.0Đặc tả lược đồ kỹ thuật máy đọc cho REST API v1 (OpenAPI Initiative).