Claude'a barındırılan MCP sunucusu üzerinden döviz kurlarını aktarın. Bağlantı için API anahtarı gerekmez. Anahtarsız erişim ve Free planı kurları 15 dakika gecikmeli döndürür; ücretli planlar canlı kur alır.
Barındırılan sunucuyu Claude Code'a ekleyin
Barındırılan MCP sunucusunu API anahtarı olmadan eklemek için Claude Code'da aşağıdaki komutu çalıştırın.
Uç nokta, sonundaki eğik çizgiyle birlikte https://api.exchangerate.dev/v1/mcp/ adresidir ve Streamable HTTP kullanır. Araç keşfi ve çağrıları anahtarsız çalışır.
claude mcp add --transport http exchangerate-dev https://api.exchangerate.dev/v1/mcp/Kendi kotanız için anahtar kullanın
Kendi kotanızı ve sınırlarınızı kullanmak için aşağıdaki komutu API anahtarınızla çalıştırın.
Komut Authorization: Bearer YOUR_API_KEY gönderir. Free planında aylık 5.000, dakikalık 10 istek vardır. Her MCP araç çağrısı bir API çağrısı sayılır ve karşılık gelen REST isteğiyle aynı dakikalık sınırı ve aylık kotayı kullanır.
claude mcp add --transport http exchangerate-dev https://api.exchangerate.dev/v1/mcp/ --header "Authorization: Bearer YOUR_API_KEY"Alternatif olarak yerel köprüyü çalıştırın
Claude Code'u yerel npm köprüsü üzerinden bağlamak için aşağıdaki komutu çalıştırın.
Node.js 20 veya üzerini ve API anahtarı kullanın. Komut, çift kısa çizgiden önce -e ile EXCHANGERATE_API_KEY değişkenini ayarlar. Anahtarsız kullanım için ALLOW_ANONYMOUS=true gerekir.
claude mcp add exchangerate-dev -e EXCHANGERATE_API_KEY=YOUR_API_KEY -- npx -y @nusantara-ventures/exchangerate-mcpClaude Desktop'ı yapılandırın
Aşağıdaki yapılandırmayı Claude Desktop'ın yapılandırma dosyasına ekleyin ve YOUR_API_KEY değerini değiştirin.
macOS'ta dosya yolu ~/Library/Application Support/Claude/claude_desktop_config.json şeklindedir. Windows'ta %APPDATA%\Claude\claude_desktop_config.json kullanın.
Claude Desktop terminal ortamınızı okumadığı için EXCHANGERATE_API_KEY değişkenini yapılandırmanın env bloğunda ayarlayın. Kaydedin, Claude Desktop'ı tamamen kapatıp yeniden açın. Sunucular başlangıçta bir kez yüklenir.
{ "mcpServers": { "exchangerate-dev": { "command": "npx", "args": [ "-y", "@nusantara-ventures/exchangerate-mcp" ], "env": { "EXCHANGERATE_API_KEY": "YOUR_API_KEY" } } }}Claude'dan kur isteyin
“Şu anda 100 euro kaç Japon yeni?” diye sorun. Claude, from, to ve amount alanlarını alan convert aracını kullanabilir. Yanıt; kuru, dönüştürülen tutarı ve kurun USD üzerinden türetildiğini belirten bir işareti içerir.
“1 Eylül'de USD/IDR kuru neydi?” sorusu get_range veya get_rate kullanır. Son kur için get_rate, base ve quote alanlarını alır; get_range bir tarih aralığındaki kurları döndürür.
list_currencies için “Hangi para birimlerini sorgulayabilirsin?”, list_official_rate_tables için “Hangi merkez bankaları kur yayımlıyor?” diye sorun.
Claude'un erişimi ve işlemleri
Dokuz araç Claude'a kurlara, para birimi bilgilerine ve belgelere erişim sağlar. Yukarıdakilere ek olarak get_usd_index bağımsız hesaplanan bir USD endeksi döndürür, search_docs belgelerde arama yapar ve get_official_rate devletin yayımladığı kurları döndürür.
Yanıtlarda source, market_session, data_updated_at ve kurların gösterge niteliğinde olduğu, takas veya alım satım için olmadığı bildirimi bulunur. Claude döndürülen zamanı belirtmelidir.
start_checkout, yalnızca onayınızdan sonra plan satın alma ekranını açar. Claude kendi başına satın alma yapmaz.
Sorunları giderin
Claude Desktop araç göstermiyorsa yapılandırma JSON'unu kontrol edin. Sondaki fazladan virgül yaygın bir nedendir.
Geçersiz API anahtarı HTTP 401 döndürür. 429, dakikalık sınıra veya aylık kotaya ulaştığınızı belirtir; yeniden deneme zamanını bekleyin.