# Hubungkan agen AI {/* #connect-an-ai-agent */}

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

- [Codex](/docs/id/agents/codex)
- [Claude](/docs/id/agents/claude)
- [Cursor](/docs/id/agents/cursor)
- [Cline](/docs/id/agents/cline)
- [GitHub Copilot di VS Code](/docs/id/agents/vscode-copilot)
- [Gemini CLI](/docs/id/agents/gemini-cli)
- [MiMo](/docs/id/agents/mimo)
- [Muse Code](/docs/id/agents/muse-code)
- [Grok Build](/docs/id/agents/grok-build)
- [Hermes Agent](/docs/id/agents/hermes)
- [OpenClaw](/docs/id/agents/openclaw)
- [OpenMausBot](/docs/id/agents/openmausbot)
- [Klien MCP lain](/docs/id/agents/other-mcp-clients)

## Sebelum memulai {/* #before-you-start */}

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 {/* #oauth-browser-sign-in */}

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](/docs/id/agents/codex#oauth-browser-sign-in), [Claude Code](/docs/id/agents/claude-code#oauth-browser-sign-in), [Cursor](/docs/id/agents/cursor#oauth-browser-sign-in), [Cline](/docs/id/agents/cline#oauth-browser-sign-in), [OpenMausBot](/docs/id/agents/openmausbot#oauth-browser-sign-in), atau [klien MCP lain](/docs/id/agents/other-mcp-clients#oauth-browser-sign-in). Gunakan pengaturan callback yang didokumentasikan untuk klien. Jika klien meminta login lagi, ulangi alur login MCP-nya.

### Kompatibilitas klien {/* #client-compatibility */}

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](/docs/id/agents/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 {/* #agent-discovery-and-device-sign-in */}

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](/docs/id/skills) 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 {/* #personal-access-token */}

1. Masuk ke [Reconstruct Platform](https://reconstruct.dev/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 {/* #select-captured-data */}

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](/docs/id/mcp-tools#usage-limits).

## Pemecahan masalah {/* #troubleshooting */}

| 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](/docs/id/prompt-examples) atau jelajahi [katalog alat MCP](/docs/id/mcp-tools).

### Minta tangkapan baru atau pembaruan {/* #request-a-new-capture-or-update */}

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](/docs/id/mcp-tools#product-requests) untuk parameter.