Hubungkan agen AI

Reconstruct mengekspos data antarmuka tangkapan melalui server MCP. Pilih agen untuk petunjuk penyiapan:

• Codex
• Claude
• Cursor
• Cline
• GitHub Copilot di VS Code
• Gemini CLI
• MiMo
• Muse Code
• Grok Build
• Hermes Agent
• OpenClaw
• OpenMausBot
• Klien MCP lain

Sebelum memulai

Endpoint MCP Reconstruct adalah https://reconstruct.dev/mcp dan memakai Streamable HTTP. Anda dapat terhubung dengan login browser melalui OAuth atau token akses pribadi.

Metode	Cara kerja	Kapan digunakan
Login browser OAuth	Klien MCP membuka login Reconstruct dalam browser. Masuk dan setujui akses, lalu kembali ke klien. Tidak perlu membuat atau menyalin token dari Platform.	Agen interaktif dan editor dengan dukungan OAuth.
Token akses pribadi	Buat token MCP di pengaturan Platform lalu tambahkan ke kredensial klien.	Klien tanpa dukungan OAuth atau lingkungan otomatis tanpa login browser.

Kedua metode terhubung ke server MCP yang sama dan memakai langganan serta jatah penggunaan akun Reconstruct Anda.

Login OAuth melalui browser

Anda tidak perlu menerbitkan token pribadi di Platform sebelum terhubung melalui OAuth.

1. Tambahkan https://reconstruct.dev/mcp sebagai server HTTP MCP jarak jauh di klien.
2. Pilih OAuth atau login browser. Jika klien meminta pengaturan koneksi, gunakan nilai di bawah.
3. Mulai Sign in, Connect, atau perintah login MCP klien. Tindakan tepatnya bergantung klien.
4. Dalam browser, masuk ke akun Reconstruct dan setujui akses yang diminta. Jika pendaftaran tidak tersedia, hubungi dukungan untuk akses akun.
5. Kembali ke klien dan segarkan alatnya. Minta memanggil list_products untuk memastikan koneksi.

Pengaturan	Nilai
URL server	https://reconstruct.dev/mcp
Transport	Streamable HTTP
ID klien OAuth	reconstruct-mcp untuk klien yang diprakonfigurasi; Claude Desktop mendaftar otomatis
Cakupan	openid aud-mcp
Rahasia klien	Biarkan kosong
Penerbit OAuth	https://reconstruct.dev/sso/realms/reconstruct
Endpoint otorisasi	https://reconstruct.dev/sso/realms/reconstruct/protocol/openid-connect/auth
Endpoint token	https://reconstruct.dev/sso/realms/reconstruct/protocol/openid-connect/token

Klien mendapatkan dan menyimpan kredensial OAuth setelah login serta memakainya untuk panggilan MCP. Anda tidak perlu menyalin token atau menetapkan CR_RECONSTRUCT_MCP_TOKEN untuk metode ini. Hapus header Authorization atau pengaturan token bearer manual saat beralih dari koneksi yang ada ke OAuth.

Lihat contoh OAuth untuk Codex, Claude Code, Cursor, Cline, OpenMausBot, atau klien MCP lain. Gunakan pengaturan callback yang didokumentasikan untuk klien. Jika klien meminta login lagi, ulangi alur login MCP-nya.

Kompatibilitas klien

Contoh login browser mencakup Claude, Cursor, Claude Code, Codex, Grok Build, dan Muse Code dengan alamat callback terdaftar masing-masing. Panduan Gemini CLI, VS Code, MiMo Code, MiMo Desktop, Hermes Agent, dan OpenClaw memakai token akses pribadi; panduan VS Code juga menawarkan pemasangan satu klik dengan pendaftaran klien otomatis. Claude Desktop dan konektor web mendukung pendaftaran klien otomatis dengan callback HTTPS persis yang disetujui. Klien lain yang mendukung penemuan OAuth dan Dynamic Client Registration juga dapat terhubung hanya dengan URL server; mereka mendaftarkan dan menangani callback HTTPS atau loopback persis sendiri. Pengaturan klien publik prakonfigurasi tetap menjadi alternatif bagi klien tanpa DCR.

Endpoint OAuth berasal dari metadata penemuan. Letaknya di bawah realm SSO, bukan /authorize atau /token pada akar situs. Jika klien membuka endpoint akar, muat ulang konfigurasi servernya dan ulangi login untuk menyegarkan cache penemuan.

Untuk konektor cloud Claude, ikuti panduan Claude Desktop. Hubungi dukungan dengan URI callback persis sebelum menghubungkan integrasi cloud lain. Jangan masukkan rahasia klien untuk reconstruct-mcp.

Penemuan agen dan login perangkat

Penemuan publik dimulai di https://reconstruct.dev/mcp/server-card. Akar /.well-known/api-catalog mencantumkan dokumentasi API publik, dan /.well-known/agent-skills/index.json mencantumkan alur kerja Reconstruct beserta arsip yang dapat dipasang. Lihat keterampilan Reconstruct untuk sembilan alur kerja, akses sumber daya MCP tanpa instalasi terpisah, pemasangan dari situs atau CLI GitHub, unduhan manual, dan paket plugin khusus klien. Menghubungkan server MCP jarak jauh tidak memerlukan .NET SDK di komputer pengguna.

Halaman situs dan dokumentasi terbitan menerima Accept: text/markdown. Halaman ruang kerja tetap memerlukan akses akun.

Klien yang menerapkan OAuth Device Authorization dapat membaca https://reconstruct.dev/auth.md dan POST {"type":"anonymous"} ke https://reconstruct.dev/agent/register. Respons berisi otorisasi perangkat tertunda, URL dan kode verifikasi pengguna, kedaluwarsa, interval polling, serta PKCE code_verifier privat. Tampilkan petunjuk verifikasi kepada pengguna. Pengguna harus masuk dan menyetujui akses. Agen lalu memeriksa endpoint token penerbit memakai grant device-code dan code_verifier yang dikembalikan. Patuhi interval polling dan respons slow_down. Pendaftaran sendiri tidak menerbitkan token akses atau membuat akun. Peran, batas langganan, dan persyaratan persetujuan yang ada tetap berlaku.

Jaga kode perangkat, verifier kode, dan token tetap privat. Jangan setujui akses atas nama pengguna. Alur ini tersedia bagi klien yang menerapkannya; tidak menggantikan pengaturan Authorization Code + PKCE editor yang sudah ada.

Token akses pribadi

1. Masuk ke Reconstruct Platform lalu buka Settings → API tokens.
2. Buat token bercakupan MCP (mcp) lalu salin rahasia saat ditampilkan.
3. Konfigurasikan klien agar mengirim Authorization: Bearer <token>. Jika membaca token dari variabel lingkungan, gunakan CR_RECONSTRUCT_MCP_TOKEN.
4. Hubungkan lalu minta klien memanggil list_products.

Simpan token dalam penyimpanan rahasia lokal atau kredensial klien. Jika kedaluwarsa atau dicabut, buat pengganti di pengaturan Platform dan perbarui kredensial klien.

Pilih data tangkapan

Mulai dengan list_products, list_platforms, dan list_versions. Pilih jenis platform serta lingkungan dari list_platforms.options.platforms[] memakai ID yang dikembalikan. list_platforms.platforms[] berisi pasangan dengan data tangkapan aktual. Gunakan kunci view tersimpan persis dari list_pages.views[] untuk alat halaman. Berikan environment secara eksplisit jika versi berisi beberapa lingkungan. Alat konteks memerlukan jatah penggunaan langganan yang tersedia dan mengonsumsi satu pembacaan konteks saat panggilan diterima, termasuk hasil cache. Panggilan yang diterima tetap dihitung meskipun kemudian gagal. Penemuan, alat gambar, dan unduhan aset tidak mengonsumsi pembacaan konteks. Lihat batas penggunaan.

Pemecahan masalah

Gejala	Periksa
401 Unauthorized	Selesaikan login OAuth atau periksa token pribadi; ganti jika kedaluwarsa atau dicabut.
/authorize mengembalikan 404	Segarkan metadata koneksi dan ulangi login; endpoint otorisasi berada di bawah https://reconstruct.dev/sso/realms/reconstruct.
invalid_scope	Minta openid aud-mcp; Grok Build juga dapat meminta cakupan opsional offline_access.
Autentikasi diperlukan setelah login	Segarkan server dan ulangi login OAuth-nya. Hapus kredensial bearer manual yang bertentangan.
Pengalihan OAuth tidak cocok	Gunakan port callback yang didokumentasikan untuk klien. Jika kesalahan berlanjut, hubungi dukungan dengan URI callback yang ditampilkan klien.
Pendaftaran klien dinamis ditolak	Pilih pendaftaran OAuth otomatis lalu coba lagi setelah satu menit. Klien harus memberikan callback HTTPS atau loopback persis dan mendukung PKCE S256. Jika tidak dapat mendaftarkan diri, gunakan pengaturan OAuth prakonfigurasi dalam panduannya.
Server tidak dapat terhubung	Pastikan https://reconstruct.dev/mcp dapat dijangkau dari komputer agen.
Alat mengembalikan akses ditolak	Masuk dengan akun Reconstruct dan periksa langganan. Hubungi dukungan jika akses tetap tidak tersedia.
Kuota atau penggunaan tidak tersedia	Periksa penggunaan di pengaturan akun dan halaman status. Coba lagi saat akses tersedia.
Beberapa lingkungan telah ditangkap	Berikan environment dari list_versions.
Platform/tampilan yang diminta tidak tersedia	Gunakan pasangan platform/lingkungan yang ditangkap serta kunci list_pages.views[] persis; opsi didukung tidak menjamin data tersimpan.
Tidak ada alat yang muncul	Mulai ulang agen atau segarkan daftar alat MCP-nya, lalu periksa status server.

Setelah terhubung, coba contoh prompt atau jelajahi katalog alat MCP.

Minta tangkapan baru atau pembaruan

Server MCP mencakup get_request_options, create_product_request, get_product_request, list_product_requests, dan wait_product_request. Masuk melalui OAuth atau gunakan token akses MCP. Langganan harus mendukung permintaan, dan Anda hanya dapat melihat permintaan yang diajukan dengan akun Anda. Minta agen mengajukan URL produk baru atau memperbarui kunci produk terbitan yang diketahui; lalu minta menyimpan requestId dan menunggu perubahan status peninjauan. Permintaan yang disetujui tidak berarti tangkapan siap. Lihat alat permintaan untuk parameter.