Chuyển đến nội dung chính
s.id Logo
Xem Markdown

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.

text
https://mcp.s.id/mcp

Client 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_link
  • Kiể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_link
  • Tuầ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_stats
  • Tạo mã QR cho link catalog đó với màu đỏ và logo ở giữa.

    Tool được dùng:get_link_qrset_link_qr
  • Tạ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_component
  • Lư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_link
  • Thá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ómSố lượngTool ví dụ
Liên kết11
create_linklist_linksget_link_statsdelete_link
Microsite11
create_micrositeupdate_micrositecreate_microsite_component
QR4
get_link_qrset_link_qrget_global_qrset_global_qr
Tài khoản2
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í.