---
title: Konektor claude.ai dan ChatGPT
description: Hubungkan aplikasi AI seperti claude.ai dan ChatGPT ke panel via OAuth 2.1: masuk sebagai admin, pilih scope dan durasi, lalu cabut koneksi kapan saja.
url: https://nexcmp.com/id/docs/configure-with-ai/oauth-connectors/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Konektor claude.ai dan ChatGPT {#claude-ai-and-chatgpt-connectors}

> **Di mana letaknya di admin:** System › Settings › API & AI agents (`/agent/keys`), tab **Connected apps**. Layar izin terbuka di `/agent/consent` saat konektor meminta akses (tidak ada di menu).

## Fungsi {#what-it-does}

Aplikasi AI web tidak dapat membaca kunci dari disk Anda. Mereka terhubung menggunakan **OAuth**: Anda menambahkan URL MCP panel, aplikasi mengarahkan Anda ke admin sendiri untuk masuk, Anda memilih apa yang boleh dilakukan aplikasi dan untuk berapa lama, lalu aplikasi menerima token berumur pendek. Tidak ada kunci yang disalin atau ditempel. Anda dapat memutuskan hubungan aplikasi kapan saja.

Gunakan ini untuk konektor kustom claude.ai, konektor mode pengembang ChatGPT, dan klien MCP lain yang mendukung OAuth dengan pendaftaran klien dinamis. Alat baris perintah dapat menggunakan alur yang sama, tetapi [admin API key](https://nexcmp.com/id/docs/configure-with-ai/admin-api-keys/) lebih sederhana bagi mereka.

## Persyaratan {#requirements}

| Item | Persyaratan |
|---|---|
| URL | `https://cloud.example.com/mcp/admin`, dapat diakses dari internet (server vendor terhubung ke sana). |
| Reverse proxy | Jika Anda menempatkan proxy sendiri di depan panel, proxy tersebut harus meneruskan jalur `/mcp/admin`, `/oauth-admin/`, dan `/.well-known/` ke panel. |
| Anda | Masuk ke admin NexCMP **di browser yang sama** yang Anda gunakan untuk layar izin. |
| Klien | Mendukung MCP melalui Streamable HTTP, OAuth 2.1 dengan PKCE (S256), dan pendaftaran klien dinamis. |

## Menghubungkan {#connect}

1. Di aplikasi AI, tambahkan konektor MCP kustom dan tempel `https://cloud.example.com/mcp/admin`. Di claude.ai ini ada di bawah pengaturan konektor (tambahkan konektor kustom); di ChatGPT ada di bawah mode pengembang (tambahkan konektor MCP, autentikasi OAuth).
2. Pilih **Sign in** (atau "Connect") di aplikasi. Browser Anda membuka layar izin admin NexCMP. Jika Anda belum masuk, masuklah terlebih dahulu; layar akan dilanjutkan setelahnya.
3. Baca kartu: "**Example AI app** wants to manage this NexCMP admin" (nama aplikasi yang meminta), beserta alamat tempat Anda akan dikembalikan.
4. Centang cakupan yang ingin diberikan. Cakupan yang diminta oleh aplikasi sudah dicentang sebelumnya; jika tidak ada yang diminta, hanya `admin:read` yang dicentang. Lihat [Scopes](https://nexcmp.com/id/docs/configure-with-ai/admin-api-keys/#scopes).
5. Pilih berapa lama koneksi berlangsung: **7**, **30**, atau **90** hari (default 30).
6. Klik **Allow**. Browser kembali ke aplikasi, yang sekarang sudah terhubung. Klik **Deny** untuk menolak.

![Layar izin yang meminta izin untuk aplikasi AI, dengan kotak centang cakupan, pilihan durasi, serta tombol Allow dan Deny](https://nexcmp.com/id/docs/images/configure-with-ai/oauth-connectors-01-consent.webp)

::: important Pilih cakupan seperti yang Anda lakukan untuk kunci
Berikan set terkecil yang dapat menyelesaikan tugas. Tindakan keuangan, penghapusan, dan keamanan tetap berhenti pada pratinjau dan memerlukan persetujuan Anda, tetapi koneksi dengan `settings:write` masih dapat mengubah branding dan email Anda.
:::

## Kelola dan cabut {#manage-and-revoke}

Buka **System › Settings › API & AI agents › Connected apps**. Tabel mencantumkan setiap aplikasi yang Anda hubungkan: aplikasi, cakupan, waktu terhubung, waktu kedaluwarsa, dan waktu terakhir digunakan.

Untuk memutuskan aplikasi, klik **Revoke** dan konfirmasi. Tokennya langsung berhenti berfungsi; aplikasi harus melalui layar izin lagi untuk menyambungkan kembali.

![Tab Connected apps yang mencantumkan satu aplikasi AI beserta cakupan, masa kedaluwarsa, dan tombol Revoke](https://nexcmp.com/id/docs/images/configure-with-ai/oauth-connectors-02-connected-apps.webp)

## Cara kerja alur {#how-the-flow-works}

| Langkah | Detail |
|---|---|
| Penemuan | Aplikasi membaca `/.well-known/oauth-protected-resource/mcp/admin` lalu `/.well-known/oauth-authorization-server/oauth-admin`. Penerbitnya adalah `https://cloud.example.com/oauth-admin`. |
| Pendaftaran | Aplikasi mendaftarkan dirinya sendiri (`POST /oauth-admin/register`, RFC 7591). Hanya klien publik yang didukung (tanpa rahasia klien). Alamat pengalihan harus berupa `https`, atau `http` di komputer yang sama (loopback). |
| Otorisasi | `GET /oauth-admin/authorize` dengan metode PKCE `S256`. Parameter `resource`, saat dikirim, harus berupa URL `/mcp/admin` panel ini. Permintaan valid selama 10 menit dan terikat pada browser yang memulainya. |
| Persetujuan | Anda memilih cakupan dan durasi (di atas). Kode otorisasi berlaku selama 60 detik dan hanya dapat digunakan sekali. |
| Token | `POST /oauth-admin/token` mengembalikan **access token** (sebuah `ak_o...` key, berlaku selama 1 jam atau hingga koneksi berakhir, mana yang lebih dulu) dan **refresh token** (`akr_...`). Setiap refresh menghasilkan refresh token baru; yang lama berhenti berfungsi. Koneksi berakhir setelah hari yang Anda pilih. |
| Pencabutan | **Revoke** di Connected apps, atau aplikasi memanggil `POST /oauth-admin/revoke` (RFC 7009). |

Access token berperan seperti admin key dengan cakupan yang Anda berikan: aturan cakupan, konfirmasi, batas laju, dan log aktivitas yang sama. Panggilannya akan muncul pada tab **Activity**.

## Verifikasi {#verify}

1. Di dalam aplikasi, tanyakan "run system_health" (atau "what tools do you have?"). Aplikasi akan mencantumkan alat yang diizinkan oleh cakupan Anda ([the tool list](https://nexcmp.com/id/docs/configure-with-ai/mcp-admin/#tools)).
2. Buka **Connected apps**: **Last used** bergerak.
3. Buka **Activity**: panggilan tercantum beserta nama aplikasi dan `mcp`.

## Batas & catatan {#limits-notes}

- Jika aplikasi meminta untuk masuk kembali setelah satu jam, itu normal ketika klien tidak melakukan refresh; sambungkan kembali.
- Refresh token yang digunakan dua kali dianggap dicuri: seluruh koneksi dicabut. Sambungkan kembali dari aplikasi.
- Kode otorisasi yang digunakan dua kali akan ditolak (`invalid_grant`) dan token yang telah diterbitkan darinya dicabut.
- Akses OAuth tidak pernah memberikan lebih dari yang diizinkan aturan cakupan: [what a key can never do](https://nexcmp.com/id/docs/configure-with-ai/admin-api-keys/#what-a-key-can-never-do) juga berlaku untuk aplikasi terhubung.
- Vendor mengubah menu dan dukungan mereka. Jika aplikasi vendor tidak menawarkan konektor kustom pada paket Anda, gunakan [admin API key](https://nexcmp.com/id/docs/configure-with-ai/admin-api-keys/) dengan klien desktop atau baris perintah sebagai gantinya.

## Pemecahan Masalah {#troubleshooting}

| Gejala | Penyebab | Solusi |
|---|---|---|
| Layar persetujuan bertuliskan "Wrong browser" | Permintaan dimulai di browser yang berbeda dari yang Anda gunakan untuk masuk | Mulai koneksi kembali dari aplikasi AI di browser yang sama. |
| Layar persetujuan menyatakan permintaan kedaluwarsa atau hilang | Lebih dari 10 menit telah berlalu, atau tautan dibuka dua kali | Mulai koneksi kembali dari aplikasi AI. |
| Halaman "Unknown client" atau "redirect address does not match" | Pendaftaran aplikasi sudah usang, atau menggunakan alamat pengalihan yang tidak didaftarkan | Hapus konektor di aplikasi lalu tambahkan kembali. |
| `invalid_target` | `resource` yang dikirim bukan URL `/mcp/admin` panel ini | Gunakan URL persis yang ditampilkan pada tab **Connect an AI**. |
| `invalid_request` tentang PKCE | Klien tidak mengirimkan `code_challenge_method=S256` | Gunakan klien yang mendukung OAuth 2.1 dengan PKCE. |
| Aplikasi terhubung tetapi panggilan mengembalikan `insufficient_scope` | Anda tidak mencentang cakupan tersebut | Cabut koneksi dan sambungkan kembali dengan cakupan yang dicentang. |
| Aplikasi tidak dapat menjangkau URL | DNS, TLS, atau reverse proxy memblokir `/mcp/admin`, `/oauth-admin/`, atau `/.well-known/` | Periksa aturan proxy. |