OpenRouter MCP: Kurulum, Model Çağrıları ve Gerçek Ödünleşimler

Bir modeli uygulamanıza bağlamadan önce güncel fiyatını, benchmark sonuçlarını, uç noktalarını ve belgelerini kontrol etmek istiyorsanız OpenRouter MCP bu keşif sürecini ajanın içinden yürütmenizi sağlar. Barındırılan bu Model Context Protocol sunucusu, model araştırmak ve test etmek içindir; üretimde OpenRouter API'nin yerini tutmaz.

OpenRouter MCP size ne kazandırır?

Resmî sunucunun adresi https://mcp.openrouter.ai/mcp. Claude Code, Cursor veya Claude Desktop gibi uyumlu bir istemci uzak HTTP üzerinden bu sunucuya bağlanır; böylece ajan, sohbet sırasında OpenRouter araçlarını kullanabilir. Model kataloğunu araştırmak ve adayları denemek için idealdir. Uygulama içindeki üretim çağrıları ise yine OpenRouter API ya da sağlayıcının kendi MCP'si üzerinden yürütülmelidir.

OpenRouter'ın resmî duyurusu; canlı model verileri, sıralamalar, fiyatlar, belgeler ve test çıkarımından söz ediyor. Uç nokta, araçlar ve kimlik doğrulama davranışı için başvurulacak kaynak ise MCP dokümantasyonu.

Sunucu adresinden önce iş akışını belirleyin

En verimli yaklaşım keşfet, karşılaştır, test et, incele sıralamasını izlemek. Böylece “En iyi model hangisi?” sorusu, net kısıtları olan bir karara dönüşür.

1. Keşfedin: Görev, fiyat, bağlam, modalite veya sağlayıcı gereksinimlerini karşılayan modelleri isteyin. Güncel katalog ve benchmark verileri için list-models ile list-benchmarks kullanın.
2. Karşılaştırın: Her aday için list-model-endpoints çağrısı yapın. Varsa sağlayıcı bazında fiyat, gecikme, aktarım hızı ve veri politikası bilgilerini görün.
3. Test edin: Aynı prompt'u, adını açıkça verdiğiniz bir model slug'ı ile send-message üzerinden çalıştırın. Bu işlem çıkarım ücreti doğurabilir.
4. İnceleyin: Token sayıları, maliyet ve isteği işleyen sağlayıcı için her üretim kimliğini get-generation aracına verin.

Claude Code veya Cursor'da şu prompt'u kullanabilirsiniz:

OpenRouter MCP kullanarak hukuk belgelerinden yapılandırılmış veri çıkarmak için
üç model bul. Gereksinimler: en az 100k bağlam, araç çağrısı desteği ve
en düşük mevcut girdi fiyatı. Sağlayıcıları ve veri politikalarını karşılaştır.
Ardından en iyi iki adayda aşağıdaki prompt'u aynen çalıştırmak için
send-message kullan:

"Aşağıdaki metindeki tüm sözleşme yenileme tarihlerini çıkar. Yalnızca JSON
döndür; renewals adlı bir dizi içersin ve her öğede party, date ve evidence bulunsun."

Testlerden sonra her üretim kimliği için get-generation kullan ve gerçek
maliyeti ile isteği işleyen sağlayıcıyı bildir. Adayları onaylamadan önce
hiçbir modeli çağırma.

Katalog aramaları salt okunurdur, ancak send-message çıkarım ücreti oluşturabilir; bu nedenle testten önce onay istemek mantıklıdır. Tekrarlanabilir değerlendirmeler için modeli ve sağlayıcıyı açıkça belirtin. Mevcut olduğunda :free, :floor, :nitro ve :online gibi ekler sabit kalite garantisi değil, yönlendirme tercihi ifade eder.

Resmî uzak sunucuya bağlanma

Yerelde kurulum gerekmez. Uzak uç noktayı ekleyin, tarayıcı tabanlı OAuth akışını tamamlayın ve diğer anahtarlarınızdan ayrı bir OpenRouter anahtarına yetki verin. Belgelenen varsayılanlar 7 günlük geçerlilik süresi ve $10 harcama sınırıdır; ikisi de onay ekranından değiştirilebilir. OpenRouter, PKCE kullanan OAuth akışını belgeliyor; yani istemci yapılandırmasına normal bir API anahtarı yapıştırmak yerine tarayıcıda yetki veriyorsunuz.

Claude Code

Şu komutları çalıştırın:

claude mcp add --transport http openrouter https://mcp.openrouter.ai/mcp
claude mcp login openrouter

İlk komut uzak HTTP sunucusunu kaydeder, ikincisi OAuth akışını açar. Claude Code oturumu içindeyken Claude Code MCP dokümantasyonu üzerinden /mcp de kullanılabilir: OpenRouter sunucusunu seçip kimlik doğrulamasını tamamlayın.

Bağlantıyı, salt okunur şu tür bir istekle sınayın: “OpenRouter MCP kullanarak en az 128k bağlama sahip iki güncel modeli listele ve girdi fiyatlarını göster.”

Cursor

Uzak sunucuyu ~/.cursor/mcp.json dosyasına ekleyin:

{
  "mcpServers": {
    "openrouter": {
      "url": "https://mcp.openrouter.ai/mcp"
    }
  }
}

Sunucu görünmüyorsa Cursor'u yeniden yükleyin. Kimlik doğrulama, Cursor'un MCP ayarlarından veya ilk araç kullanımında başlar. Belgelenen CLI cursor-agent; kaydı şu komutla doğrulayabilirsiniz:

cursor-agent mcp list

Cursor'ın MCP dokümantasyonu, kullanıcı düzeyi ve proje düzeyi yapılandırmayı açıklar. Kaydı, ihtiyaç duyduğunuz kapsamda ekleyin; kişisel kimlik doğrulama yapılandırmasını paylaşılan bir depoya commit etmeyin.

Claude Desktop ve Claude Web

OpenRouter, Claude'un bağlayıcı dizininde görünmüyorsa OpenRouter'ın bağlantı rehberi özel bir uzak bağlayıcı eklenmesini öneriyor:

1. Settings > Connectors > Customize > Connectors yolunu açın.
2. + düğmesine tıklayın, ardından Add custom connector seçeneğini seçin.
3. Ad olarak OpenRouter MCP yazın.
4. Uzak MCP sunucusu URL'si alanına https://mcp.openrouter.ai/mcp girin.
5. OAuth alanlarını boş bırakın, bağlayıcıyı ekleyin, açın ve Connect seçeneğine tıklayın.
6. Tarayıcıdaki OpenRouter onay sürecini tamamlayın.

Bazı kurumlar özel bağlayıcıları devre dışı bırakır. Yönetilen bir hesapta bu seçenek yoksa yöneticinize danışın. Anthropic'in MCP dokümantasyonu, istemci tarafındaki protokol kavramlarını ele alır.

Hangi işlemleri güvenle isteyebilirsiniz?

Resmî OpenRouter MCP araçlarının çoğu canlı veri sorgular. Araç listesini ezberlemek yerine, yan etkilerine göre gruplamak daha kullanışlıdır.

Model seçerken karar kuralını açıkça belirtin: “Araç çağrısı ve 64k bağlam penceresi sunan en düşük maliyetli modeli bul, ardından mevcut en hızlı uç noktayı göster.” Belgelenen filtreler arasında fiyat, minimum bağlam, model ailesi, geliştirici, sağlayıcı, modalite, desteklenen parametreler, benchmark aralıkları, araç çağrısı başarı oranı, sıfır veri saklama seçeneği ve bölge bulunuyor.

Kontrollü bir model testi için slug'ı belirtin ve prompt'u yeniden üretilebilir hale getirin:

OpenRouter MCP send-message aracını "openai/gpt-4o" modeliyle kullan.
Aşağıdaki kullanıcı mesajını aynen gönder ve sistem prompt'u ekleme:

"title ve risks anahtarlarına sahip bir JSON nesnesi döndür. Bu sürüm notunu analiz et:
[metni buraya yapıştırın]"

Yanıtı ve üretim kimliğini göster. Başka bir model çalıştırma.

Buradaki slug yalnızca örnektir; kullanılabilir olduğunu list-models ile doğruladığınız bir slug seçin. Denetlenebilir karşılaştırmalar için desteklenmeyen bir model önerisini kabul etmek yerine hangi sorgu araçlarının kullanılacağını, döndürülecek değerleri ve üretim kimliğini açıkça isteyin.

OpenRouter MCP mi, sağlayıcının resmî MCP'si mi?

OpenRouter MCP, sağlayıcılar arası bir araştırma ve test katmanıdır. İşlem doğrudan sağlayıcının ürününe, hesabına veya veri düzlemine aitse sağlayıcının resmî MCP'si genellikle daha doğru seçimdir.

Sorunuz “Hangi modeli veya rotayı kullanmalıyım?” ise OpenRouter MCP'yi seçin. “Bu sağlayıcının hizmeti içinde ne yapabilirim?” sorusunda ise birinci taraf sağlayıcı MCP'si daha uygundur. Her iki yeteneğe de ihtiyaç varsa aynı ajana ikisini birden bağlayabilirsiniz.

Topluluk tarafından geliştirilen yerel veya çok modlu MCP sunucuları ayrı bir kategoridir. OpenRouter'ın Works With OpenRouter sayfası, birden çok istemci ile metin, görsel, ses ve video iş akışlarını kapsayan bir sunucuyu anlatıyor. Bu sunucu OpenRouter API anahtarı ve kredi gerektirir; mcp.openrouter.ai üzerindeki resmî barındırılan hizmet değildir.

Gerçek projelerde kritik sınırlar

“@OpenRouter’s ori harness/cli has been a blessing... p.s: also thanks for openrouter mcp for quickly checking up info on models 🫰” — @CodewithP, X, model bilgisi sorgulama kullanım senaryosunu anlatıyor.

OpenRouter'ın MCP cookbook içeriği ters yöndeki kullanım senaryosunu da ele alıyor: Bir kodlama istemcisini OpenRouter MCP'ye bağlamak yerine, diğer MCP araç sunucularında LLM arka ucu olarak OpenRouter modellerini kullanmak.

İlk başarısız çağrıda kontrol listesi

1. Sunucu görünüyor ama araçlar kimlik doğrulamada hata veriyor. İstemciye özgü OAuth adımını yeniden çalıştırın. Özel anahtarın belgelenen ömrü 7 gündür; ayrıca OpenRouter panosundan bağlantısı kesilebilir.
2. Tarayıcı penceresi açılmıyor. claude mcp login openrouter, Claude Code'un /mcp işlemi, Cursor'un MCP ayarları veya Claude bağlayıcısındaki Connect düğmesini kullanın.
3. Claude Desktop'ta özel bağlayıcı seçeneği yok. Kurum yöneticisinin özel bağlayıcıları devre dışı bırakıp bırakmadığını kontrol edin.
4. Model yanıtı güncel görünmüyor. Açıkça list-models, list-benchmarks veya list-model-endpoints isteyin ve dönen değerlerin gösterilmesini şart koşun.
5. Bir test beklenenden pahalıya geldi veya farklı yönlendirildi. Üretim kimliğini get-generation ile inceleyin; sonraki tekrarlanabilirlik çalışmasında açık bir sağlayıcı sabitleyin.

SSS

OpenRouter MCP herhangi bir OpenRouter modelini çağırabilir mi?

Canlı katalogda yer alan model slug'larını; kullanılabilirlik, yetenekler, kredi ve yönlendirme kısıtlarına tabi olarak test edebilir. Önce slug'ı list-models ile doğrulayın.

OpenRouter MCP'yi Claude Desktop, Cursor ve Claude Code ile aynı anda kullanabilir miyim?

Aynı resmî uç noktayı, her istemcinin belgelenmiş yapılandırma ve kimlik doğrulama akışını izleyerek her birine ekleyebilirsiniz. Paylaşılan yapılandırmalarda kişisel kimlik bilgileri bulunmamalıdır.

Bunun yerine topluluk yapımı bir openrouter-mcp paketi kurmalı mıyım?

Yalnızca resmî barındırılan sunucunun sunmadığı yerel stdio iş akışına veya çok modlu orkestrasyona ihtiyacınız varsa. Önce depoyu, kimlik bilgisi yönetimini, paket kaynağını ve bakım durumunu doğrulayın.

İşe salt okunur bir katalog sorgusuyla başlayın; model, rota ve harcama sınırı netleşmeden kontrollü bir çıkarım çağrısına yetki vermeyin.