Server MCPDokumentasi

Kurs mata uang di Claude

Hubungkan Claude Code atau Claude Desktop ke server MCP exchangerate.dev.

24 Oktober 2026 · 2 menit baca

Berikan Claude akses kurs mata uang melalui server MCP yang dihosting tanpa perlu kunci API. Akses tanpa kunci dan paket Free menerima kurs dengan jeda 15 menit; paket berbayar mendapat kurs real-time.

Tambahkan server yang dihosting ke Claude Code

Jalankan perintah berikut di Claude Code untuk menambahkan server MCP yang dihosting tanpa kunci API.

Endpoint-nya adalah https://api.exchangerate.dev/v1/mcp/, dengan garis miring penutup, melalui Streamable HTTP. Penemuan dan pemanggilan tool dapat dilakukan tanpa kunci.

Shell
claude mcp add --transport http exchangerate-dev https://api.exchangerate.dev/v1/mcp/

Gunakan kunci untuk kuota sendiri

Jalankan perintah berikut dengan kunci API Anda untuk menggunakan kuota dan batas sendiri.

Perintah ini mengirim Authorization: Bearer YOUR_API_KEY. Free mencakup 5.000 permintaan per bulan dan 10 permintaan per menit. Setiap pemanggilan tool MCP dihitung sebagai satu panggilan API dengan batas per menit dan kuota bulanan yang sama seperti permintaan REST terkait.

Shell
claude mcp add --transport http exchangerate-dev https://api.exchangerate.dev/v1/mcp/ --header "Authorization: Bearer YOUR_API_KEY"

Hubungkan melalui bridge lokal

Jalankan perintah berikut untuk menghubungkan Claude Code melalui bridge npm lokal.

Gunakan Node.js 20 atau lebih baru dan kunci API. Perintah ini menetapkan EXCHANGERATE_API_KEY dengan -e sebelum tanda hubung ganda. Akses tanpa kunci memerlukan ALLOW_ANONYMOUS=true.

Shell
claude mcp add exchangerate-dev -e EXCHANGERATE_API_KEY=YOUR_API_KEY -- npx -y @nusantara-ventures/exchangerate-mcp

Atur Claude Desktop

Tambahkan konfigurasi berikut ke file konfigurasi Claude Desktop dan ganti YOUR_API_KEY.

Di macOS, file-nya adalah ~/Library/Application Support/Claude/claude_desktop_config.json. Di Windows, gunakan %APPDATA%\Claude\claude_desktop_config.json.

Tetapkan EXCHANGERATE_API_KEY dalam blok env konfigurasi karena Claude Desktop tidak membaca variabel lingkungan terminal. Simpan, tutup Claude Desktop sepenuhnya, lalu buka kembali. Server dimuat sekali saat aplikasi dimulai.

claude_desktop_config.json
{  "mcpServers": {    "exchangerate-dev": {      "command": "npx",      "args": [        "-y",        "@nusantara-ventures/exchangerate-mcp"      ],      "env": {        "EXCHANGERATE_API_KEY": "YOUR_API_KEY"      }    }  }}

Tanyakan kurs kepada Claude

Tanyakan “Berapa yen Jepang untuk 100 euro sekarang?” Claude dapat memakai convert, yang menerima from, to dan amount. Respons mencakup kurs, hasil konversi dan penanda bahwa kurs dihitung melalui USD.

“Berapa kurs USD ke IDR pada 1 September?” memakai get_range atau get_rate. Untuk kurs terbaru, get_rate menerima base dan quote; get_range mengembalikan kurs dalam rentang tanggal.

Tanyakan “Mata uang apa saja yang bisa dicari?” untuk list_currencies, atau “Bank sentral mana yang menerbitkan kurs?” untuk list_official_rate_tables.

Data dan tindakan yang dapat diakses Claude

Sembilan tool memberi Claude akses ke kurs, informasi mata uang dan dokumentasi. Selain tool tadi, get_usd_index mengembalikan indeks USD yang dihitung secara independen, search_docs mencari dokumentasi, dan get_official_rate mengembalikan kurs terbitan pemerintah.

Jawaban menyertakan source, market_session, data_updated_at dan pemberitahuan bahwa kurs bersifat indikatif, bukan untuk penyelesaian transaksi atau perdagangan. Claude sebaiknya menyebutkan waktu yang dikembalikan.

start_checkout membuka pembayaran paket hanya setelah Anda mengonfirmasi. Claude tidak pernah membeli apa pun sendiri.

Jika terjadi masalah

Periksa JSON konfigurasi jika Claude Desktop tidak menampilkan tool. Koma di akhir adalah penyebab umum.

Kunci API yang tidak valid menghasilkan HTTP 401. Kode 429 berarti batas per menit atau kuota bulanan tercapai; tunggu hingga waktu percobaan ulang.

Pertanyaan

Apakah saya perlu kunci API?

Server yang dihosting dapat dipakai tanpa kunci. Pengguna tanpa kunci berbagi kuota dengan batas per IP sebesar 10 permintaan per menit dan 100 per jam. Kursnya memiliki jeda 15 menit.

Apakah paket Free mencakup MCP?

Semua paket mencakup akses MCP, termasuk Free. Kunci Free memberi kuota sendiri sebesar 5.000 permintaan per bulan dan 10 per menit, dengan kurs berjeda 15 menit.

Apakah Claude mendapat kurs real-time?

Paket berbayar mendapat kurs real-time. Akses tanpa kunci dan Free memiliki jeda 15 menit. Claude sebaiknya menyebutkan waktu yang dikembalikan. Kurs tetap bersifat indikatif, bukan untuk penyelesaian transaksi atau perdagangan.

Bisakah bridge lokal dipakai tanpa kunci?

Bridge lokal memerlukan kunci API kecuali Anda menetapkan `ALLOW_ANONYMOUS=true`. Node.js 20 atau lebih baru diperlukan. Server yang dihosting menerima koneksi tanpa kunci langsung melalui Streamable HTTP.

Baca juga

Dapatkan kunci API gratis

Paket Free mencakup 5.000 permintaan per bulan tanpa perlu kartu kredit.

Dapatkan kunci gratis