s.id Logo
s.id
Platform Developer

Server MCP

Biarkan AI agent mengelola akun s.id kamu lewat Model Context Protocol.

Ringkasan

s.id menjalankan server MCP (Model Context Protocol) yang di-hosting, jadi AI agent dan klien yang kompatibel dengan MCP — seperti Claude — bisa membuat link, mengelola microsite, dan membaca analitik atas nama kamu. Server ini menggunakan JSON-RPC 2.0 lewat satu endpoint dan mengautentikasi dengan API key atau kredensial OAuth 2.0 yang sama seperti REST API.

Hubungkan

Arahkan klien MCP kamu ke endpoint di bawah dan autentikasi dengan API key atau OAuth 2.0 Bearer token — server akan otomatis menemukan authorization server kamu lewat RFC 9728.

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

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

Tools

Tersedia 28 tools, mencakup link, microsite, kode QR, dan data akun. Setiap tool membutuhkan scope yang sama dengan padanan REST-nya.

Links

ToolDeskripsiScope
create_linkCreate a short linklinks:write
bulk_create_linksCreate multiple short links in one calllinks:write
get_linkGet a link by IDlinks:read
list_linksList linkslinks:read
update_linkUpdate a linklinks:write
delete_linkArchive a linklinks:archive
unarchive_linkRestore an archived linklinks:write
check_short_availabilityCheck if a custom slug is availablelinks:read
get_link_statsGet a link's click timelinelinks:analytics
get_link_lifetime_statsGet a link's lifetime click countlinks:analytics
get_account_statsGet account-level click analyticslinks:analytics

Microsites

ToolDeskripsiScope
create_micrositeCreate a micrositemicrosites:write
get_micrositeGet a microsite by slugmicrosites:read
list_micrositesList micrositesmicrosites:read
update_micrositeUpdate a micrositemicrosites:write
delete_micrositeDelete a micrositemicrosites:delete
check_microsite_slugCheck if a microsite slug is availablemicrosites:read
create_microsite_componentAdd a component to a micrositemicrosites:write
list_microsite_componentsList a microsite's componentsmicrosites:read
update_microsite_componentUpdate a microsite componentmicrosites:write
delete_microsite_componentDelete a microsite componentmicrosites:delete
order_microsite_componentsReorder a microsite's componentsmicrosites:write

QR

ToolDeskripsiScope
get_link_qrGet a link's QR code settingsqr:read
set_link_qrCustomize a link's QR codeqr:write
get_global_qrGet global QR code settingsqr:read
set_global_qrCustomize global QR code settingsqr:write

Account

ToolDeskripsiScope
get_user_infoGet the authenticated user's profileuser:read
get_quotaGet the authenticated user's account quotauser:read

Kuota

Kuota terpisah

Panggilan tool MCP menggunakan kuota harian tersendiri, terpisah dari kuota panggilan REST API kamu — menggunakan server MCP tidak mengurangi jatah /v2 API kamu. Hanya permintaan tools/call yang menghitung kuota; tools/list dan initialize gratis.

Lihat penggunaan kamu

Autentikasi

API key atau OAuth 2.0

Autentikasi dengan API key sk_live_ atau OAuth 2.0 Bearer token yang sama seperti yang kamu pakai untuk REST API — s.id adalah authorization server OAuth 2.0-nya sendiri, jadi klien bisa menyelesaikan alur autorisasi penuh dan memakai token hasilnya di sini.

Panduan OAuth 2.0