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

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”. Langkah di bawah sudah 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 di PC kamu — 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 2.0.0 atau lebih baru, dan sedang berjalan. Server hidup selama aplikasinya hidup, tidak lebih.
• Jendela utama ahcut terbuka, untuk tool yang menyunting sesi Creator.
• Klien MCP yang berjalan di PC yang sama — config-nya ada di bagian 4.
• Tidak perlu kunci lisensi dan tidak perlu akun untuk memakai server MCP.

Transport-nya Streamable HTTP; tidak ada mode stdio. Klien yang hanya bisa stdio disambungkan lewat jembatan mcp-remote, contohnya di bagian 4.

2. Nyalakan servernya

Kartunya ada di Settings, di dalam dialog berjudul Tweaks, bernama MCP server. Servernya mati secara default.

1. Nyalakan sakelar “MCP server” (On / Off). 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, isi field “Port” (1024–65535) lalu tekan “Apply”.
3. Baris token 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. Untuk Claude Code, tekan “Copy claude mcp add command” lalu tempel hasilnya di terminal. Itu satu-satunya tombol satu-klik di 2.0.0, dan hanya untuk Claude Code.
5. Untuk klien lain, kartu memberi baris rujukan — “Other clients: URL http://127.0.0.1:47317/mcp with header …” — dan config-nya kamu susun sendiri. Semua bentuknya ada di bagian 4.

Token itu dibuat sekali dan tetap sama, termasuk setelah server dimatikan lalu dinyalakan lagi, dan setelah ahcut atau PC 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, perbarui config di setiap klien — kalau tidak, koneksinya ditolak.

Satu izin lagi di kartu yang sama: checkbox “Allow MCP clients to download media”, mati secara default dan terpisah dari sakelar server. Tanpa centang itu asisten tidak bisa mengunduh dari tautan. Kamu yang mencentangnya, kamu juga yang bisa mencabutnya lagi; asisten tidak bisa memberi izin itu ke dirinya sendiri.

Di bawahnya ada bagian “Extras (optional — the tools work without them)” berisi “Confirm: write to ~/.claude/skills”. Seperti judulnya: tidak ada langkah di panduan ini yang membutuhkannya.

3. Batasnya: hanya dari PC yang sama

Server mendengarkan di 127.0.0.1 dan hanya menerima koneksi dari localhost. Itu ditegakkan di kode, bukan sekadar disebut di dokumentasi. Kalimat aplikasinya sendiri: connector cloud — claude.ai atau ChatGPT versi web — tidak bisa menjangkaunya; pakai klien yang berjalan di mesin yang sama.

Tidak ada akun dan tidak ada server kami di jalur ini. Yang bicara cuma klien dan ahcut, di PC kamu — itu sebabnya setiap config di bagian 4 adalah klien yang berjalan di mesin yang sama.

Batas lengkapnya — ekspor, job Toolkit, path berkas, konfirmasi per panggilan — ada di halaman MCP.

4. Config per klien

Ganti TOKEN dengan token dari kartu Settings — tekan “Show” lalu “Copy” — dan sesuaikan alamatnya kalau kamu mengubah port.

Yang dijamin kartu Settings cuma dua: tombol “Copy claude mcp add command” untuk Claude Code, dan baris “Other clients: URL … with header …”. Bentuk config klien-klien di bawah ada di luar kendali ahcut dan bisa berubah kapan saja mereka berubah; semuanya diverifikasi 16 September 2026. Kalau satu di antaranya tidak lagi cocok, aturan umum di akhir bagian ini yang berlaku.

Claude Desktop

Claude Desktop hanya membaca server stdio dari berkas config, jadi perlu jembatan mcp-remote. Node.js harus terpasang. Berkasnya %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "ahcut": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "http://127.0.0.1:47317/mcp",
        "--transport", "http-only",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": { "AUTH_HEADER": "Bearer TOKEN" }
    }
  }
}

Token lewat env, bukan langsung di --header, karena pada pengecekan di atas argumen yang memuat spasi tidak sampai utuh ke mcp-remote lewat Claude Desktop di Windows; bentuk ${AUTH_HEADER} aman di kedua kasus. Restart Claude Desktop, dan tool ahcut_* muncul di ikon tools.

Claude Code

Tombol “Copy claude mcp add command” di kartu Settings menyalin perintah ini lengkap dengan tokennya. Bentuk manualnya:

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

Cursor

~/.cursor/mcp.json, atau .cursor/mcp.json di dalam proyek:

{
  "mcpServers": {
    "ahcut": {
      "url": "http://127.0.0.1:47317/mcp",
      "headers": { "Authorization": "Bearer TOKEN" }
    }
  }
}

VS Code (Copilot)

.vscode/mcp.json di dalam proyek:

{
  "servers": {
    "ahcut": {
      "type": "http",
      "url": "http://127.0.0.1:47317/mcp",
      "headers": { "Authorization": "Bearer TOKEN" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ahcut": {
      "serverUrl": "http://127.0.0.1:47317/mcp",
      "headers": { "Authorization": "Bearer TOKEN" }
    }
  }
}

Gemini CLI

~/.gemini/settings.json:

{
  "mcpServers": {
    "ahcut": {
      "httpUrl": "http://127.0.0.1:47317/mcp",
      "headers": { "Authorization": "Bearer TOKEN" }
    }
  }
}

Codex CLI (ChatGPT)

Connector ChatGPT versi web dan aplikasinya bekerja dari cloud OpenAI, jadi jalur lokalnya adalah Codex CLI. ~/.codex/config.toml, dengan jembatan yang sama seperti Claude Desktop:

[mcp_servers.ahcut]
command = "npx"
args = ["-y", "mcp-remote", "http://127.0.0.1:47317/mcp", "--transport", "http-only", "--header", "Authorization:${AUTH_HEADER}"]
env = { AUTH_HEADER = "Bearer TOKEN" }

Klien lain

Aturan umumnya: klien yang bicara Streamable HTTP dengan header kustom disambungkan langsung ke alamatnya, dengan header Authorization: Bearer TOKEN. Klien yang hanya bisa stdio disambungkan lewat mcp-remote seperti contoh Claude Desktop.

5. Langkah pertama setelah terhubung

Minta asisten memanggil ahcut_capabilities dulu; dari jawabannya ia tahu tool mana yang boleh ia janjikan di mesinmu. 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 lewat “Copy”.
4. Port di config masih cocok? Setelah mengganti port dan menekan “Apply”, alamat di setiap config harus ikut diperbarui.
5. Klien-nya di PC yang sama? Klien cloud tidak bisa menjangkau server ini (bagian 3).