CỔNG KẾT NỐI

Để trợ lý AI vận hành có kiểm soát.

REST API và MCP dùng chung xác thực, quyền sở hữu và nhật ký nghiệp vụ.

Các điểm truy cập

REST API: /api/v1
MCP Streamable HTTP: /mcp
OAuth discovery: /.well-known/oauth-protected-resource/mcp
OpenAPI tương tác ↗ · OpenAPI JSON ↗

Khóa được tạo tại tài khoản, có phạm vi và ngày hết hạn; chỉ hiện một lần. Không đặt khóa trong URL hay mã frontend.

Kết nối MCP qua HTTP

URL: https://songcungai.com/mcp
Authorization: Bearer <khóa-API-có-scope>

Local: /mcp trên cùng địa chỉ/cổng với website đang mở
OAuth: authorization code + PKCE, resource-bound token
Phạm vi tối thiểu: catalog:read library:read

Với client hỗ trợ OAuth, thêm địa chỉ MCP rồi đăng nhập và duyệt phạm vi trên trang kết nối. Với client hỗ trợ header, dùng khóa API. Client chỉ hỗ trợ stdio dùng bridge trong mã nguồn.

Ví dụ REST

GET /api/v1/products?q=ky+nang

POST /api/v1/checkout
Authorization: Bearer <khóa-API>
Content-Type: application/json

{
  "offerIds": ["<offer-id>"],
  "termsAccepted": true,
  "idempotencyKey": "<khóa-duy-nhất-cho-yêu-cầu>"
}

Khi dùng cookie trong trình duyệt, thao tác ghi JSON cần header X-SCAI-Request: 1. Client chỉ gửi termsAccepted sau khi người mua đã xem và đồng ý điều kiện.

Quyền của bot

Tìm tài nguyên; đọc đơn và thư viện của chủ tài khoản.
Tạo bản nháp sản phẩm, offer và chiến dịch theo scope nhân viên.
Tiếp nhận, phân loại và phản hồi yêu cầu hỗ trợ.
Theo dõi nhu cầu nhân sự, tạo báo giá và đọc báo cáo.
Gửi yêu cầu phê duyệt cho xuất bản, email và hoàn tiền.

Bot không có công cụ tự duyệt, đánh dấu đã trả tiền hay chuyển tiền. Việc duyệt dùng phiên đăng nhập của chủ hệ thống với MFA; mọi thao tác được kiểm quyền lại tại server.