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 Dashboard Etalasse yang aktif (email dan kata sandi)
• 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 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. Anda masuk dengan email dan kata sandi Dashboard Etalasse.
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.

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). 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

Claude Code

Claude Code dapat menggunakan endpoint HTTP MCP yang sama dan menyelesaikan alur OAuth ketika server dikonfigurasi sebagai remote MCP server. Contoh konfigurasi ada di Client Integration.

ChatGPT

Untuk alur ChatGPT app/connector, server ini sudah mengekspos primitive OAuth dan MCP yang dibutuhkan. Anda tetap perlu membuat connector di sisi ChatGPT yang menunjuk ke endpoint MCP Etalasse.

Alternatif: login manual

Tanpa OAuth (misalnya untuk pengujian atau otomasi internal), klien 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).
• Sign-in gagal — pastikan email dan kata sandi Dashboard benar; gunakan akun yang sama dengan yang Anda pakai di Dashboard.
• Tool dashboard menolak permintaan — pastikan sesi OAuth aktif; tool dashboard hanya beroperasi pada toko milik pengguna yang terautentikasi.

Halaman terkait

• Etalasse MCP Server
• Client Integration
• Tool Surface