Claude ve ChatGPT'yi MCP ile Canlı Altın Fiyatlarına Bağlayın

Bir asistanın neden bir fiyat aracına ihtiyacı var

Hiçbir araca erişimi olmayan bir sohbet asistanına bugünkü altın fiyatını sorduğunuzda üç yanıttan birini alırsınız: bir ret, eğitim verilerinden bir rakam ya da hak ettiğinden fazla özgüvenle sunulan bir tahmin. Hiçbiri işe yaramaz. Bir dil modeli, sizinle konuşmasından aylar önce sona eren bir metin anlık görüntüsünden öğrenir; oysa altın, gümüş ve petrol fiyatları piyasalar açık olduğu sürece birkaç saniyede bir değişir.

Bilinen geçici çözüm, fiyatı kendiniz bulup sohbete yapıştırmaktır. Bu tek bir soru için işe yarar, sonra tıkanır. Hangi birimi (troy ons mu, gram mı?) ve hangi para birimini kopyaladığınızı, rakamın ne zaman alındığını hatırlamanız gerekir. Geçen ayın fiyat aralığıyla ilgili bir ek soru sorduğunuzda ya da Türk lirasına dönüştürme istediğinizde yeniden tarayıcıya dönersiniz.

Model Context Protocol (MCP) bu adımı ortadan kaldırır. Asistan, kendi başına çağırabileceği küçük bir araç setine kavuşur ve her yanıt, kendi zaman damgasını, baz para birimini ve birimini taşıyan taze bir API yanıtından oluşturulur. Bu yazı Claude, ChatGPT, Claude Code, Cursor ve VS Code'u MetalAPI MCP sunucusuna nasıl bağlayacağınızı, bağlandıktan sonra asistanın neler yapabileceğini ve hangi güvenlik önlemlerinin geçerli olduğunu gösteriyor.

MCP nedir

MCP, Anthropic tarafından 2024'te tanıtılan ve bugün pek çok yapay zekâ uygulaması tarafından desteklenen, bir asistanın harici araçlar ve verilerle nasıl konuşacağını standartlaştıran açık bir protokoldür. Bir MCP sunucusu bir araç listesi yayımlar. Her aracın bir adı, sade bir dille yazılmış bir açıklaması, argümanları için bir JSON şeması ve “salt okunur” gibi isteğe bağlı açıklamaları (annotation) vardır. Bir MCP istemcisi (Claude, ChatGPT, Cursor, VS Code ve diğerleri) bu listeyi okur, bir aracın ne zaman gerekli olduğuna modelin karar vermesine izin verir, çağrıyı sunucuya gönderir ve sonucu modele geri iletir.

Modelin kendisi kimlik bilgilerinizi hiçbir zaman görmez ve API ile doğrudan konuşmaz. “get_latest_prices aracını symbols: XAU ve base: EUR ile çağır” gibi yapılandırılmış bir istek üretir; istemci bunu çalıştırır ve model yanıtını geri dönen JSON'a dayanarak yazar.

MetalAPI'nin sunucusu https://metalapi.com/mcp adresindedir. MCP spesifikasyonunda tanımlanan uzak aktarım yöntemi olan Streamable HTTP kullanır ve durumsuzdur (stateless): her çağrı, JSON yanıtı olan bağımsız bir HTTPS isteğidir; dolayısıyla canlı tutulması gereken uzun ömürlü bir oturum yoktur. Sunucu, resmi MCP Registry'de com.metalapi/metalapi adıyla listelenmektedir. URL'yi bir tarayıcıda açarsanız AI ve MCP genel bakış sayfasına yönlendirilirsiniz.

OAuth ile giriş yapın veya bir API anahtarı kullanın

Sunucuya yapılan her çağrının kimliği doğrulanır. Bunun iki yolu vardır ve doğru olanı istemciye bağlıdır:

• Claude ve ChatGPT gibi bağlayıcı ekranı olan uygulamalar için OAuth 2.1 (giriş yapma). İstemci yetkilendirme sunucusunu kendi başına keşfeder: kimliği doğrulanmamış bir çağrı, sunucunun korunan kaynak meta verilerini (protected-resource metadata) gösteren bir WWW-Authenticate header'ı içeren 401 yanıtı alır. Ardından istemci dinamik istemci kaydıyla (dynamic client registration) kaydolur ve bir MetalAPI giriş sayfası açar. Akış PKCE kullandığından uygulamaya bir istemci gizli anahtarı (client secret) gömülmesi gerekmez. Giriş yaparsınız (veya ücretsiz bir hesap oluşturursunuz) ve bağlantıyı onaylarsınız.
• Claude Code, Cursor ve VS Code gibi HTTP header'larını ayarlamanıza izin veren geliştirici araçları için API anahtarı. REST API için kullandığınız anahtarın aynısını Authorization: Bearer mk_live_… olarak gönderirsiniz.

Her iki yol da aynı hesaba, plana ve kotaya çıkar. Araç listesinde tek bir fark vardır: create_api_key yalnızca OAuth bağlantılarında sunulur. Bir yapılandırma dosyasına kopyalanmış bir anahtarın yeni anahtarlar üretebilmesi asla mümkün olmamalıdır; bu nedenle anahtar tabanlı bir bağlantı on üç yerine on iki araç görür.

Claude ve ChatGPT'yi bağlayın

claude.ai'deki ve Claude Desktop'taki Claude için:

1. Settings → Connectors bölümünü açın ve Add custom connector seçeneğini seçin.
2. Ad olarak MetalAPI yazın ve https://metalapi.com/mcp adresini girin.
3. Connect düğmesine tıklayın, MetalAPI'ye giriş yapın (veya ücretsiz bir hesap oluşturun) ve Allow düğmesine tıklayın.

ChatGPT için Settings → Apps & Connectors bölümünü açın ve geliştirici modunda https://metalapi.com/mcp URL'si ve OAuth kimlik doğrulamasıyla bir bağlayıcı oluşturun. ChatGPT, MetalAPI giriş sayfasını açar; bağlantıyı onayladığınızda araçlar sohbetlerinizde kullanılabilir hale gelir. Özel bağlayıcı ekleyip ekleyemeyeceğiniz ChatGPT planınıza ve bir çalışma alanındaysanız yöneticinin izinlerine bağlıdır.

Her iki uygulamadaki menü adları zaman zaman değişir. MCP kurulum rehberi, her istemci için güncel adımlarla güncel tutulur.

İlk sohbetinizde kaynağı belirtmek (“MetalAPI'yi kullanarak … nedir?”) asistanın belleği yerine araca başvurmasına yardımcı olur. Sonrasında çoğu asistan, bir soru bir fiyatla ilgili olduğunda aracı kendiliğinden seçer.

Claude Code, Cursor ve VS Code'u bağlayın

Kodlama asistanları genellikle bir API anahtarı kullanır. Panelde bir anahtar oluşturun (başlamak için Free plan yeterlidir) ve her araç için ayrı bir anahtar kullanın; böylece birini iptal ettiğinizde diğerleri bozulmaz.

Claude Code'da sunucuyu terminalden ekleyin:

claude mcp add --transport http metalapi https://metalapi.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Bir anahtar saklamak istemiyorsanız sunucuyu --header olmadan ekleyin ve bunun yerine OAuth ile giriş yapmak için Claude Code içinde /mcp komutunu çalıştırın.

Cursor'da sunucuyu ~/.cursor/mcp.json dosyasına ya da bir proje içindeki .cursor/mcp.json dosyasına ekleyin:

{
  "mcpServers": {
    "metalapi": {
      "url": "https://metalapi.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

GitHub Copilot ile VS Code'da aşağıdakini .vscode/mcp.json olarak kaydedin. inputs bloğu, VS Code'un anahtarı bir kez sormasını ve güvenli şekilde saklamasını sağlar; böylece anahtar dosyanın içinde hiç yer almaz:

{
  "inputs": [
    { "type": "promptString", "id": "metalapi-key", "description": "MetalAPI API key", "password": true }
  ],
  "servers": {
    "metalapi": {
      "type": "http",
      "url": "https://metalapi.com/mcp",
      "headers": { "Authorization": "Bearer ${input:metalapi-key}" }
    }
  }
}

Streamable HTTP üzerinden uzak MCP sunucularını destekleyen Windsurf gibi diğer istemciler de aynı düzeni izler: sunucu URL'si ile birlikte ya bir bearer header'ı ya da OAuth ile giriş.

Bir sohbet nasıl görünür

Bağlandıktan sonra günlük dille sorarsınız; asistan bir araç ve argümanlarını seçer. Birkaç tipik istem ve yol açtıkları çağrılar:

Fiyat araçları kompakt JSON döndürür. REST API'nin rates bloğu, eski entegrasyonlarla uyumluluk için her sembolü iki kez, fiyat ve tersi olarak listeler. MCP sunucusu ise prices altında, sembole göre anahtarlanmış yalnızca fiyatları tutar. Bu, token sayısını kabaca yarıya indirir ve verilerin yanlış okunmasının en yaygın nedenini ortadan kaldırır. symbols: XAU,XAG, base: EUR ve unit: gram ile yapılan bir get_latest_prices çağrısı şuna benzer bir sonuç döndürür:

{
  "success": true,
  "timestamp": 1792834892,
  "date": "2026-10-24",
  "base": "EUR",
  "unit": "gram",
  "rate_limit": {
    "limit": 10000,
    "remaining": 9874,
    "reset": 1793491200,
    "used": 126,
    "plan": "Standard",
    "reset_date": "2026-11-01T00:00:00.000Z"
  },
  "prices": {
    "XAU": 110.4064149,
    "XAG": 1.489616277
  }
}

Her yanıt timestamp, base ve unit taşıdığı için iyi bir yanıt yalnızca “110 €” demez; altının belirli bir anda gram başına yaklaşık 110 € olduğunu söyler. Bir yanıt bu bağlamı atlıyorsa isteyin.

Asistanlar çağrıları zincirleme olarak da yapabilir. Bugünkü altın/gümüş oranını bir ay öncesiyle karşılaştırması istendiğinde bir asistan, her iki metali her iki tarih için alıp bölme işlemini kendisi yapabilir. Grafik istendiğinde ise kod çalıştırabilen bir istemci, bir get_timeseries sonucunu grafiğe dönüştürebilir.

13 araç

Sunucu on üç araç sunar. Bunlardan yedisi piyasa verisi döndürür ve tıpkı bir REST çağrısı gibi her biri planınızın aylık kotasından bir istek düşer. Diğerleri ücretsizdir.

Bir istemci bağlandığında sunucu kısa talimatlar da gönderir: sembol kodlarının ne anlama geldiği, bir birim belirtilmedikçe metal fiyatlarının troy ons başına olduğu ve veri araçlarının kotadan düştüğü. İstemciler bunları modele iletir; düzgün çalışan bir asistanın yalnızca ihtiyaç duyduğu sembolleri istemesinin nedeni budur. Daha az sembol, daha kısa yanıt ve daha az token demektir.

Güvenlik: varsayılan olarak salt okunur, ödeme yok

Bir asistanı bir hesaba bağlamak haklı bir soruyu gündeme getirir: neyi değiştirebilir? Tasarım bu sorunun yanıtını kısa tutar.

• On üç aracın on biri salt okunurdur. MCP readOnlyHint açıklamasını taşırlar ve yalnızca fiyatları, planınızı, kullanımınızı ve maskelenmiş anahtar bilgilerini okuyabilirler.
• İki yazma aracı önce onay ister. create_api_key ve get_upgrade_link bir şeyi değiştiren eylemler olarak işaretlenmiştir; bu nedenle MCP istemcileri bunları çalıştırmadan önce onayınızı ister.
• Sunucu hiçbir zaman ücret tahsil etmez. get_upgrade_link, istediğiniz plan için bir Stripe ödeme oturumu ya da zaten aboneyseniz bir faturalandırma portalı bağlantısı oluşturur ve URL'yi döndürür. Bağlantıyı siz açar, fiyatı kontrol eder ve ödemeyi kendiniz yaparsınız. Asistan bir ödemeyi tamamlayamaz.
• Yeni anahtarlar yalnızca bir kez gösterilir. create_api_key ile oluşturulan bir anahtar, panelde olduğu gibi tam haliyle yalnızca bir kez döndürülür ve yalnızca hash değeri saklanır.
• Dar kapsam. Bağlantı yalnızca MetalAPI'ye erişir: fiyatlar, planınız, kullanımınız ve API anahtarlarınız. Sunucu konuşmalarınızı, dosyalarınızı veya diğer bağlayıcılarınızı hiçbir zaman görmez.
• API trafiği gibi kaydedilir. Piyasa verisi çağrıları, panelinizin istek kaydında REST isteklerinizin yanında /mcp/ ve ardından araç adıyla görünür.

Her sunucu için geçerli, sürdürmeye değer genel bir MCP alışkanlığı vardır: istemcinizin gösterdiği onay istemlerini refleksle onaylamak yerine okuyun ve artık kullanmadığınız bağlayıcıları kaldırın.

Kotalar, güncellik ve planlar

MCP çağrıları REST API ile aynı kotayı kullanır. Bir veri aracı çağrısı kaç sembol döndürürse döndürsün bir istek tutar; list_symbols ve hesap araçları ise hiçbir şey tutmaz. Dakika başına istek limitleri de geçerlidir; Free planda dakikada 10 istekten başlar.

Fiyatlar planınızın izin verdiği kadar günceldir. Free planda asistan günlük fiyatları görür; ücretli planlarda fiyatlar 30 dakikada birden 5 saniyede bire kadar yenilenir:

Ayda yüz istek, sohbette ara sıra sorulan sorular için yeterlidir. Asistanı çok sayıda seri çeken analizler için kullanıyorsanız ya da zamanlanmış olarak çalışan bir ajana bağladıysanız ara sıra ondan get_account çağırmasını isteyin: kullanılan ve kalan istek sayısını ve kotanın ne zaman sıfırlanacağını bildirir. Aylık kota tükendiğinde veri araçları ayın 1'ine (UTC) kadar bir yükseltme bağlantısıyla birlikte kota aşımı hatası döndürür; hesap araçları ise çalışmaya devam eder. Tam karşılaştırma fiyatlandırma sayfasındadır.

Başlamak birkaç dakika sürer: ücretsiz bir hesap için kaydolun, istemciniz için MCP kurulum rehberini izleyin ve ilk sorunuzu sorun. AI ve MCP sayfası kurulumu özetler; API dokümantasyonu ise her aracın arkasındaki REST endpoint'lerini açıklar.