SimplyBoost MCP

npx add-mcp 'https://get-api.simplyboost.io/api/v1/mcp'

Apa itu

Server MCP berada di https://get-api.simplyboost.io/api/v1/mcp. Server ini menggunakan transport HTTP Streamable dan token API yang sama dengan REST API (Authorization: Bearer sb_live_…), paket yang sama (Growth, Pro, dan Enterprise), izin yang sama, serta batas yang sama. Setiap alat melakukan hal yang sama dengan endpoint REST yang sesuai dan memerlukan cakupan yang sama; asisten akan melihat alat yang tidak boleh digunakannya sebagai penolakan yang jelas, bukan sebagai kesalahan.

Server ini stateless: setiap panggilan terdiri dari satu permintaan dan satu jawaban, tanpa sesi yang perlu dipertahankan, sehingga Anda dapat terhubung dari mesin mana pun. Server tidak pernah memulai aliran sendiri.

Hubungkan klien

Ada dua cara. Masuk (OAuth): tambahkan alamat server, lalu saat klien meminta, setujui di tab SimplyBoost sebagai pemilik tim dengan memilih tim, izin, dan chatbot. Inilah cara konektor claude.ai dan ChatGPT, Cursor, Codex, serta Claude Code terhubung tanpa perlu menempelkan apa pun. Token: untuk klien yang Anda konfigurasi secara manual atau skrip buatan sendiri, buat token di Settings → API dengan hanya izin yang dibutuhkan asisten, lalu kirimkan sebagai header.

Claude Code (masuk saat diminta)

claude mcp add --transport http simplyboost https://get-api.simplyboost.io/api/v1/mcp

Codex

codex mcp add simplyboost --url https://get-api.simplyboost.io/api/v1/mcp
codex mcp login simplyboost

Cursor, Windsurf, VS Code, dan klien lain dengan mcp.json (masuk saat diminta)

{
  "mcpServers": {
    "simplyboost": { "url": "https://get-api.simplyboost.io/api/v1/mcp" }
  }
}

Cara yang sama, tetapi menggunakan token alih-alih masuk

{
  "mcpServers": {
    "simplyboost": {
      "url": "https://get-api.simplyboost.io/api/v1/mcp",
      "headers": { "Authorization": "Bearer sb_live_…" }
    }
  }
}

Koneksi yang dibuat dengan masuk berlaku selama 90 hari, hanya mendapatkan izin yang dicentang oleh pemilik (penghapusan dinonaktifkan kecuali dicentang), dan tercantum di Settings → API → Connected apps, tempat pemilik dapat memutuskan koneksinya kapan saja. Hanya pemilik tim yang dapat menyetujui koneksi, sama seperti aturan untuk membuat token. Nama aplikasi di layar persetujuan adalah nama yang dinyatakan oleh aplikasi itu sendiri; SimplyBoost tidak memverifikasinya.

Token dalam konfigurasi klien adalah kata sandi untuk akun Anda. Simpan di komputer Anda sendiri, tetapkan masa berlaku, dan rotasi token jika file konfigurasi dibagikan. Masuk menghindari masalah ini: tidak ada rahasia yang ditulis ke file.

Untuk pengembang klien: server mengikuti spesifikasi otorisasi MCP. Permintaan tanpa kredensial menjawab 401 dengan header WWW-Authenticate yang menyebut metadata resource terlindungi (https://get-api.simplyboost.io/.well-known/oauth-protected-resource/api/v1/mcp), yang menyebut server otorisasi (https://get-api.simplyboost.io/.well-known/oauth-authorization-server). Klien mendaftarkan dirinya sendiri (Dynamic Client Registration), menggunakan alur kode otorisasi dengan PKCE (hanya S256), dapat menyebut resource, dan mendapatkan token refresh yang berotasi. Token akses berlaku selama satu jam dan hanya berfungsi di endpoint MCP; endpoint REST menggunakan token API.

Alat

Argumen dan hasil menggunakan nama yang sama dengan REST API (chatbotId, threadId, kolom camelCase), sehingga halaman endpoint menjelaskan keduanya. Mulai dengan list_chatbots untuk menemukan id chatbot.

Alat	Memerlukan	Fungsi
get_account	tidak ada	Akun, paket, dan izin token itu sendiri.
get_usage	account:read	Pesan yang digunakan pada periode penagihan ini.
list_chatbots, get_chatbot	chatbots:read	Chatbot yang dapat digunakan oleh token.
send_message	conversations:write	Bertanya kepada chatbot seperti yang dilakukan pengunjung; dihitung dalam jumlah pesan paket. Berikan threadId untuk melanjutkan.
list_conversations, get_conversation, list_messages	conversations:read	Percakapan di semua kanal beserta pesannya.
take_over_conversation, reply_to_conversation, hand_back_to_chatbot, resolve_conversation	conversations:write	Menangani percakapan sebagai manusia: mengambil alih, membalas, menyerahkan kembali, menyelesaikan, atau membuka kembali.
list_leads, get_lead	leads:read	Prospek yang dikumpulkan chatbot.
update_lead	leads:write	Mengubah detail prospek atau menandainya sebagai terkonversi.
delete_lead	leads:delete	Menghapus prospek.
list_knowledge_sources, get_knowledge_source	knowledge:read	Informasi yang diketahui chatbot, beserta status dan teks setiap sumber.
add_text_knowledge, add_website_knowledge, update_knowledge_source, refresh_knowledge_source	knowledge:write	Mengajarkan teks atau situs web kepada chatbot, mengedit sumber, membaca ulang situs web.
delete_knowledge_source	knowledge:delete	Menghapus sumber.

Unggahan file dan webhook tidak tersedia sebagai alat; gunakan endpoint REST untuk itu. Alat penghapusan ditandai sebagai destruktif, dan instruksi server meminta asisten untuk bertanya kepada Anda terlebih dahulu.

Kesalahan dan batas

Panggilan alat yang ditolak (karena izin tidak ada, chatbot tidak dapat dilihat oleh token, argumen tidak valid, atau batas paket) dikembalikan sebagai hasil alat yang ditandai sebagai kesalahan, dengan code dan pesan yang sama seperti yang akan diberikan REST API, sehingga asisten dapat memberi tahu Anda apa yang perlu diubah. Token yang tidak ada atau tidak valid menjawab 401, paket tanpa API atau langganan yang kedaluwarsa menjawab 403, dan batas laju per token menjawab 429, persis seperti pada REST API.

Pesan yang bukan JSON-RPC 2.0 menghasilkan kesalahan JSON-RPC. GET dan DELETE pada endpoint menjawab 405, karena tidak ada sesi maupun aliran server.