Hubungkan API Indonesia ke Claude Code, Cursor, dan Codex dengan Satu Baris
Satu perintah memasang MCP server API Indonesia ke semua AI agent di laptop Anda. Atau cukup berikan satu kalimat ke agent, dan agent yang memasangnya.

API Indonesia punya MCP server di https://mcp.apiindonesia.id/mcp dengan 84 tools: wilayah sampai desa, kode pos, libur nasional dan cuti bersama, jadwal sholat, gempa dan cuaca BMKG, kurs, UMP, validasi format NIK/NPWP, halal, BPOM, KBBI, dan lainnya. Dengan MCP, AI agent seperti Claude Code, Cursor, atau Codex bisa memanggil data ini langsung saat Anda bertanya.
Dulu, memasangnya berarti mengedit file config setiap agent satu per satu, dan formatnya berbeda-beda. Sekarang ada dua cara yang lebih singkat.
Cara 1: berikan satu kalimat ke agent
Tempel kalimat ini ke Claude Code, Codex, Cursor, atau agent lain yang bisa menjalankan perintah di terminal:
set up API Indonesia - https://apiindonesia.id/llms.txt
Agent akan membaca llms.txt, meminta API key ke Anda, menjalankan installer, lalu memberi tahu langkah reload untuk agent Anda. Agent tidak bisa membuat API key sendiri, jadi siapkan key-nya (langkah 1 dan 2 di bawah).
Cara 2: jalankan installer sendiri
- Daftar di dashboard.apiindonesia.id/register. Akun baru mendapat bonus 3.000 kredit setelah email terverifikasi, tanpa kartu kredit.
- Buka menu API Keys, buat key baru. Key diawali
aip_live_. - Jalankan di terminal:
curl -fsSL https://apiindonesia.id/install.sh | sh -s -- --key aip_live_xxx
Hasilnya kira-kira seperti ini:
Checking the API key...
Preparing the installer...
✓ Claude Code ~/.claude.json
✓ Codex ~/.codex/config.toml
✓ Cursor ~/.cursor/mcp.json
API Indonesia is connected to 3 agents: 80+ tools for Indonesian public data
Installer hanya memasang ke agent yang ditemukan di komputer Anda. Kalau tidak ada agent sama sekali, installer berhenti dan tidak menulis file apa pun.
Agent yang didukung
Claude Code, Codex, Cursor, VS Code (Copilot agent mode), opencode, Gemini CLI, Windsurf, Zed, Claude Desktop, dan agent lain yang didukung add-mcp, seperti Kiro, Goose, Cline, dan GitHub Copilot CLI.
Claude Desktop hanya membaca server lokal (stdio) dari file config-nya, jadi untuk Claude Desktop installer memasang jembatan mcp-remote yang meneruskan koneksi ke server remote kami.
Langkah terakhir: reload agent
Agent baru memuat MCP server setelah di-reload:
| Agent | Langkah |
|---|---|
| Claude Code | Restart, lalu jalankan /mcp untuk melihat api-indonesia |
| Claude Desktop | Tutup sepenuhnya (Cmd+Q), lalu buka lagi |
| Codex | Mulai sesi baru |
| Cursor | Restart, lalu pastikan api-indonesia aktif di Settings > MCP |
| VS Code | Developer: Reload Window |
Setelah itu, coba tanyakan:
- "Kapan libur nasional berikutnya?"
- "Jadwal sholat hari ini di Kota Pontianak."
- "Gempa terbaru dari BMKG."
- "Daftar kecamatan di Kota Bandung beserta kodenya."
- "Apakah NIK 3171xxxxxxxxxxxx formatnya valid?"
Setiap request yang berhasil memakai 2 kredit (Rp2). Request yang gagal, misalnya karena input salah, tidak dihitung.
Opsi installer
--agent <nama>: hanya pasang ke agent tertentu, bisa diulang. Contoh:--agent claude-code --agent cursor.--project: tulis config di folder proyek saat ini (misalnya.mcp.jsondan.cursor/mcp.json), bukan di config user. File ini berisi API key, jadi installer otomatis menambahkannya ke.gitignorekalau folder tersebut repo git.- Key juga bisa lewat environment variable supaya tidak tercatat di argumen perintah:
curl -fsSL https://apiindonesia.id/install.sh | API_INDONESIA_API_KEY=aip_live_xxx sh
Installer aman dijalankan ulang, misalnya setelah Anda mengganti key. Entri lama ditimpa, tidak dobel, dan MCP server lain di config Anda tidak disentuh.
Apa yang dilakukan installer
Isi skripnya bisa dibaca di apiindonesia.id/install.sh sebelum dijalankan. Urutannya:
- Mengecek API key ke endpoint yang mengembalikan 404, jadi pengecekan ini tidak memotong kredit.
- Mengecek MCP server bisa dihubungi.
- Mendeteksi agent yang terpasang, lalu menulis config untuk setiap agent memakai library add-mcp.
- Membaca ulang setiap file config untuk memastikan server benar-benar tertulis, lalu menampilkan ✓ atau ✗ per agent.
Installer butuh Node.js 18+ dan berjalan di macOS dan Linux.
Windows dan client MCP lain
Untuk Windows, atau client yang menerima config JSON, tambahkan server secara manual:
{
"mcpServers": {
"api-indonesia": {
"url": "https://mcp.apiindonesia.id/mcp",
"headers": { "Authorization": "Bearer aip_live_xxx" }
}
}
}
Daftar lengkap tools dan contoh config per client ada di dokumentasi MCP.
Yang belum didukung
Custom connector di ChatGPT dan claude.ai (versi web) mewajibkan OAuth, dan MCP server API Indonesia saat ini memakai API key. Untuk sementara, gunakan agent di komputer Anda (Claude Code, Codex, Cursor, Claude Desktop) atau panggil REST API langsung di https://use.apiindonesia.id/api/v1/... dengan header x-api-key.
