Máy chủ MCP
Model Context Protocol cho phép trợ lý AI gọi trực tiếp API s.id. Máy chủ đã được lưu trữ sẵn nên không cần cài đặt gì thêm. Điểm cuối: POST https://mcp.s.id/mcp (Truyền luồng HTTP, JSON-RPC 2.0)
Kết nối client
Xác thực dùng cùng thông tin đăng nhập với API: API key hoặc token OAuth 2.0. Chọn ứng dụng AI của bạn bên dưới và thay sk_live_... bằng API key từ Dashboard > Developer.
Trong claude.ai hoặc Claude Desktop, mở Settings > Connectors > Add custom connector, dán URL bên dưới rồi đăng nhập bằng tài khoản s.id (OAuth). Không cần API key.
https://mcp.s.id/mcpClient hỗ trợ OAuth có thể tìm máy chủ ủy quyền qua https://mcp.s.id/.well-known/oauth-protected-resource.
Ví dụ prompt
Sau khi kết nối, chỉ cần yêu cầu bằng ngôn ngữ thường ngày. Trợ lý sẽ tự chọn tool phù hợp.
Tạo giúp tôi một link rút gọn cho https://example.com/catalog-2026 với tiêu đề 'Holiday Catalog'.
Tool được dùng:create_linkKiểm tra xem alias [ten-khuyen-mai] còn trống không, nếu còn thì dùng cho https://example.com/promo.
Tool được dùng:check_short_availabilitycreate_linkTuần này các link của tôi có bao nhiêu lượt nhấp và đến từ những quốc gia nào?
Tool được dùng:get_account_statsget_link_statsTạo mã QR cho link catalog đó với màu đỏ và logo ở giữa.
Tool được dùng:get_link_qrset_link_qrTạo microsite cho cửa hàng của tôi gồm nút WhatsApp, link catalog và giờ mở cửa.
Tool được dùng:create_micrositecreate_microsite_componentLưu trữ tất cả link không có lượt nhấp nào trong 90 ngày qua.
Tool được dùng:list_linksget_link_lifetime_statsdelete_linkTháng này tôi còn bao nhiêu hạn mức link và microsite?
Tool được dùng:get_quota
Tools và scope
Có 28 tools. Mỗi tool cần cùng scope với endpoint REST tương ứng.
| Nhóm | Số lượng | Tool ví dụ |
|---|---|---|
| Liên kết | 11 | create_linklist_linksget_link_statsdelete_link |
| Microsite | 11 | create_micrositeupdate_micrositecreate_microsite_component |
| QR | 4 | get_link_qrset_link_qrget_global_qrset_global_qr |
| Tài khoản | 2 | get_user_infoget_quota |
Quota MCP tách biệt với quota REST API. Quota chỉ bị trừ khi gọi tools/call, còn bước bắt tay initialize và tools/list thì miễn phí.