MCP sunucusuBelgeler

Claude'da döviz kurları

Claude Code veya Claude Desktop'ı exchangerate.dev MCP sunucusuna bağlayın.

24 Ekim 2026 · 2 dk okuma

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.

Shell
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.

Shell
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.

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

Claude 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.

claude_desktop_config.json
{  "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.

Sorular

API anahtarı gerekiyor mu?

Barındırılan sunucu anahtarsız çalışır. Anahtarsız istemciler, IP başına dakikada 10, saatte 100 istekle sınırlı ortak havuzu kullanır. Kurları 15 dakika gecikmelidir.

Free planına MCP dahil mi?

Free dahil her planda MCP erişimi vardır. Free anahtarı, aylık 5.000 ve dakikalık 10 istekten oluşan kendi kotanızı sağlar. Kurlar 15 dakika gecikmelidir.

Claude canlı kur alır mı?

Ücretli planlar canlı kur alır. Anahtarsız erişim ve Free planında 15 dakika gecikme vardır. Claude döndürülen zaman damgasını belirtmelidir. Kurlar gösterge niteliğindedir; takas veya alım satım için değildir.

Yerel köprüyü anahtarsız kullanabilir miyim?

Yerel köprü, `ALLOW_ANONYMOUS=true` ayarlanmadıkça API anahtarı gerektirir. Node.js 20 veya üzeri gerekir. Barındırılan sunucu, Streamable HTTP üzerinden doğrudan anahtarsız bağlantı kabul eder.

Okumaya devam et

Ücretsiz API anahtarı alın

Free planında aylık 5.000 istek vardır ve kredi kartı gerekmez.

Ücretsiz anahtar alın