Hubungkan Shager ke Claude Code: Satu Perintah, Lalu Siapkan Draf untuk 50 Akun dari Terminal

Untuk menghubungkan Shager ke Claude Code, jalankan claude mcp add --transport http shager https://app.shager.ai/api/mcp --header "Authorization: Bearer shgr_live_...", lalu periksa /mcp di dalam sesi. Perintah itu mendaftarkan server MCP remote Shager lewat streamable HTTP, dan Claude Code langsung bisa menampilkan workspace, akun yang terhubung, dan postingan Anda. Begitu kunci API sudah di tangan, semuanya selesai dalam sekitar dua menit.

Panduan ini membahas cara mendapatkan kunci, memilih scope konfigurasi yang tepat, menjaga rahasia agar tidak masuk ke git, dan tugas nyata pertama yang layak dijalankan.

Apa yang Anda perlukan sebelum mulai?

Hanya dua hal: Claude Code yang sudah terpasang, dan kunci API Shager yang diawali shgr_live_.

Ada dua cara mendapatkan kunci itu. Jika Anda sudah punya akun Shager, seseorang di tim Anda membuatnya di https://app.shager.ai/dashboard/agents dan memilih scope-nya (read, write, dan opsional publish). Jika belum punya akun, agen bisa mendaftarkan dirinya sendiri dengan satu panggilan HTTP dan langsung mendapat kunci sandbox. Alur itu dibahas di pendaftaran mandiri agen dan proses klaim, dan versi singkatnya ada di /auth.md.

Satu catatan soal scope sebelum Anda menempelkan apa pun. Di minggu pertama, beri Claude Code read dan write saja. Dengan itu ia bisa membuat workspace, mengunggah media, dan menyusun draf, tetapi tidak bisa menjadwalkan atau memublikasikan apa pun. Tambahkan publish belakangan, setelah Anda percaya pada kualitas draf yang dihasilkannya.

Geser ke samping untuk melihat seluruh diagram

Bagaimana menambahkan server dengan claude mcp add?

Dokumentasi MCP Claude Code menunjukkan format persis untuk server HTTP remote dengan bearer token: --transport http, sebuah nama, URL, dan --header. Untuk Shager, bentuknya seperti ini:

claude mcp add --transport http shager https://app.shager.ai/api/mcp \
  --header "Authorization: Bearer shgr_live_your_key_here"

Dokumentasinya mencatat bahwa claude mcp add menyimpan konfigurasi tanpa memvalidasi kredensial. Salah ketik pada kunci tidak akan gagal di tahap ini. Kegagalannya baru muncul nanti, saat klien mencoba terhubung.

Scope mana yang sebaiknya dipakai?

Flag --scope menentukan di mana konfigurasi disimpan. Menurut halaman dokumentasi yang sama:

Scope	Lokasi penyimpanan	Pakai ketika
local (default)	Konfigurasi pengguna Anda, khusus proyek ini	Anda sedang mencoba Shager di satu repo
project	.mcp.json di repo, dibagikan ke tim	Seluruh tim menjalankan tugas konten dari repo ini
user	Konfigurasi pengguna Anda, semua proyek	Anda ingin Shager tersedia di mana pun Anda membuka Claude Code

Untuk agensi, user biasanya pilihan yang tepat. Distribusi konten tidak terikat pada satu codebase.

claude mcp add --transport http shager --scope user https://app.shager.ai/api/mcp \
  --header "Authorization: Bearer shgr_live_your_key_here"

Bagaimana membagikan konfigurasi tanpa ikut meng-commit kunci?

Jika Anda ingin memakai scope project agar rekan tim otomatis mendapatkan servernya, jangan menulis kunci langsung di .mcp.json. Claude Code mendukung ekspansi environment variable di url dan headers untuk server HTTP, dengan ${VAR} atau ${VAR:-default}. Commit yang ini:

{
  "mcpServers": {
    "shager": {
      "type": "http",
      "url": "https://app.shager.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${SHAGER_API_KEY}"
      }
    }
  }
}

Lalu setiap orang mengekspor kuncinya sendiri di profil shell masing-masing:

export SHAGER_API_KEY="shgr_live_your_key_here"

Ada dua detail dari dokumentasi yang penting di sini. Jika variabelnya belum di-set, Claude Code tetap memuat konfigurasi dan mengirim teks ${SHAGER_API_KEY} apa adanya, disertai peringatan di claude mcp list. Selain itu, beberapa nama kredensial yang dicadangkan seperti ANTHROPIC_API_KEY sengaja diekspansi menjadi kosong di header remote, jadi selalu gunakan nama variabel Anda sendiri. SHAGER_API_KEY aman dipakai.

Kunci terpisah untuk tiap orang juga membuat log audit di https://app.shager.ai/dashboard/agents benar-benar berguna. Setiap panggilan agen dicatat atas nama kunci yang melakukannya, sehingga Anda tahu sesi siapa yang membuat draf mana.

Bagaimana memastikan semuanya berfungsi?

Dari shell:

claude mcp list
claude mcp get shager

Di dalam sesi, ketik /mcp. Server yang sehat akan tampil sebagai terhubung. Menurut dokumentasi, server dengan kredensial yang salah akan tampil gagal, dan detailnya menyertakan status HTTP. Untuk Shager, 401 berarti header tidak ada atau formatnya salah. Server mengharapkan persis Authorization: Bearer shgr_..., dengan kata Bearer dan satu spasi.

Kemudian minta Claude melakukan sesuatu yang ringan dan hanya membaca:

Call whoami on shager, then list my workspaces with their channel counts.

whoami mengembalikan organisasi dan scope yang dimiliki kunci. Jika yang muncul read dan write tanpa publish, berarti pengaturan berjalan persis seperti yang dimaksud.

Geser ke samping untuk melihat seluruh diagram

Apa tugas nyata pertama yang sebaiknya dijalankan?

Jangan mulai dengan "publikasikan sesuatu". Mulailah dengan draf yang menguji bagian-bagian Shager yang penting saat bekerja dalam skala besar. Contoh prompt pertama yang baik:

In the workspace "Northside Dental", list the channels and the account groups.
Upload this video as media: https://example.com/clips/whitening-30s.mp4
(width 1080, height 1920, duration_ms 30000).
Then create a DRAFT post (no schedule_at) to the group "All locations" as a REEL,
with a caption per channel that mentions the city in that account's name,
first_comment "Book a slot: " plus the cta_url,
cta_url https://northsidedental.example/book, campaign "whitening-oct".
Show me the per-channel captions before you call create_post.

Di balik layar, Claude merangkai list_channels, list_groups, upload_media_from_url, dan create_post. Tiga field dalam panggilan itu melakukan pekerjaan paling berat.

1. per_channel membuat setiap akun mendapat caption sendiri, bukan lima puluh postingan yang identik. Platform maupun audiens sama-sama menyadari konten duplikat, itulah sebabnya kami merekomendasikannya di artikel menghindari blokir spam saat posting dalam skala besar.
2. cta_url mendapat tautan pendek dan tag UTM terpisah untuk setiap akun, dengan utm_content sebagai penanda akunnya. Data klik kembali per akun lewat get_analytics.
3. Mengirim width, height, dan duration_ms saat unggah memungkinkan Shager memvalidasi Reel terhadap aturan setiap platform sebelum ada yang masuk antrean.

Karena tidak ada schedule_at yang dikirim, hasilnya berupa draf. Anda bisa meninjaunya di aplikasi Shager atau meminta Claude menjalankan get_post.

Bagaimana mengontrol apa yang boleh dilakukan Claude Code?

Claude Code meminta izin sebelum memanggil tool MCP, kecuali Anda sudah mengizinkannya. Tool MCP diberi nama mcp__<server>__<tool>, jadi untuk Shager Anda akan melihat mcp__shager__create_post, mcp__shager__list_posts, dan seterusnya. Allowlist awal yang masuk akal adalah menyetujui tool baca saja dan membiarkan semua yang menulis tetap meminta konfirmasi. Padukan dengan kunci tanpa publish, dan Anda punya dua rem yang saling independen: klien bertanya kepada Anda, dan server tetap menolak penjadwalan apa pun yang terjadi.

Saat Anda siap menjadwalkan, buat kunci baru dengan publish, ganti environment variable-nya, dan simpan kunci read/write yang lama untuk sesi eksplorasi. REST API dan server MCP Shager menerapkan scope yang sama, jadi aturannya berlaku jalur mana pun yang dipakai skrip.

Daftar periksa pemecahan masalah

Gejala	Kemungkinan penyebab	Solusi
/mcp menampilkan gagal, 401	Header tidak memuat Bearer atau kunci salah ketik	Tambahkan ulang server, atau pastikan env var sudah diekspor di shell yang menjalankan Claude
Tool muncul tetapi create_post dengan schedule_at mengembalikan 403	Kunci tidak punya publish, atau sandbox belum diklaim	Memang begitu seharusnya. Buat draf saja, atau minta seseorang menambahkan scope-nya
429 rate_limited	Lebih dari 120 request per menit pada satu kunci	Gabungkan pekerjaan; satu create_post sudah mencakup banyak akun
422 rejected	Ada aturan platform yang dilanggar, misalnya Reel terlalu panjang	Baca pesannya; di sana tertulis akun dan aturan yang dimaksud

FAQ

Apakah saya perlu memasang sesuatu selain Claude Code?

Tidak. Shager berjalan sebagai server MCP remote, jadi tidak ada proses lokal, container Docker, atau paket npm yang perlu dipasang. Claude Code berkomunikasi langsung dengan https://app.shager.ai/api/mcp lewat streamable HTTP.

Bisakah Claude Code memublikasikan tanpa saya menyetujui setiap postingan?

Hanya jika kunci yang dipakainya punya scope publish dan akunnya sudah diklaim oleh manusia. Tanpa scope itu, panggilan untuk menjadwalkan dan memublikasikan akan mengembalikan 403, apa pun yang dicoba agen. Banyak tim juga mengaktifkan persetujuan klien per workspace, yang menambahkan langkah tinjauan manusia sebelum penjadwalan.

Apakah Shager mendukung login OAuth untuk Claude Code?

Ya. Server MCP Shager mendukung login OAuth untuk klien MCP apa pun yang mendukungnya. Tambahkan server tanpa flag --header, jalankan /mcp dan pilih autentikasi, lalu masuk ke Shager dan setujui di browser. Header kunci API seperti di atas tetap berfungsi, dan lebih cocok untuk skrip serta mesin yang tidak bisa login.

Langkah berikutnya

Setelah Claude Code bisa melihat workspace Anda, langkah wajar berikutnya adalah membuat rutinitas ini bisa diulang tanpa mengetik ulang prompt. Panduan membangun Claude skill untuk Shager mengubah alur kerja draf di atas menjadi perintah /shager yang bisa dijalankan seluruh tim, dan halaman agen mencantumkan setiap tool dan endpoint jika Anda ingin melihat peta lengkapnya terlebih dulu.