Máy chủ MCP

Cho phép AI agent quản lý tài khoản s.id của bạn thông qua Model Context Protocol.

Tổng quan

s.id vận hành một máy chủ MCP (Model Context Protocol) được lưu trữ để AI agent và các client tương thích MCP — như Claude — có thể tạo liên kết, quản lý microsite và đọc dữ liệu phân tích thay bạn. Máy chủ sử dụng JSON-RPC 2.0 qua một endpoint duy nhất và xác thực bằng cùng API key hoặc thông tin xác thực OAuth 2.0 như REST API.

Kết nối

Trỏ MCP client của bạn đến endpoint bên dưới và xác thực bằng API key hoặc OAuth 2.0 Bearer token — máy chủ sẽ tự động phát hiện authorization server của bạn qua RFC 9728.

Endpoint: https://mcp.s.id/mcp

{
  "mcpServers": {
    "sid": {
      "url": "https://mcp.s.id/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

Công cụ

Có 28 công cụ, bao gồm liên kết, microsite, mã QR và dữ liệu tài khoản. Mỗi công cụ yêu cầu phạm vi giống với REST tương ứng.

Links

Công cụ	Mô tả	Phạm vi
create_link	Create a short link	`links:write`
bulk_create_links	Create multiple short links in one call	`links:write`
get_link	Get a link by ID	`links:read`
list_links	List links	`links:read`
update_link	Update a link	`links:write`
delete_link	Archive a link	`links:archive`
unarchive_link	Restore an archived link	`links:write`
check_short_availability	Check if a custom slug is available	`links:read`
get_link_stats	Get a link's click timeline	`links:analytics`
get_link_lifetime_stats	Get a link's lifetime click count	`links:analytics`
get_account_stats	Get account-level click analytics	`links:analytics`

Microsites

Công cụ	Mô tả	Phạm vi
create_microsite	Create a microsite	`microsites:write`
get_microsite	Get a microsite by slug	`microsites:read`
list_microsites	List microsites	`microsites:read`
update_microsite	Update a microsite	`microsites:write`
delete_microsite	Delete a microsite	`microsites:delete`
check_microsite_slug	Check if a microsite slug is available	`microsites:read`
create_microsite_component	Add a component to a microsite	`microsites:write`
list_microsite_components	List a microsite's components	`microsites:read`
update_microsite_component	Update a microsite component	`microsites:write`
delete_microsite_component	Delete a microsite component	`microsites:delete`
order_microsite_components	Reorder a microsite's components	`microsites:write`

QR

Công cụ	Mô tả	Phạm vi
get_link_qr	Get a link's QR code settings	`qr:read`
set_link_qr	Customize a link's QR code	`qr:write`
get_global_qr	Get global QR code settings	`qr:read`
set_global_qr	Customize global QR code settings	`qr:write`

Account

Công cụ	Mô tả	Phạm vi
get_user_info	Get the authenticated user's profile	`user:read`
get_quota	Get the authenticated user's account quota	`user:read`

Hạn mức

Hạn mức riêng biệt

Các lệnh gọi công cụ MCP sử dụng hạn mức hằng ngày riêng, tách biệt với hạn mức gọi REST API của bạn — sử dụng máy chủ MCP không tiêu tốn hạn mức /v2 API của bạn. Chỉ có tools/call mới tính vào hạn mức; tools/list và initialize là miễn phí.

Xem mức sử dụng của bạn

Xác thực

API key hoặc OAuth 2.0

Xác thực bằng cùng API key sk_live_ hoặc OAuth 2.0 Bearer token mà bạn dùng cho REST API — s.id là authorization server OAuth 2.0 của riêng mình, vì vậy client có thể hoàn tất toàn bộ luồng ủy quyền và sử dụng token nhận được tại đây.

Hướng dẫn OAuth 2.0

Lấy API key của bạn Nền tảng nhà phát triển