# Hubungkan klien MCP lain {/* #connect-another-mcp-client */}

Langkah ini berlaku untuk agen AI atau editor yang mendukung server MCP jarak jauh tetapi tidak memiliki panduan khusus di sini. Pilih dahulu OAuth atau token pribadi seperti dijelaskan dalam [sebelum memulai](/docs/id/connect-ai-agents#before-you-start).

## Tambahkan server {/* #add-the-server */}

1. Buka pengaturan server MCP klien dan tambahkan server bernama `reconstruct`.
2. Pilih **Streamable HTTP** (kadang berlabel **HTTP** atau **remote HTTP**).
3. Tetapkan URL server ke `https://reconstruct.dev/mcp`.

## Login OAuth melalui browser {/* #oauth-browser-sign-in */}

Jika klien mendukung penemuan OAuth dan Dynamic Client Registration (DCR), tambahkan hanya `https://reconstruct.dev/mcp`, pilih OAuth, lalu hubungkan. Klien mendaftarkan callback sendiri, membuka login Reconstruct, dan menerima callback otomatis setelah Anda menyetujui akses. Anda tidak perlu memasukkan Client ID atau port callback manual.

Aplikasi terkelola dapat mendaftarkan callback HTTPS persis pada domain publik, seperti `https://app.example.com/mcp/callback`. Aplikasi native dapat mendaftarkan callback HTTP persis pada `127.0.0.1` atau `localhost` dengan port eksplisit. Callback dimiliki dan ditangani oleh klien, bukan server MCP. Pendaftaran memerlukan PKCE `S256`, persetujuan pengguna, dan cakupan khusus MCP. Wildcard, alamat HTTP non-loopback, fragmen, dan URL kunci jarak jauh ditolak.

### Klien tanpa pendaftaran otomatis {/* #clients-without-automatic-registration */}

Gunakan klien publik praterdaftar jika aplikasi tidak dapat mendaftarkan dirinya:

1. Tetapkan ID klien `reconstruct-mcp`, cakupan `openid aud-mcp`, dan biarkan rahasia klien kosong.
2. Tetapkan port callback OAuth lokal ke `58234` dan jalur ke `/callback`.
3. Simpan dan hubungkan, selesaikan login browser, setujui akses, lalu kembali ke klien.

### Callback lokal untuk klien khusus {/* #local-callback-for-custom-clients */}

Konfigurasikan klien agar mendengarkan pada port `58234` di komputer Anda sendiri dan memakai salah satu URI pengalihan persis berikut:

- `http://127.0.0.1:58234/callback`
- `http://localhost:58234/callback`

Klien harus mendukung Authorization Code dengan PKCE (`S256`). Gunakan ID klien `reconstruct-mcp`, cakupan `openid aud-mcp`, tanpa rahasia klien. URI pengalihan yang dikirim saat login dan pertukaran token harus sama persis dengan URI yang dikonfigurasi.

Port `58234` hanya untuk callback browser lokal. URL server MCP jarak jauh tetap `https://reconstruct.dev/mcp` melalui HTTPS. Ikat listener callback ke antarmuka loopback; jangan paparkan port ini ke jaringan. Hanya satu alur login dapat mendengarkan di port ini pada satu waktu; selesaikan login yang ada sebelum memulai yang lain.

### Kembali otomatis ke klien {/* #automatic-return-to-the-client */}

Klien MCP harus memulai listener callback lokal sebelum membuka browser. Setelah login dan persetujuan, Keycloak mengalihkan browser ke listener itu; klien menerima respons otorisasi, menukar kode memakai PKCE, lalu melanjutkan koneksi MCP. Pengguna tidak semestinya perlu menyalin URL callback atau kode otorisasi secara manual.

Muse Code, Grok Build, Codex, dan Claude Code dapat memakai port bersama seperti di panduannya. Klien dengan callback tetap sendiri, seperti Cursor atau Claude Desktop, mempertahankan alamat callback yang didukung.

Untuk aplikasi C# khusus, konfigurasikan `ClientOAuthOptions.RedirectUri` dan implementasikan `AuthorizationCallbackHandler` untuk membuka browser dan menangkap `code`, `state`, serta `iss`. Menetapkan URI pengalihan saja tidak membuat listener; penangan default SDK meminta URL pengalihan secara manual. Lihat [opsi OAuth SDK C# resmi](https://github.com/modelcontextprotocol/csharp-sdk/blob/main/src/ModelContextProtocol.Core/Authentication/ClientOAuthOptions.cs).

Penerbit adalah `https://reconstruct.dev/sso/realms/reconstruct`; gunakan endpoint otorisasi dan token yang ditemukan, bukan menyusun URL akar `/authorize` dan `/token`.

Hapus header `Authorization` yang diatur manual saat memilih OAuth. Jika login melaporkan kesalahan callback, [hubungi dukungan](https://reconstruct.dev/support) dengan URI callback yang ditampilkan klien.

## Token akses pribadi {/* #personal-access-token */}

Jika klien tidak mendukung OAuth, [buat token MCP](/docs/id/connect-ai-agents#personal-access-token) di pengaturan Platform dan tetapkan header HTTP `Authorization` ke `Bearer <your MCP token>`. Gunakan penyimpanan rahasia klien atau variabel lingkungan `CR_RECONSTRUCT_MCP_TOKEN` jika didukung.

## Periksa koneksi {/* #check-the-connection */}

Hubungkan ulang atau mulai ulang klien. Pastikan `list_products` muncul di daftar alat, lalu minta agen memanggilnya.

Tidak ada satu format JSON yang sama untuk semua klien. Sebagian memakai `mcpServers`, yang lain `servers` atau `mcp`; sebagian memerlukan kolom `type`. Ikuti dokumentasi klien untuk nama kolom dan sintaks interpolasi token yang tepat. Klien yang hanya mendukung transport SSE lama tidak dapat memakai endpoint HTTP `/mcp` Reconstruct sebagai SSE.

Jika koneksi gagal, periksa [tabel pemecahan masalah](/docs/id/connect-ai-agents#troubleshooting). Setelah terhubung, coba [contoh prompt](/docs/id/prompt-examples).