Hubungkan ahcut ke asisten AI lewat MCP — Claude, Cursor, Codex, dan lainnya

Catatan redaksi, 4 Oktober 2026. Bagian 2 sampai 5 ditulis ulang untuk rilis ahcut yang menyatukan server MCP dan relay di satu halaman Settings, “AI & MCP”: kelompok “On this computer” untuk server lokal, “On the web” untuk relay, dan “Permissions” untuk izin unduh media, yang berlaku untuk keduanya. Kunci untuk klien yang tidak bisa masuk bernama “Relay keys”, tombol “Add to Claude” membuka claude.ai dengan alamat relay sudah terisi, dan kelompok klien pertama di bagian 4 bernama “Claude and Codex”. Rilis itu juga membawa relay dan render explainer ke ahcut di Mac, termasuk explainer yang ditulis asisten di web, jadi dua catatan Mac dari 3 Oktober tidak berlaku lagi. Di rilis itu pula komputer yang sedang tersambung saat dicabut dari relay mematikan relay-nya sendiri dan tetap mati sampai dinyalakan lagi; versi sebelumnya panduan ini menulis bahwa komputer yang dicabut tersambung lagi sendiri (bagian 3).

Catatan redaksi, 3 Oktober 2026. Bagian 2 dan 3 kini mengikuti Settings di ahcut versi terbaru, yang menggantikan dialog Tweaks dengan satu dialog berhalaman. Kartu “MCP server” ada di halaman “AI & MCP”, dengan port, token, dan skill di bagian “Advanced”; izin unduh media kini berupa sakelar “Allow media downloads”; kunci Pexels pindah ke halaman “API keys”; dan “Cloud relay” punya halaman sendiri. Bagian 3 dan 5 kini juga mencatat dua hal di Mac: build Mac 2.30.1 belum membawa relay, dan render explainer hanya jalan di ahcut untuk Windows.

Catatan redaksi, 25 September 2026. Panduan ini ditulis ulang untuk ahcut versi terbaru. Bagian 2 dan 4 kini mengikuti kartu Settings yang baru: pemilih “Connect a client” menggantikan tombol “Copy claude mcp add command” dan baris “Other clients”, dan skill motion-explainer dipasang sendiri tanpa tombol. Bagian 3 menjelaskan relay untuk klien cloud. Versi sebelumnya menulis bahwa lewat relay hanya tool baca yang terbuka, dengan mengedit, mengekspor, berkas, proyek explainer, dan unduhan ditahan. Sekarang klien cloud menjangkau semua tool kecuali satu, pekerjaan tertentu menunggu persetujuanmu di PC, dan bagian 3 memuat langkah menyambungkan claude.ai.

Catatan redaksi, 16 September 2026. Versi awal panduan ini menulis bahwa token berganti setiap server dimatikan lalu dinyalakan lagi. Itu keliru — dan catatan rilis 2.0.0 keliru di titik yang sama. Token dibuat sekali dan bertahan; yang menerbitkan token baru cuma tombol “Regenerate”. Saat itu langkahnya disesuaikan dengan kartu Settings di 2.0.0.

1. Sebelum mulai

Sejak versi 2.0.0, ahcut menjalankan server MCP (Model Context Protocol) sendiri. Arahnya satu: ahcut membuka dirinya untuk asisten AI — membuat suara, mentranskrip, menyunting sesi Creator, ekspor, sampai merender explainer. ahcut tidak memakai server MCP milik orang lain.

Daftar tool dan apa saja yang bisa dilakukan lewat MCP ada di halaman MCP. Panduan ini bagian langkahnya.

Yang perlu disiapkan:

• ahcut versi terbaru, dan sedang berjalan. Server hidup selama aplikasinya hidup, tidak lebih. Langkah di bawah mengikuti kartu Settings versi terbaru; versi yang lebih lama menampilkan kartu yang berbeda.
• Jendela utama ahcut terbuka, untuk tool yang menyunting sesi Creator.
• Klien MCP yang berjalan di komputer yang sama — config-nya diambil dari kartu Settings (bagian 2 dan 4). Klien cloud seperti claude.ai tersambung lewat relay, di bagian 3.
• Tidak perlu kunci lisensi dan tidak perlu akun untuk memakai server MCP dari klien di komputermu sendiri. Relay untuk klien cloud butuh akun ahcut.

Transport-nya Streamable HTTP; tidak ada mode stdio. Klien yang hanya bisa stdio disambungkan lewat jembatan mcp-remote, yang config-nya juga disiapkan kartu Settings (bagian 4).

2. Nyalakan servernya

Kartunya ada di Settings, di halaman AI & MCP, kelompok On this computer; sakelarnya bernama MCP server. Servernya mati secara default.

1. Nyalakan sakelar “MCP server”. Selama hidup, kartu menampilkan baris “Listening on http://127.0.0.1:47317/mcp” — alamat itu yang dipakai klien.
2. Port 47317 adalah default. Kalau kamu perlu port lain, buka bagian “Advanced”, isi field “Port” (1024–65535), lalu tekan “Apply”.
3. Baris “Token”, juga di bagian “Advanced”, punya tiga kontrol: “Show” / “Hide” untuk menampilkannya, “Copy” untuk menyalin, “Regenerate” untuk menerbitkan token baru. Token dikirim klien sebagai header Authorization: Bearer <token>; perlakukan seperti kata sandi dan jangan bagikan.
4. Di “Connect a client”, pilih klienmu dari daftar. Di bawahnya kartu menulis ke mana teksnya harus ditaruh — berkas yang diisi dan cara menggabungkannya kalau berkas itu sudah berisi, atau “Run in a terminal.” untuk perintah — lalu menampilkan pratinjaunya. Tekan “Copy command” atau “Copy config”. Selama token belum ditampilkan, pratinjau menyamarkannya, tapi yang tersalin selalu teks lengkap dengan alamat dan tokenmu. Daftar kliennya ada di bagian 4.

Token itu dibuat sekali dan tetap sama, termasuk setelah server dimatikan lalu dinyalakan lagi, dan setelah ahcut atau komputer di-restart. Satu-satunya yang menerbitkan token baru adalah tombol “Regenerate”. Dua hal membuat config yang sudah kamu tempel jadi usang: menekan “Regenerate” (tokennya berganti) dan mengganti port (alamatnya berganti). Sesudah salah satunya, salin ulang teks dari “Connect a client” ke setiap klien — kalau tidak, koneksinya ditolak.

Satu izin lagi ada di kelompok Permissions di halaman yang sama: sakelar “Allow media downloads”, mati secara default dan terpisah dari sakelar server. Izin itu berlaku untuk klien di komputermu maupun klien lewat relay (bagian 3). Selama sakelar itu mati, asisten tidak bisa mengunduh dari tautan, baik tautan halaman maupun tautan langsung ke berkas. Kamu yang menyalakannya, kamu juga yang bisa mematikannya lagi; asisten tidak bisa memberi izin itu ke dirinya sendiri.

Baris “Pexels” di halaman “API keys” opsional. Dengan kunci API Pexels milikmu, pencarian footage lewat ahcut_footage_search juga mencakup Pexels; kuncinya diperiksa ke Pexels, lalu disimpan di credential store komputermu.

Bagian “Advanced” juga menyebut ke folder mana ahcut memasang skill motion-explainer. Selama server menyala, ahcut memasang dan memperbaruinya sendiri di folder skill Claude Code dan agent lain yang ada di komputermu, supaya agent itu memulai alur explainer tanpa diajari. Tidak ada tombol pasang: berkas yang kamu ubah tidak pernah ditimpa, dan mematikan server tidak menghapus apa pun.

3. Dua jalur: klien lokal langsung, klien cloud lewat relay

Server mendengarkan di 127.0.0.1 dan hanya menerima koneksi dari localhost. Itu ditegakkan di kode, bukan sekadar disebut di dokumentasi, dan tidak ada port yang dibuka di komputermu. Untuk klien yang berjalan di mesin yang sama — semua config di bagian 4 — tidak ada akun dan tidak ada server kami di jalurnya: yang bicara cuma klien dan ahcut, di komputermu.

Connector cloud seperti claude.ai atau ChatGPT di web bekerja dari server mereka, jadi mereka tidak pernah menyentuh alamat localhost itu. Untuk mereka ada jalur kedua yang membalik arahnya: kalau kamu menyalakannya, ahcut yang menelepon keluar ke relay kami di https://mcp.ahcut.com/mcp, dan panggilan dari klien cloud lewat sambungan itu — tetap tanpa port yang dibuka di komputermu. Syaratnya semua di tanganmu: akun ahcut, sakelar “Cloud relay” yang mati secara default, dan aplikasinya harus sedang berjalan. Lewat relay, klien cloud menjangkau semua tool kecuali ahcut_explainer_open, yang membuka jendela pratinjau di desktopmu.

Kalau halaman AI & MCP di ahcut-mu belum punya kelompok On the web, berarti ahcut-mu masih versi lama: perbarui dulu lewat Check for updates… di menu logo ahcut (di versi yang lebih lama lagi, di menu File).

Menyambungkan claude.ai

1. Di ahcut, buka Settings, halaman AI & MCP, lalu kelompok On the web. Kalau aplikasinya belum masuk ke akun ahcut, baris “Account” di sana menulis “Sign in to your AhCut account to use the relay”; tekan “Sign in…” di sebelahnya dan selesaikan masuknya di browser dengan akun Google-mu. Akun ahcut biasa sudah cukup, tanpa kunci lisensi. Setelah itu nyalakan sakelar “Cloud relay”. Baris “Relay address” di kelompok yang sama menampilkan alamat relay, dengan tombol “Copy”.
2. Tekan “Add to Claude” di baris “Connect a client” kelompok itu; tombolnya aktif setelah relay menyala. claude.ai terbuka dengan connector kustom bernama “AhCut” dan URL https://mcp.ahcut.com/mcp sudah terisi, tinggal kamu konfirmasi di sana. Kamu juga bisa menambahkan connector kustom sendiri dengan URL itu; letak menunya ditentukan claude.ai dan bisa berubah.
3. claude.ai membuka alur izin ahcut di browser, dan langkah pertamanya memilih akun Google. Pilih akun yang sama dengan akun ahcut di aplikasimu: relay hanya menyambungkan klien ke komputer milik akun yang menyetujuinya.
4. Halaman persetujuan ahcut di api.ahcut.com — berbahasa Inggris — menampilkan nama klien dengan label verified atau unverified, akunmu, dan alamat yang disambungkan, https://mcp.ahcut.com/mcp. Di bawahnya ada dua daftar: yang bisa dilakukan klien itu — memakai tool ahcut di komputermu, dengan pekerjaan seperti menyunting sesi, mengekspor, atau mengunduh tautan menunggu jawabanmu di jendela kecil ahcut — dan yang tidak bisa, misalnya melihat path di komputermu atau project explainer milikmu. Periksa, lalu tekan “Allow”; “Deny” membatalkan.
5. Kamu kembali ke claude.ai dengan connector yang sudah tersambung. Langkah berikutnya ada di bagian 5.

Klien cloud lain yang bisa tersambung ke server MCP jarak jauh lewat OAuth disambungkan dengan cara yang sama: URL-nya https://mcp.ahcut.com/mcp, lalu setujui di halaman yang sama. Klien yang tidak bisa memakai halaman persetujuan, misalnya agent terminal di komputer lain, memakai kunci relay: buat di bagian “Relay keys” kelompok “On the web”, atau sebagai kunci API di halaman Koneksi AI, lalu kirim sebagai header Authorization: Bearer … ke alamat yang sama. Kuncinya hanya ditampilkan sekali.

Pekerjaan tertentu — daftarnya di halaman MCP — menunggu jawabanmu dulu. Permintaannya muncul di jendela kecil ahcut di komputermu dengan tombol “Allow once” dan “Deny”; sebagian permintaan juga menawarkan izin 24 jam bagi klien itu untuk satu jenis pekerjaan, misalnya “Allow exports for 24 h”. Permintaan yang tidak dijawab kedaluwarsa setelah 120 detik, dan tautan selalu ditanyakan satu per satu.

Untuk mencabut akses, buka halaman Koneksi AI di dashboard: klien yang terhubung, kunci API, dan komputer yang tersambung ke relay bisa dicabut satu per satu atau sekaligus. “Keluar dari semua perangkat” (halaman Akun, bagian Keamanan) juga mencabut semua koneksi AI, dan izin 24 jam dicabut di bagian “Standing approvals” kelompok “On the web”.

Mencabut komputer bukan blokir. Selama ahcut di komputer itu masih masuk ke akunmu, ia bisa tersambung lagi: kalau sedang tersambung saat dicabut, ahcut di sana mematikan relay-nya sendiri dan baru tersambung lagi kalau sakelar “Cloud relay” dinyalakan; kalau saat itu tidak tersambung — ahcut-nya tertutup, komputernya tidur, atau jaringannya putus — ia tersambung lagi sendiri begitu bisa. Untuk menghentikannya, matikan “Cloud relay” di komputer itu, atau tekan “Sign out” di baris “Account” kelompok “On the web”: ahcut keluar dari akunmu, relay-nya mati, dan komputer itu dicabut dari relay; di daftar Koneksi AI ia tetap tercantum dengan label Dicabut. Kalau komputernya tidak di tanganmu, pakai “Keluar dari semua perangkat”, lalu cabut komputer itu sekali lagi kalau masih muncul. Isi panggilan tidak pernah kami simpan — rinciannya di /privasi.

Batas lengkapnya — ekspor, job Toolkit, path berkas, konfirmasi per panggilan, dan apa saja yang lewat relay — ada di halaman MCP.

4. Config per klien

Teks siap tempel untuk tiap klien dibuat kartu Settings sendiri, di “Connect a client”, lengkap dengan alamat dan tokenmu, jadi kamu tidak perlu menyusunnya. Daftarnya dikelompokkan seperti di kartu:

• Claude and Codex: Claude Code, Claude Desktop, Codex CLI (ChatGPT).
• IDE and terminal agents: Amp, Cline, Continue, Cursor, Devin Desktop (Cascade), Devin Desktop (Devin Local), Factory Droid, Gemini CLI, GitHub Copilot CLI, Goose, Grok Build, Junie, Kilo Code, Kimi Code CLI, Kiro, Mistral Vibe Code, OpenCode, Qwen Code, VS Code (Copilot), Warp, Zed.
• Desktop chat apps: AnythingLLM, Cherry Studio, Jan, LM Studio.
• Other clients: Any stdio-only client (mcp-remote).

claude.ai dan ChatGPT di web tidak ada di daftar ini: keduanya bekerja dari cloud dan tersambung lewat relay (bagian 3).

Untuk Claude Code, teksnya satu perintah terminal. Bentuknya, dengan TOKEN diganti token dari kartu:

claude mcp add --transport http ahcut http://127.0.0.1:47317/mcp --header "Authorization: Bearer TOKEN"

Klien lain ditempel ke berkas config-nya; kartu menyebut berkas itu dan cara menggabungkannya kalau berkas itu sudah berisi server lain. Claude Desktop dan klien yang hanya bisa stdio memakai jembatan mcp-remote, yang butuh Node.js.

Bentuk config tiap klien ditentukan kliennya sendiri dan bisa berubah. Kalau satu klien tidak lagi menerima teks dari kartu, aturan umumnya: klien yang bicara Streamable HTTP dengan header kustom disambungkan langsung ke alamatnya dengan header Authorization: Bearer TOKEN, dan klien yang hanya bisa stdio lewat mcp-remote.

5. Langkah pertama setelah terhubung

Minta asisten memanggil ahcut_capabilities dulu; dari jawabannya ia tahu tool mana yang boleh ia janjikan di komputermu. Contohnya suara: jawabannya hanya menyebut mesin suara yang bisa jalan di komputer itu. Mesin suara offline hanya jalan di ahcut untuk Windows, jadi di Mac jawabannya hanya menyebut ElevenLabs, itu pun kalau kunci API-nya sudah kamu pasang. Isi jawaban itu dan apa saja yang bisa dikerjakan sesudahnya ada di halaman MCP.

Kalau koneksi ditolak, periksa berurutan:

1. ahcut sedang berjalan? Server hidup hanya selama aplikasinya hidup.
2. Sakelar “MCP server” menyala? Kalau ya, kartu menampilkan baris “Listening on …”.
3. Token di config masih yang sekarang? Pernah menekan “Regenerate” berarti config lama tidak berlaku lagi — salin ulang teksnya dari “Connect a client”.
4. Port di config masih cocok? Setelah mengganti port dan menekan “Apply”, alamat di setiap config harus ikut diperbarui.
5. Klien-nya di komputer yang sama? Config di bagian 4 semuanya untuk klien lokal. Klien cloud tidak memakai alamat localhost itu sama sekali — ia lewat relay (bagian 3). Untuk klien cloud, ahcut harus berjalan dengan sakelar “Cloud relay” menyala — barisnya menulis “Connected” saat sambungan keluarnya hidup — dan aplikasinya masuk ke akun yang sama dengan yang menyetujui klien itu. Kalau barisnya menulis “Not connected”, sakelarnya menyala tapi relay tidak berjalan: masuk dulu lewat “Sign in…” kalau aplikasinya belum masuk, atau matikan lalu nyalakan lagi “Cloud relay”. Kalau barisnya menulis “Taken over by another computer”, akunmu sedang tersambung lewat komputer lain: satu akun tersambung lewat satu komputer pada satu waktu, dan yang terakhir tersambung yang dipakai. Untuk memakainya lagi di komputer ini, matikan lalu nyalakan lagi “Cloud relay” di sini.