Hasfiyat Altın API MCP Sunucusu

Hasfiyat Altın API'nin resmi MCP sunucusu, yapay zekâ asistanlarının Türkiye piyasası canlı altın ve döviz fiyatlarını doğrudan sorgulamasını sağlar. Claude, Cursor, VS Code ve MCP destekleyen diğer araçlara bağlandığında asistan; gram, çeyrek, has altın, ons ve döviz fiyatlarını canlı alır, geçmiş fiyatları getirir ve "3 çeyrek kaç TL eder?" gibi hesapları güncel fiyatla yapar.

MCP (Model Context Protocol), yapay zekâ uygulamalarının dış veri kaynaklarına standart bir yolla bağlanmasını sağlayan açık bir protokoldür. Sunucu yalnız okuma yapar; hesabınızda hiçbir şeyi değiştirmez.

Bağlantı bilgileri

Alan	Değer
Sunucu adresi	`https://altinapi.hasfiyat.com/mcp`
Taşıma	Streamable HTTP (durumsuz)
Kimlik doğrulama	`Authorization: Bearer API_ANAHTARINIZ` (alternatif: `X-API-Key` başlığı)
Kota	Her fiyat aracı çağrısı paketinizin aylık REST kotasından 1 istek düşer. `list_sources` kota harcamaz.
Hız sınırı	IP başına dakikada 120 istek

API anahtarınızı panelde API Erişimi ekranından alırsınız. Yeni üyelere kredi kartı istenmeden 5 gün ücretsiz Pro paket tanımlanır.

Araçlar

Araç	Ne yapar	Örnek soru
`list_sources`	Desteklenen fiyat kaynağı kodlarını listeler.	"Hangi kaynaklardan fiyat alabilirim?"
`get_prices`	Bir kaynaktaki canlı alış/satış fiyatlarını döndürür (TL). Sembol verilmezse tüm kalemler gelir.	"Şu an gram altın satış fiyatı kaç TL?"
`get_price_history`	Günlük veya saatlik açılış, yüksek, düşük ve kapanış geçmişini getirir.	"Son 7 günde has altın nasıl değişti?"
`calculate_value`	Miktar × canlı fiyat hesabı yapar.	"3 çeyrek altın bugün kaç TL eder?"

Claude Code

Terminalde tek komutla ekleyin:

claude mcp add --transport http hasfiyat https://altinapi.hasfiyat.com/mcp \
  --header "Authorization: Bearer API_ANAHTARINIZ"

Claude Desktop

claude_desktop_config.json dosyasına ekleyin. Uzak sunucuya mcp-remote köprüsüyle bağlanılır (Node.js gerekir):

{
  "mcpServers": {
    "hasfiyat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://altinapi.hasfiyat.com/mcp",
        "--header",
        "Authorization:${HASFIYAT_AUTH}"
      ],
      "env": {
        "HASFIYAT_AUTH": "Bearer API_ANAHTARINIZ"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json (veya projedeki .cursor/mcp.json) dosyasına ekleyin:

{
  "mcpServers": {
    "hasfiyat": {
      "url": "https://altinapi.hasfiyat.com/mcp",
      "headers": {
        "Authorization": "Bearer API_ANAHTARINIZ"
      }
    }
  }
}

VS Code

Projede .vscode/mcp.json dosyası oluşturun. Anahtar ilk bağlantıda sorulur ve dosyaya yazılmaz:

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

Başlık eklenemeyen istemciler

Bazı web arayüzleri özel başlık eklemenize izin vermez. Bu durumda anahtarı adrese ekleyebilirsiniz:

https://altinapi.hasfiyat.com/mcp?apikey=API_ANAHTARINIZ

Adresteki anahtar tarayıcı geçmişinde ve ara kayıtlarda görünebilir. Bu kullanım için panelde ayrı bir anahtar oluşturun; gerektiğinde yalnız o anahtarı iptal edersiniz.

Bağlantıyı test etme

Aşağıdaki istek sunucunun araç listesini döndürür (anahtar gerekmez):

curl -s https://altinapi.hasfiyat.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Güvenlik ve veri

MCP sunucusu yalnız fiyat okur. API anahtarınızı saklamaz ve kayıtlara yazmaz; isteği anahtarınızla fiyat servisine iletir. Abonelik, kota ve anahtar denetimi REST API ile aynı kurallarla yapılır. Fiyatlar TL cinsindendir ve kaynağın yayımladığı alış/satış değerleridir.

Asistanın cevaplarında veri kaynağı "Hasfiyat Altın API" olarak belirtilir. Ayrıntılı uç ve parametre bilgisi için API dokümantasyonuna bakın.

API anahtarınızı alın

5 gün ücretsiz Pro, kredi kartı gerekmez.

Ücretsiz dene Dokümantasyon