Koneksi Lingkungan Produksi

Halaman ini memandu Anda menghubungkan klien AI (seperti Claude Desktop, Claude Code, Cursor, Windsurf, atau framework agent kustom) ke GoSosmed MCP Hub menggunakan endpoint resmi dan kunci API (API Key).

Endpoint Resmi GoSosmed

GoSosmed menyediakan dua kluster lingkungan independen untuk menjaga isolasi antara pengujian dan eksekusi operasional nyata:

Lingkungan	Endpoint Resmi	Peruntukan
Produksi	Streamable HTTP: https://api.bamsbung.id/mcp SSE: https://api.bamsbung.id/mcp/sse	Operasional otomasi riil pengguna, integrasi Claude / Cursor / ZeroClaw
Pengembangan	Streamable HTTP: https://dev-api.bamsbung.id/mcp SSE: https://dev-api.bamsbung.id/mcp/sse	Testing, staging, uji fitur baru sebelum rilis

Gunakan Streamable HTTP untuk Klien AI Anda

Untuk klien AI pribadi (Claude Desktop, Claude Code, Cursor, Windsurf), gunakan https://api.bamsbung.id/mcp (Streamable HTTP).

Endpoint SSE (/mcp/sse) tetap aktif dan didukung penuh. Namun SSE mempertahankan satu koneksi stream berumur panjang; bila jaringan Anda sempat terputus (laptop sleep, perpindahan Wi-Fi, atau timeout Cloudflare), sesi perlu disambung ulang. Streamable HTTP tidak memiliki keterbatasan itu karena setiap panggilan tool berdiri sendiri, sehingga lebih tahan terhadap gangguan jaringan.

Lingkungan pengembangan (dev-api) dicadangkan untuk pengujian fitur eksperimental.

Autentikasi Multi-Tenant API Key

Semua permintaan ke MCP Hub wajib menyertakan token autentikasi berbasis Bearer Token.

1. Membuat Kunci API di Dasbor

1. Buka dasbor GoSosmed di app.bamsbung.id.
2. Masuk ke menu Pengaturan -> Kunci API (atau navigasi langsung ke /settings#api-keys).
3. Klik tombol Buat Kunci API Baru.
4. Beri label yang jelas (misalnya: Claude Desktop - Laptop Kerja atau Cursor IDE - Dev).
5. Salin kunci yang dihasilkan. Kunci ini hanya ditampilkan satu kali demi keamanan.

2. Format Kunci

Kunci API GoSosmed memiliki format standar berawalan prefiks:

• gsk_live_... : Kunci lingkungan produksi (contoh: gsk_live_8f93a1c24e7b8...)
• gsk_test_... : Kunci lingkungan pengujian (contoh: gsk_test_104a99b1c...)

3. Header HTTP Wajib

Setiap koneksi inisiasi SSE atau permintaan POST harus menyertakan header otorisasi berikut:

Authorization: Bearer gsk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Isolasi Ruang Kerja (Tenant Isolation)

GoSosmed menerapkan arsitektur strict multi-tenancy:

• Terikat Kuat: Kunci API gsk_live_... terikat secara kriptografis ke akun ruang kerja (tenant) Anda.
• Batas Visibilitas: Agent AI yang terhubung dengan kunci tersebut hanya dapat melihat perangkat Android dan akun sosial media milik ruang kerja Anda. Agent tidak memiliki akses ke perangkat pengguna lain dalam kondisi apa pun.
• Audit Jejak: Setiap eksekusi tool oleh AI tercatat dalam log audit dasbor dengan identitas kunci yang digunakan.

Cara Kerja Kedua Transport

GoSosmed MCP Hub menyediakan dua transport standar Model Context Protocol:

1. Streamable HTTP (rekomendasi untuk klien AI): Klien membuka koneksi langsung ke https://api.bamsbung.id/mcp dengan header Authorization: Bearer gsk_live_.... Panggilan JSON-RPC (tools/call, tools/list) dan streaming respons ditangani secara terpadu tanpa memerlukan handshake pembuatan sesi pesan terpisah. Karena setiap panggilan berdiri sendiri, gangguan jaringan tidak memaksa Anda mengulang dari awal.

2. SSE (/mcp/sse) — koneksi stream berumur panjang: Klien membuka GET /mcp/sse, menerima event endpoint berisi sessionId, lalu mengirim panggilan tool via POST /mcp/message?sessionId=.... Transport ini aktif dan didukung penuh — dipakai oleh agent internal yang berjalan di server yang sama. Perlu diperhatikan: hasil tools/call dikirim melalui stream SSE, bukan di badan respons POST (POST hanya mengembalikan acknowledgment). Jika stream terputus, koneksi perlu dibangun ulang.

Praktik Keamanan & Pengelolaan Kunci

• Jangan Simpan di Kode Sumber: Simpan kunci di berkas lingkungan lokal (.env) atau berkas konfigurasi klien yang dikecualikan dari Git (.gitignore).
• Satu Klien Satu Kunci: Buat kunci terpisah untuk setiap aplikasi (misalnya satu untuk Claude Desktop, satu untuk Cursor). Jika salah satu perangkat hilang, Anda cukup mencabut satu kunci tanpa mengganggu sistem lainnya.
• Pencabutan Instan: Jika kunci Anda bocor, segera buka /settings#api-keys di dasbor dan klik Cabut Kunci. Sesi MCP yang sedang aktif akan langsung diputus dalam hitungan detik.

---

Selanjutnya:

• Pelajari daftar 24 perintah di Katalog 24 Tools Resmi.
• Siapkan konfigurasi instan di Panduan Integrasi Klien.