← Blog
Artikel

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

  1. Daftar di dashboard.apiindonesia.id/register. Akun baru mendapat bonus 3.000 kredit setelah email terverifikasi, tanpa kartu kredit.
  2. Buka menu API Keys, buat key baru. Key diawali aip_live_.
  3. 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.json dan .cursor/mcp.json), bukan di config user. File ini berisi API key, jadi installer otomatis menambahkannya ke .gitignore kalau 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:

  1. Mengecek API key ke endpoint yang mengembalikan 404, jadi pengecekan ini tidak memotong kredit.
  2. Mengecek MCP server bisa dihubungi.
  3. Mendeteksi agent yang terpasang, lalu menulis config untuk setiap agent memakai library add-mcp.
  4. 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.

Mulai Sekarang

Mulai Integrasi
Hari Ini

Daftar gratis dan dapatkan bonus 3.000 kredit (Rp3.000) setelah email diverifikasi, ambil API key, lalu langsung call endpoint pertama Anda. Tanpa kartu kredit, tanpa proses approval yang ribet.

Visualisasi gelombang titik