# Menghubungkan Shager ke Claude Desktop: Login Lewat Custom Connector, atau Pakai Kunci API

_2026-08-12 · Tambahkan Shager ke Claude Desktop sebagai custom connector lalu login, tanpa kunci yang perlu disalin. Atau pakai kunci API: request header, atau mcp-remote._

Cara paling sederhana menghubungkan Claude Desktop ke Shager adalah menambahkan https://app.shager.ai/api/mcp sebagai custom connector, klik Connect, masuk ke Shager, lalu setujui. Tidak ada kunci yang perlu disalin. Jika Anda lebih suka memakai kunci API, ada dua jalur lain: custom connector dengan opsi No sign-in dan header `authorization` berisi `Bearer shgr_live_...`, jika akun Anda menampilkan bagian Request headers, atau menjembatani server remote lewat `claude_desktop_config.json` dengan paket open source `mcp-remote`, yang meneruskan header yang sama.

Semua jalur berujung di tempat yang sama: Claude di aplikasi desktop bisa menampilkan workspace klien Anda, menyusun draf postingan multi-akun, dan menarik data klik per akun. Bedanya ada pada siapa yang memegang kunci dan seberapa banyak pengaturan yang harus diulang setiap anggota tim.

## Jalur sekali klik: login

Server MCP Shager mendukung login OAuth, dan memang di sekitar itulah custom connector Claude dibangun.

1. Buka Customize, lalu Connectors, dan klik Add custom connector.
2. Beri nama `Shager` dan masukkan URL server MCP `https://app.shager.ai/api/mcp`, lalu klik Add.
3. Klik Connect. Shager terbuka di browser: masuk, pilih organisasi, lalu setujui.

Koneksi ini bisa membaca dan membuat draf. Menjadwalkan dan memublikasikan adalah kotak centang terpisah di layar persetujuan, nonaktif kecuali Anda mencentangnya. Setiap orang terhubung dengan akunnya sendiri, jadi log audit di https://app.shager.ai/dashboard/agents menunjukkan siapa melakukan apa, dan Anda bisa memutus koneksinya di sana kapan saja.

## Kapan sebaiknya memakai kunci API?

Saat Anda menginginkan satu kunci dengan cakupan yang persis dan Anda kelola sendiri, atau koneksi yang tidak bergantung pada login lewat browser. Dokumentasi Anthropic tentang [menambahkan connector yang tidak ada di direktori](https://claude.com/docs/connectors/custom/add-unlisted) menyebut kasus ini secara gamblang: jika server memakai kunci API, pilih No sign-in dan tambahkan kunci di bawah Request headers. Halaman yang sama juga menyebut bahwa autentikasi request header masih "beta dan hanya tersedia untuk sejumlah organisasi". Jadi jalur pertama memang yang tepat, tetapi mungkin belum tersedia untuk Anda. Itulah alasan jalur kedua ada.

## Jalur 1: custom connector dengan request header

Gunakan jalur ini jika Anda melihat Request headers di dialog. Menurut halaman yang sama, custom connector lewat URL berfungsi di paket Free, Pro, Max, Team, dan Enterprise, dengan Free dibatasi satu custom connector.

Di Free, Pro, atau Max:

1. Buka Customize, lalu Connectors, dan klik Add custom connector.
2. Beri nama `Shager` dan masukkan URL server MCP `https://app.shager.ai/api/mcp`.
3. Untuk Authentication, pilih No sign-in.
4. Buka Request headers, pilih `authorization` dari daftar, dan masukkan nilai `Bearer shgr_live_your_key_here`.
5. Tandai header sebagai Required, lalu klik Add.

Langkah 4 adalah tempat kebanyakan orang tergelincir. Dokumentasinya menyatakan bahwa Claude mengirim nilai persis seperti yang Anda ketik, tanpa menambahkan skema autentikasi atau awalan apa pun. Jika Anda hanya menempelkan kuncinya, Shager menerima `Authorization: shgr_live_...` dan mengembalikan 401. Sertakan kata `Bearer` dan spasinya.

Di Team dan Enterprise, seorang Owner menambahkan connector lewat Organization settings, lalu Connectors, dan anggota tim menghubungkannya dari halaman Customize masing-masing. Hati-hati dengan pola ini untuk Shager. Request header adalah satu kredensial yang dipakai bersama oleh semua orang di organisasi, yang menurut halaman Anthropic cocok untuk "akun layanan", bukan untuk login per orang. Dengan satu kunci Shager bersama, log audit di https://app.shager.ai/dashboard/agents akan mencatat setiap panggilan atas nama kunci tunggal itu. Jika Anda butuh atribusi per orang, minta setiap orang terhubung dengan login, atau gunakan Jalur 2 dengan kunci masing-masing.

Perlu dicatat juga bahwa header tidak bisa diedit belakangan. Untuk mengganti kunci, hapus connector lalu tambahkan lagi.

## Jalur 2: mcp-remote di claude_desktop_config.json

File konfigurasi desktop ditujukan untuk server lokal yang dijalankan Claude Desktop sebagai proses. Artikel bantuan Anthropic tentang [custom connector](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) menggambarkan server lokal itu sebagai "mekanisme terpisah" dari connector remote, dan entri `url` biasa di file itu bukanlah cara Desktop menjangkau server remote.

Solusinya adalah [mcp-remote](https://github.com/geelen/mcp-remote), paket open source yang berjalan secara lokal lewat stdio dan meneruskan request ke server MCP remote, lengkap dengan header kustom. Paket ini memerlukan Node.js.

Buka konfigurasi lewat Settings, lalu Developer, lalu Edit Config. [Quickstart MCP untuk server lokal](https://modelcontextprotocol.io/docs/develop/connect-local-servers) mencantumkan lokasinya: `~/Library/Application Support/Claude/claude_desktop_config.json` di macOS dan `%APPDATA%\Claude\claude_desktop_config.json` di Windows.

```json
{
  "mcpServers": {
    "shager": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.shager.ai/api/mcp",
        "--header",
        "Authorization:${SHAGER_AUTH_HEADER}"
      ],
      "env": {
        "SHAGER_AUTH_HEADER": "Bearer shgr_live_your_key_here"
      }
    }
  }
}
```

Bentuk `Authorization:${SHAGER_AUTH_HEADER}` yang tampak aneh tanpa spasi setelah titik dua itu memang disengaja. README mcp-remote memperingatkan bahwa Claude Desktop di Windows (dan beberapa klien lain) tidak meng-escape spasi di dalam `args`, jadi spasinya dipindahkan ke environment variable. Bentuk ini juga berfungsi di macOS, jadi pakai saja di mana-mana dan tidak perlu dipikirkan lagi.

Jika Anda tidak ingin menyimpan kunci di JSON konfigurasi, mcp-remote juga menerima `--header-file` yang menunjuk ke file berisi satu `Name: value` per baris:

```text
Authorization: Bearer shgr_live_your_key_here
```

Tutup Claude Desktop sepenuhnya, lalu buka kembali. Menurut quickstart, aplikasi harus di-restart agar konfigurasi baru dimuat. Setelah itu buka menu connector dari kolom input chat dan pastikan `shager` muncul beserta tool-nya.

### Jika tidak mau terhubung

Log tersimpan di `~/Library/Logs/Claude` di macOS (`%APPDATA%\Claude\logs` di Windows). `mcp.log` mencatat kegagalan koneksi, dan `mcp-server-shager.log` berisi output mcp-remote sendiri. Jika di sana ada 401, berarti nilai header-nya salah. Pesan `command not found` untuk npx berarti Node tidak ada di PATH yang dilihat Claude Desktop, hal yang umum terjadi jika Node dipasang lewat version manager. Dalam kasus itu, arahkan `command` ke path absolut `npx`.

## Jalur mana yang sebaiknya dipilih?

| | Custom connector dengan request header | mcp-remote di konfigurasi |
|---|---|---|
| Ketersediaan | Beta, organisasi terbatas | Semua instalasi Claude Desktop yang punya Node |
| Siapa yang memegang kunci | Disimpan oleh Claude, tidak ditampilkan lagi | Konfigurasi lokal Anda atau file header |
| Berfungsi di claude.ai lewat browser | Ya, karena ini connector akun | Tidak, hanya desktop |
| Kunci per orang di paket Team | Tidak, satu header bersama | Ya, tiap orang mengatur kuncinya sendiri |
| Mengganti kunci | Hapus lalu tambahkan ulang connector | Edit file, restart |

Bagi kebanyakan orang, login adalah cara yang paling rapi. Di antara jalur dengan kunci, Jalur 1 lebih rapi bagi konsultan yang bekerja sendiri jika tersedia. Bagi agensi dengan lima orang yang memegang akun klien, Jalur 2 dengan kunci masing-masing menjaga jejak audit tetap jujur.

## Prompt pertama untuk membuktikan semuanya berjalan

```text
Using Shager: who am I, which workspaces do I have, and for the workspace
"Harbor Fitness" list the connected channels by network and status.
```

Lalu coba buat draf:

```text
Create a draft post in "Harbor Fitness" to every active Instagram and Facebook
channel. Caption: announce the new 6am class. Write a different caption per
channel using the location in the channel name. cta_url
https://harborfitness.example/6am, campaign "6am-launch". Don't schedule it.
```

Prompt kedua itu memakai `create_post` dengan caption `per_channel` dan `cta_url` yang terlacak, sehingga setiap akun mendapat tautan pendeknya sendiri dengan `utm_content` berisi nama akun. Draf akan muncul di Shager, dan dari situ manusia atau tautan persetujuan klien bisa melanjutkannya. Artikel kami tentang [alur persetujuan klien](/en/blog/client-approval-workflow-for-agencies) menjelaskan bagaimana agensi biasanya menyusun langkah tersebut.

## Batasi scope kuncinya

Chat desktop adalah tempat orang bereksperimen, jadi beri kunci ini `read` dan `write` saja. Tanpa `publish`, Shager menolak `schedule_post` dan setiap `create_post` yang menyertakan `schedule_at`, apa pun yang diketik di chat. Buat kunci terpisah dengan `publish` untuk rutinitas berbasis skrip yang benar-benar mengirim postingan, di https://app.shager.ai/dashboard/agents.

## FAQ

### Bisakah saya langsung menempelkan entri url ke claude_desktop_config.json?

File itu menjalankan server lokal sebagai proses, dan Anthropic mendokumentasikan server remote sebagai mekanisme terpisah lewat connector. Tambahkan Shager sebagai custom connector lalu login, atau gunakan mcp-remote sebagai proses lokal yang meneruskan ke URL remote dengan kunci Anda.

### Apakah saya memerlukan kunci API?

Tidak. Menambahkan https://app.shager.ai/api/mcp sebagai custom connector lalu login adalah jalur paling sederhana, setiap orang terhubung dengan akunnya sendiri, dan jalur header bersifat opsional. Gunakan kunci jika Anda ingin mengelola cakupannya sendiri.

### Apakah pengaturan yang sama berlaku untuk Claude Code?

Claude Code mendukung autentikasi header secara native dengan `claude mcp add --transport http` dan `--header`, jadi tidak perlu trik apa pun. Langkah-langkahnya ada di [menghubungkan Shager ke Claude Code](/en/blog/connect-shager-to-claude-code).

## Langkah berikutnya

Begitu Desktop bisa memanggil Shager, kebiasaan yang berguna adalah berhenti mengetik prompt panjang dan mengemasnya menjadi skill. Jika Anda memakai API alih-alih aplikasi chat, mulailah dengan [quickstart REST API](/en/blog/shager-rest-api-quickstart) dan [dokumen OpenAPI](https://app.shager.ai/api/v1/openapi.json), yang menjelaskan operasi yang persis sama dengan yang disediakan connector.

---
Source: https://shager.ai/id/blog/connect-shager-to-claude-desktop