Asistanın döviz kurlarını sorgulaması ve tutarları dönüştürmesi için exchangerate.dev MCP sunucusunu Cursor'a ekleyin. Barındırılan sunucu anahtarsız çalışır; kurlar 15 dakika gecikmelidir. Ücretli planlar aynı uç noktadan canlı kur alır.
Barındırılan sunucuyu ekleyin
Aşağıdaki yapılandırmayı tüm projeler için ~/.cursor/mcp.json dosyasına veya tek proje için proje kökündeki .cursor/mcp.json dosyasına kaydedin.
Kayıt, mcpServers altında yer alır ve url ile Streamable HTTP üzerinden https://api.exchangerate.dev/v1/mcp/ adresine bağlanır. Sondaki eğik çizgiyi koruyun. API anahtarı gerekmez. Dosyayı kaydedip Cursor'ın MCP ayarlarını yeniden yüklediğinizde veya Cursor'ı yeniden başlattığınızda sunucu MCP araçları arasında görünür.
{ "mcpServers": { "exchangerate-dev": { "url": "https://api.exchangerate.dev/v1/mcp/" } }}Kendi kotanızı kullanın
Aşağıdaki yapılandırmada YOUR_API_KEY yerine API anahtarınızı yazın, dosyayı kaydedin ve Cursor'ın MCP ayarlarını yeniden yükleyin veya Cursor'ı yeniden başlatın.
Yapılandırma, headers üzerinden Authorization: Bearer YOUR_API_KEY ekler. Anahtarınız planınızın kotasını ve sınırlarını sağlar. Free planında aylık 5.000, dakikalık 10 istek vardır. Free dahil her planda MCP erişimi vardır; Free kurları 15 dakika gecikmelidir.
{ "mcpServers": { "exchangerate-dev": { "url": "https://api.exchangerate.dev/v1/mcp/", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } }}Yerel köprüyü çalıştırın
Node.js 20 veya üzerini kurun. Barındırılan bağlantı yerine yerel köprüyü çalıştırmak için aşağıdaki yapılandırmayı API anahtarınızla kullanın.
Yerel kayıt command, args ve env kullanır. npm köprüsünü npx üzerinden başlatır ve ortamda EXCHANGERATE_API_KEY değişkenini ayarlar. Köprü API anahtarı gerektirir. Dosyayı kaydedin ve Cursor'ın MCP ayarlarını yeniden yükleyin veya Cursor'ı yeniden başlatın.
{ "mcpServers": { "exchangerate-dev": { "command": "npx", "args": [ "-y", "@nusantara-ventures/exchangerate-mcp" ], "env": { "EXCHANGERATE_API_KEY": "YOUR_API_KEY" } } }}Araçları kontrol edip kur isteyin
Cursor'ın dokuz aracın tümünü listelediğini kontrol edin, ardından “Şu anda 100 euro kaç Japon yeni?” diye sorun.
convert, bu soruyu from, to ve amount alanlarıyla yanıtlar. get_range ile sorgulamak için “1 Eylül'de USD/IDR kuru neydi?”, list_currencies için “Hangi para birimlerini sorgulayabilirsin?” diye sorun.
get_rate, son kur için base ve quote alanlarını alır. get_range bir tarih aralığındaki kurları getirir. get_usd_index bağımsız hesaplanan bir USD endeksi döndürür; search_docs belgelerde arama yapar.
list_official_rate_tables devletin yayımladığı kur tablolarını listeler; get_official_rate devletin yayımladığı kurları getirir. Dokuzuncu araç start_checkout, yalnızca kullanıcı onayından sonra plan satın alma ekranını açar.
Kuru ve zamanını okuyun
Cursor döndürülen sayıları ve bunların bağlamını okuyabilir: source, market_session ve data_updated_at. Asistandan kurla birlikte zamanı da belirtmesini isteyin.
Dönüşüm yanıtı kuru, dönüştürülen tutarı ve kur USD üzerinden türetildiyse bunu belirten bir işareti içerir. Yanıtlarda kurların gösterge niteliğinde olduğu, takas veya alım satım için olmadığı bildirimi bulunur.
Bağlantı hatalarını giderin
Araçlar görünmüyorsa mcp.json dosyasında geçersiz JSON olup olmadığını kontrol edin. Sondaki fazladan virgül yaygın bir nedendir.
HTTP 401, başlıktaki anahtarın yanlış olduğunu belirtir. HTTP 429, dakikalık sınıra veya aylık kotaya ulaşıldığını belirtir; yeniden deneme zamanını bekleyin.