MCP Servers
Model Context Protocol membuat asisten AI bisa memanggil API s.id secara langsung. Server sudah di-hosting, jadi tidak ada yang perlu dipasang. Endpoint: POST https://mcp.s.id/mcp (Streamable HTTP, JSON-RPC 2.0)
Menghubungkan klien
Autentikasinya memakai kredensial yang sama dengan API: API key atau token OAuth 2.0. Pilih aplikasi AI yang kamu pakai, lalu ganti sk_live_... dengan API key dari Dashboard > Developer.
Di claude.ai atau Claude Desktop, buka Settings > Connectors > Add custom connector, tempel URL di bawah, lalu masuk dengan akun s.id (OAuth). Tidak perlu API key.
https://mcp.s.id/mcpKlien yang mendukung OAuth dapat menemukan server otorisasi lewat https://mcp.s.id/.well-known/oauth-protected-resource.
Contoh prompt
Setelah terhubung, cukup minta dengan bahasa sehari-hari. Asisten akan memilih tool yang sesuai.
Tolong buatkan link pendek untuk https://contoh.id/katalog-2026 dengan judul 'Katalog Lebaran'.
Tool yang dipakai:create_linkCek apakah alias [nama-promo] masih tersedia. Kalau ada, langsung pakai untuk https://contoh.id/promo.
Tool yang dipakai:check_short_availabilitycreate_linkBerapa klik semua link saya minggu ini, dan dari negara mana saja?
Tool yang dipakai:get_account_statsget_link_statsBuatkan QR Code untuk link katalog tadi dengan warna merah dan logo di tengah.
Tool yang dipakai:get_link_qrset_link_qrBuat microsite untuk toko saya berisi tombol WhatsApp, link katalog, dan jam buka.
Tool yang dipakai:create_micrositecreate_microsite_componentArsipkan semua link yang tidak ada kliknya dalam 90 hari terakhir.
Tool yang dipakai:list_linksget_link_lifetime_statsdelete_linkSisa kuota link dan microsite saya bulan ini berapa?
Tool yang dipakai:get_quota
Tools dan scope
Tersedia 28 tools. Setiap tool membutuhkan scope yang sama dengan endpoint REST padanannya.
| Grup | Jumlah | Contoh tool |
|---|---|---|
| Link | 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 |
| Akun | 2 | get_user_infoget_quota |
Kuota MCP terpisah dari kuota REST API. Kuota hanya terpakai saat tools/call, sedangkan handshake initialize dan tools/list gratis.