Langsung ke konten utama
Scalev MCP memungkinkan asisten AI yang mendukung remote MCP terhubung ke satu atau beberapa bisnis Scalev Anda. Gunakan konektor ini saat Anda ingin asisten memeriksa data bisnis, mencari aksi Scalev API v3 yang tersedia, atau menjalankan request API bisnis yang sudah disetujui melalui koneksi OAuth. URL konektor adalah: 
https://mcp.scalev.com/mcp
Jangan tempel API key Scalev ke asisten AI. Gunakan konektor MCP agar Scalev dapat mengautentikasi Anda dengan OAuth, menampilkan izin yang diminta, dan menegakkan akses pada setiap request.

​
Cara kerjanya

Alurnya adalah: 
Asisten AI
  -> Konektor Scalev MCP
  -> Scalev API v3
Saat Anda menghubungkan asisten, Scalev membuka alur persetujuan OAuth. Anda masuk, memilih satu atau beberapa bisnis, meninjau izin yang diminta, lalu menyetujui akses. Setelah disetujui, asisten memanggil konektor Scalev MCP. Konektor meneruskan token OAuth ke Scalev API v3. Scalev memvalidasi token, menentukan user dan bisnis yang dipilih untuk setiap request API bisnis, memeriksa scope, lalu menjalankan aksi API yang diminta. Anda hanya perlu memasukkan URL konektor MCP. Asisten akan menemukan issuer OAuth Scalev di https://api.scalev.com/v3/oauth, lalu membaca metadata-nya dan membuka halaman persetujuan di https://app.scalev.com/oauth/authorize. Jangan gunakan https://app.scalev.com/oauth/authorize sebagai URL konektor MCP. URL tersebut adalah halaman persetujuan browser yang dipakai selama OAuth.

​
Tools yang tersedia

Scalev MCP menyediakan 25 tool:
  • get_me: menampilkan user, OAuth app, bisnis yang terhubung, dan konteks izin.
  • get_docs: membaca dokumentasi Scalev Developers yang dibundel ke MCP dari semua halaman di tab Developers pada navigasi docs saat asisten tidak dapat membuka docs.scalev.com. Ini adalah lookup lokal read-only yang tidak memanggil Scalev API atau mengubah data bisnis.
  • search: mencari endpoint Scalev API v3 yang membutuhkan autentikasi bisnis dan dapat diminta oleh asisten.
  • get: membaca satu endpoint GET yang ditemukan melalui search.
  • execute_safe: menjalankan endpoint non-GET yang tidak destruktif, seperti create, update, validasi, atau change status.
  • execute_destructive: menjalankan endpoint non-GET yang destruktif, seperti delete, cancel, revoke, remove, atau disconnect.
  • list_landing_pages: menampilkan daftar landing page bisnis.
  • list_landing_page_tags: menampilkan tag landing page yang tersedia untuk bisnis.
  • get_landing_page: membaca satu landing page bisnis.
  • get_landing_page_public_view: membaca data render publik terautentikasi untuk satu landing page.
  • create_landing_page: membuat landing page. Untuk publish HTML Mode dalam satu panggilan, kirim is_published: true dengan page_display.
  • update_landing_page: mengubah metadata atau status publish landing page.
  • update_landing_page_tags: mengganti tag yang terpasang pada satu landing page.
  • delete_landing_page: menghapus landing page secara soft-delete.
  • list_landing_page_displays: menampilkan versi display tersimpan untuk satu landing page.
  • create_landing_page_display: membuat versi display baru dengan HTML/CSS/JS, pixel analytics, atau data form checkout.
  • validate_landing_page_display: memvalidasi payload display tanpa menyimpannya.
  • get_landing_page_display: membaca satu versi display yang tersimpan.
  • delete_landing_page_display: menghapus satu versi display yang tersimpan.
  • list_orders: menampilkan daftar order bisnis.
  • get_order: membaca satu order bisnis.
  • create_order: membuat satu order bisnis.
  • update_order: mengubah satu order bisnis.
  • change_order_status: mengubah status order atau pembayaran setelah ada instruksi eksplisit.
  • get_order_statistics: membaca statistik order agregat untuk bisnis yang dipilih.
Model ini mempertahankan surface katalog generik sekaligus menambahkan tool semantik untuk seluruh operasi publik Landing Pages dan workflow Orders yang paling berguna saat review. Rute alur OAuth, rute khusus dashboard, dan rute storefront browser tidak tersedia melalui MCP. Hasil search dapat menyertakan docs_topic, docs_url, dan docs_hint. Jika field tersebut ada, minta asisten memanggil get_docs sebelum membuat payload request atau menjalankan aksi tulis. search mengembalikan execution_tool berupa get, execute_safe, atau execute_destructive. Gunakan nilai itu. Konektor menolak pemanggilan tool yang salah, sehingga operasi destruktif tidak bisa berjalan melalui execute_safe, aksi tulis aman tidak bisa berjalan melalui execute_destructive, dan operasi GET harus memakai get atau tool semantik baca. get_me mengembalikan connected_businesses[]. Jika koneksi mencakup lebih dari satu bisnis, asisten harus mengirim business_unique_id pada tool yang membutuhkan bisnis. business_unique_id top-level tetap menjadi bentuk yang disarankan. Jika client tidak sengaja menaruh key persis business_unique_id di body, query, query_params, header_params, headers, atau query string path konkret, Scalev MCP akan memulihkannya dan meneruskannya ke Scalev sebagai selector bisnis. Jika koneksi hanya mencakup satu bisnis, asisten dapat menghilangkannya. Untuk aksi tulis, asisten dapat mengirim field endpoint secara langsung atau di dalam field body. Scalev MCP meneruskan JSON body tersebut ke Scalev API v3 tanpa mengubah isinya. Contoh pekerjaan yang umum:
  • menampilkan user, OAuth app, dan bisnis yang terhubung
  • membaca dokumentasi Scalev untuk area API yang dipilih sebelum membuat perubahan
  • menampilkan daftar order, produk, bundle, customer, toko, atau landing page
  • membaca detail page, order, produk, atau WhatsApp account
  • memvalidasi atau membuat resource bisnis yang diizinkan melalui Scalev API v3
  • menjalankan aksi API bisnis yang sudah disetujui dan muncul di search, memakai get untuk endpoint GET serta execute_safe atau execute_destructive untuk endpoint non-GET

​
Kebutuhan

Anda membutuhkan:
  • akun Scalev dengan akses ke sebuah bisnis
  • asisten AI atau MCP client yang mendukung remote MCP server dengan OAuth
  • akses ke URL konektor Scalev MCP
Sebagian asisten AI membatasi custom connector berdasarkan plan, workspace, atau pengaturan administrator. Periksa pengaturan asisten AI Anda jika tidak melihat opsi untuk menambahkan custom MCP server.

​
Hubungkan asisten AI

  1. Buka pengaturan connector atau tools di asisten AI Anda.
  2. Tambahkan custom MCP server atau connector.
  3. Masukkan https://mcp.scalev.com/mcp sebagai URL konektor.
  4. Lanjutkan ke layar persetujuan OAuth Scalev.
  5. Masuk ke Scalev jika diminta.
  6. Pilih bisnis yang ingin Anda berikan akses ke asisten. Anda dapat memilih lebih dari satu jika tersedia.
  7. Tinjau izin yang diminta.
  8. Klik Authorize.
  9. Kembali ke asisten AI dan uji koneksinya.
Contoh prompt pertama:
  • “Tampilkan profil bisnis Scalev saya.”
  • “Baca dokumentasi Scalev untuk Landing Pages API, lalu cari aksi untuk membuat landing page.”
  • “Cari endpoint Scalev untuk menampilkan daftar landing page.”
  • “Cari aksi API untuk membaca order, lalu tampilkan field yang dibutuhkan.”

​
Gunakan dengan ChatGPT

ChatGPT dapat terhubung ke Scalev melalui custom MCP connector jika fitur tersebut tersedia untuk akun atau workspace Anda.
  1. Pastikan custom MCP connector atau developer mode aktif untuk akun atau workspace ChatGPT Anda.
  2. Buat custom MCP app atau connector.
  3. Gunakan https://mcp.scalev.com/mcp sebagai MCP server URL.
  4. Publish atau aktifkan connector untuk workspace jika plan Anda memerlukan review admin.
  5. Hubungkan Scalev dan selesaikan alur persetujuan OAuth Scalev.
  6. Di chat baru, pilih Scalev dari menu tools sebelum meminta asisten bekerja dengan bisnis Scalev Anda.
ChatGPT dapat meminta konfirmasi sebelum menjalankan aksi tulis. Tinjau konfirmasi tersebut sebelum menyetujui perubahan di Scalev. Referensi: Apps in ChatGPT dan Building MCP servers for ChatGPT.

​
Gunakan dengan Claude

Claude mendukung remote MCP server melalui custom connectors. Untuk plan Claude individual:
  1. Buka Customize > Connectors di Claude.
  2. Klik +.
  3. Pilih Add custom connector.
  4. Masukkan https://mcp.scalev.com/mcp sebagai remote MCP server URL.
  5. Klik Add.
  6. Klik Connect dan selesaikan alur persetujuan OAuth Scalev.
Untuk workspace Claude Team dan Enterprise:
  1. Minta Owner atau Primary Owner membuka Organization settings > Connectors.
  2. Klik Add.
  3. Pilih Custom > Web.
  4. Masukkan https://mcp.scalev.com/mcp sebagai remote MCP server URL.
  5. Klik Add.
  6. Setiap member lalu dapat membuka Customize > Connectors, mencari Scalev, dan klik Connect.
Untuk menggunakan Scalev di percakapan Claude, buka menu + di composer, pilih Connectors, lalu aktifkan Scalev untuk chat tersebut. Referensi: Claude custom connectors using remote MCP.

​
Gunakan dengan Claude Code

Claude Code mendukung remote MCP server melalui Streamable HTTP dan menangani alur OAuth secara otomatis.
  1. Tambahkan konektor pada scope user agar tersedia di semua project: 
    claude mcp add --transport http --scope user scalev https://mcp.scalev.com/mcp
  2. Verifikasi konektor sudah terdaftar: 
    claude mcp list
claude mcp get scalev
  3. Jalankan Claude Code lalu ketik perintah slash /mcp.
  4. Pilih scalev dari daftar server MCP.
  5. Pilih Authenticate. Claude Code membuka browser untuk alur persetujuan OAuth Scalev. Masuk, pilih bisnis yang ingin Anda berikan akses ke asisten, tinjau izin yang diminta, lalu setujui.
  6. Kembali ke Claude Code setelah alur browser selesai. Server Scalev seharusnya tampil sebagai authenticated, dan tool Scalev muncul di panel /mcp. Nama tool mengikuti pola mcp__scalev__<tool> (contoh: mcp__scalev__list_landing_pages).
Jika Anda hanya ingin konektor tersedia di project tertentu atau ingin berbagi konfigurasinya dengan tim melalui version control, hilangkan --scope user (local) atau gunakan --scope project untuk menulis entry ke .mcp.json yang ikut di-commit. Referensi: Dokumentasi MCP Claude Code.

​
Gunakan dengan Codex

OpenAI Codex CLI mendukung remote MCP server melalui Streamable HTTP secara native. Tidak perlu package bridge.
  1. Daftarkan konektor. Jalankan: 
    codex mcp add scalev --url https://mcp.scalev.com/mcp
    atau tambahkan blok berikut ke ~/.codex/config.toml: 
    [mcp_servers.scalev]
url = "https://mcp.scalev.com/mcp"
  2. Picu alur OAuth Scalev: 
    codex mcp login scalev
    Codex mencetak URL otorisasi Scalev dan mendengarkan port callback OAuth-nya. Buka URL tersebut di browser, masuk ke Scalev, pilih bisnis yang ingin Anda berikan akses ke asisten, tinjau izin yang diminta, lalu setujui. Codex menyelesaikan pertukaran token saat callback kembali.
  3. Verifikasi konektor dan periksa tool-nya: 
    codex mcp list
codex mcp get scalev
    Di dalam TUI Codex, perintah slash /mcp menampilkan server MCP aktif beserta tool-nya. /mcp verbose menambahkan diagnostik server.
Untuk memutuskan koneksi nanti, jalankan codex mcp logout scalev. Untuk mencabut dari sisi Scalev, ikuti langkah “Cabut akses” di bawah. Referensi: Dokumentasi MCP Codex.

​
Gunakan dengan OpenClaw

OpenClaw mendukung MCP server, tetapi saat ini hanya mendokumentasikan header Authorization statis untuk remote HTTP server. Karena Scalev memakai OAuth Dynamic Client Registration, bukan API key statis, hubungkan Scalev melalui bridge mcp-remote agar alur OAuth dijalankan secara lokal dan tool yang dihasilkan diekspos ke OpenClaw melalui stdio.
  1. Daftarkan bridge: 
    openclaw mcp set scalev '{"command":"npx","args":["-y","mcp-remote","https://mcp.scalev.com/mcp"]}'
    Atau sunting openclaw.json langsung pada bagian mcp.servers: 
    {
  "scalev": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.scalev.com/mcp"]
  }
}
  2. Verifikasi server sudah terdaftar: 
    openclaw mcp list
openclaw mcp show scalev --json
  3. Mulai sesi yang memicu Scalev. Saat pertama kali dipakai, mcp-remote menemukan issuer OAuth Scalev, membuka URL otorisasi, dan mendengarkan port callback OAuth. Buka URL yang tercetak di browser jika tidak terbuka otomatis, masuk ke Scalev, pilih bisnis yang ingin Anda berikan akses ke asisten, tinjau izin yang diminta, lalu setujui. mcp-remote menyimpan token hasilnya di ~/.mcp-auth dan memperbaruinya secara otomatis.
  4. Setelah disetujui, tool Scalev muncul di daftar tool OpenClaw dan dapat dipanggil dari prompt.
Referensi: Dokumentasi CLI MCP OpenClaw dan mcp-remote di npm.

​
Gunakan dengan Hermes Agent

Hermes Agent (Nous Research) mendukung MCP server, tetapi saat ini hanya mendokumentasikan header Authorization statis untuk remote HTTP server. Karena Scalev memakai OAuth Dynamic Client Registration, bukan API key statis, hubungkan Scalev melalui bridge mcp-remote agar alur OAuth dijalankan secara lokal dan tool yang dihasilkan diekspos ke Hermes melalui stdio.
  1. Tambahkan bridge ke ~/.hermes/config.yaml di bagian mcp_servers: 
    mcp_servers:
  scalev:
    command: npx
    args:
      - "-y"
      - "mcp-remote"
      - "https://mcp.scalev.com/mcp"
  2. Muat ulang MCP server di sesi Hermes yang sedang berjalan: 
    /reload-mcp
    Atau mulai sesi baru: 
    hermes chat
  3. Pertama kali Hermes memanggil tool Scalev, mcp-remote menemukan issuer OAuth Scalev, membuka URL otorisasi, dan mendengarkan port callback OAuth. Buka URL yang tercetak di browser jika tidak terbuka otomatis, masuk ke Scalev, pilih bisnis yang ingin Anda berikan akses ke asisten, tinjau izin yang diminta, lalu setujui. mcp-remote menyimpan token hasilnya di ~/.mcp-auth dan memperbaruinya secara otomatis.
  4. Hermes mendaftarkan setiap tool Scalev dengan pola nama mcp_scalev_<tool> (contoh: mcp_scalev_list_landing_pages). Minta Hermes memakai tool tersebut langsung dari percakapan.
Referensi: Dokumentasi MCP Hermes Agent dan mcp-remote di npm.

​
Izin

Layar persetujuan menampilkan izin yang diminta oleh konektor. Scalev hanya memberikan izin yang boleh diminta oleh konektor resmi Scalev MCP. Koneksi pertama dapat meminta izin Scalev API v3 yang didukung oleh MCP agar asisten dapat menemukan dan memakai aksi API bisnis yang tersedia. Izin khusus dashboard tidak menjadi bagian dari persetujuan MCP. Scalev menegakkan izin pada setiap request API. Jika asisten mencoba menjalankan aksi di luar scope yang disetujui, Scalev akan menolak request tersebut.

​
Aksi tulis

Tool execute_safe dan execute_destructive dapat memanggil endpoint Scalev API v3 non-GET jika token OAuth yang terhubung memiliki scope yang dibutuhkan. Sebagian endpoint tersebut dapat membuat, mengubah, menghapus, memvalidasi, atau menjalankan aksi bisnis. Tinjau aksi tulis di asisten AI Anda sebelum mengonfirmasinya. execute_safe adalah tool tulis atau aksi API yang tidak destruktif. Tool ini bukan read-only dan bukan bebas risiko. Gunakan untuk operasi yang hasil search-nya berisi execution_tool: "execute_safe". execute_destructive digunakan untuk operasi destruktif yang hasil search-nya berisi execution_tool: "execute_destructive". Konektor tidak melewati otorisasi Scalev. Peran Anda di bisnis Scalev, scope OAuth yang disetujui, dan endpoint API tujuan tetap menentukan apakah aksi diizinkan.

​
Beberapa bisnis

Satu koneksi OAuth dapat mengotorisasi beberapa bisnis Scalev jika peran user Anda mengizinkan otorisasi aplikasi di setiap bisnis. Scalev mencatat akses secara terpisah untuk setiap bisnis, dan asisten dapat memakai koneksi OAuth yang sama untuk kumpulan bisnis yang terhubung. Minta asisten memanggil get_me terlebih dahulu. Responsnya berisi entry aktif connected_businesses[] dengan unique_id, username, nama, status enabled, dan scope yang disetujui untuk setiap bisnis. Ketika lebih dari satu bisnis terhubung, setiap call tool yang membutuhkan bisnis harus menyertakan business_unique_id. Gunakan unique_id dari connected_businesses[]. business_unique_id top-level adalah input MCP yang canonical. Untuk toleransi client, Scalev MCP juga memulihkan key persis ini dari body, query, query_params, header_params, headers, atau query string path konkret, lalu menghapusnya dari payload/query API sebelum meneruskan request. Jika akses ke salah satu bisnis dicabut atau dinonaktifkan, request untuk bisnis tersebut gagal, tetapi asisten masih dapat memakai bisnis aktif lain yang tetap terhubung. Bisnis yang dicabut tidak muncul di get_me; jika tidak ada bisnis aktif yang tersisa, get_me mengembalikan 403 dan asisten harus terhubung ulang.

​
Cabut akses

Anda dapat mencabut koneksi kapan saja:
  1. Buka Scalev.
  2. Masuk ke Settings > Apps.
  3. Cari Scalev MCP.
  4. Klik Revoke Access.
Setelah akses dicabut, asisten harus terhubung ulang dan menyelesaikan persetujuan OAuth lagi sebelum dapat memanggil bisnis tersebut melalui Scalev. Jika koneksi OAuth yang sama masih memiliki akses ke bisnis lain, bisnis tersebut dapat tetap digunakan.

​
Troubleshooting

​
Asisten mengatakan authentication is required

Hubungkan ulang konektor Scalev MCP dan selesaikan alur persetujuan OAuth lagi.

​
Asisten mendapat error forbidden atau insufficient permission

Bisnis yang terhubung, peran user Anda, atau scope yang disetujui tidak mengizinkan aksi tersebut. Hubungkan ulang jika Anda perlu menyetujui scope yang berbeda.

​
Asisten tidak dapat menemukan konektor

Pastikan URL konektor persis https://mcp.scalev.com/mcp. Asisten AI Anda harus mendukung remote MCP server dengan OAuth. Jika asisten meminta authorization server URL, gunakan https://api.scalev.com/v3/oauth. Jika asisten meminta connector atau MCP server URL, gunakan https://mcp.scalev.com/mcp.

​
Asisten tidak menampilkan landing page

Minta asisten memanggil get_me dan periksa connected_businesses[]. Jika lebih dari satu bisnis terhubung, pastikan asisten memakai business_unique_id yang benar dan bisnis yang dipilih memiliki landing page yang dapat diakses oleh user Anda.

​
Dokumen terkait