Lewati ke konten utama

OAuth Setup

Halaman ini menjelaskan cara autentikasi bekerja di Etalasse MCP server dan cara menghubungkan klien MCP dengan sign-in OAuth.

Tujuan​

Dengan OAuth, klien MCP remote — seperti Claude Code, Codex, atau ChatGPT connector — dapat masuk langsung menggunakan akun Dashboard Etalasse. Server kemudian mengenali pengguna dan toko yang terautentikasi secara otomatis, sehingga Anda tidak perlu menyalin atau mengelola access token secara manual dalam pemakaian normal.

Dua lapis autentikasi​

Etalasse MCP memisahkan dua hal:

  • Transport auth — membuktikan bahwa klien MCP boleh mengakses server (OAuth bearer token, atau shared bearer token untuk integrasi server-to-server tertentu).
  • User auth — membuktikan siapa pengguna yang bertindak. Identitas berasal dari login Dashboard Etalasse melalui alur OAuth.

Cakupan toko (shop scope) selalu diturunkan dari pengguna Etalasse yang terautentikasi — tool dashboard tidak menerima identitas toko lain sebagai input bebas.

Prasyarat​

  • akun pemilik toko Etalasse di paket Growth atau lebih tinggi (masuk dengan email, Google, dan 2FA bila aktif)
  • klien MCP yang mendukung remote HTTP MCP server dengan OAuth
  • URL endpoint MCP Etalasse untuk lingkungan Anda

Endpoint discovery​

Klien MCP menemukan konfigurasi OAuth secara otomatis melalui endpoint metadata standar di server MCP:

  • GET /.well-known/oauth-protected-resource
  • GET /.well-known/oauth-authorization-server

Server juga mendukung dynamic client registration, Client ID Metadata Document, serta token revocation, sehingga sebagian besar klien MCP modern dapat terhubung tanpa pendaftaran klien manual.

Alur autentikasi​

  1. Klien MCP membaca metadata protected resource.
  2. Klien membaca metadata authorization server.
  3. Klien membuka halaman otorisasi (/oauth/authorize) di browser.
  4. Browser diarahkan ke halaman Hubungkan aplikasi AI di Dashboard (dashboard.etalasse.com/connect). Jika Anda sudah masuk di Dashboard, cukup ketuk Izinkan; jika belum, masuk seperti biasa (email, Google, 2FA) lalu Anda kembali ke halaman ini. Pakai akun lain untuk memilih akun berbeda. Saat diizinkan, Dashboard membuat token akses bernama aplikasi tersebut (misalnya Claude (connector)).
  5. Server menerbitkan authorization code.
  6. Klien menukar code tersebut dengan token di /oauth/token.
  7. Klien memanggil endpoint MCP (/mcp) menggunakan bearer token yang diterima.
Diagram urutan OAuth: klien MCP membaca metadata, membuka halaman otorisasi di browser, Anda masuk, klien menukar code dengan token, lalu memanggil /mcp dengan bearer tokenKlien MCPBrowser AndaEtalasse MCPGET /.well-known/oauth-protected-resourceGET /.well-known/oauth-authorization-server/oauth/authorizeemail + kata sandi Dashboardauthorization codePOST /oauth/tokenaccess token + refresh tokenPOST /mcp (Authorization: Bearer …)1234567
Langkah 1 sampai 7 di atas secara berurutan. Bagian yang disorot adalah saat Anda masuk di browser; setelah itu klien memakai bearer token untuk /mcp.

Langkah 1 sampai 7 di atas secara berurutan. Bagian yang disorot adalah saat Anda masuk di browser; setelah itu klien memakai bearer token untuk /mcp.

Access token berumur pendek; klien memperbaruinya secara otomatis melalui refresh token (scope offline_access), dan refresh token diganti setiap kali dipakai. Untuk memutus koneksi, cabut tokennya di Pengaturan › Token Akses. Scope utama untuk operasi dashboard adalah etalasse:dashboard.

Menghubungkan klien​

Codex​

Codex mendukung OAuth untuk remote streamable HTTP MCP server. Setelah server ditambahkan ke konfigurasi, jalankan:

codex mcp login etalasse

Langkah lengkapnya ada di Hubungkan aplikasi AI lain.

Claude Code​

Lihat Hubungkan ke Claude untuk Claude (web, desktop, mobile) dan Claude Code.

ChatGPT​

Lihat Hubungkan ke ChatGPT.

Gemini​

Lihat Hubungkan ke Gemini untuk aplikasi Gemini, Gemini Enterprise, dan Gemini CLI.

Cursor, VS Code, dan klien MCP lain​

Lihat Hubungkan aplikasi AI lain.

Alternatif: login manual​

Tanpa OAuth (misalnya untuk pengujian atau otomasi internal), klien yang memakai token akses pribadi atau token bersama dapat memanggil tool auth.dashboard_login, lalu menggunakan accessToken yang dikembalikan pada pemanggilan tool berikutnya. OAuth adalah jalur utama yang direkomendasikan untuk klien pengguna langsung; token manual sebaiknya diperlakukan sebagai fallback.

Kesalahan umum​

  • 401 Unauthorized saat memanggil /mcp — token kedaluwarsa atau belum login. Ulangi alur OAuth di klien Anda (misalnya codex mcp login etalasse).
  • Tombol Izinkan tidak aktif — hanya pemilik toko yang bisa menghubungkan aplikasi, dan toko harus di paket Growth atau lebih tinggi. Jika 2FA aktif, isi kode 2FA dulu.
  • "Permintaan koneksi ini sudah kedaluwarsa" — permintaan berlaku 15 menit. Mulai hubungkan lagi dari aplikasi AI Anda.
  • Tool dashboard menolak permintaan — pastikan sesi OAuth aktif; tool dashboard hanya beroperasi pada toko milik pengguna yang terautentikasi.

Halaman terkait​