Lewati ke konten utama

Hubungkan klien MCP lain

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.

Tambahkan 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​

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​

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​

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​

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.

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 dengan URI callback yang ditampilkan klien.

Token akses pribadi​

Jika klien tidak mendukung OAuth, buat token MCP 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​

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. Setelah terhubung, coba contoh prompt.