MCP sunucusu

Yazar Haber Ajansı MCP Sunucusu: Haber Akışını Yapay Zekâ Asistanlarına Bağlama Rehberi

Yazar Haber Ajansı MCP sunucusu, YHA haberlerini Model Context Protocol (MCP) destekleyen yapay zekâ istemcilerine (Claude Code, Cursor ve MCP destekleyen diğerleri) kendi paket haklarınızla açar. Bağlantıyı kurduğunuzda istemcinize "bugünkü ekonomi haberlerini getir" dediğinizde istemci, ajansın son_haberler aracını çağırır ve paketinizdeki güncel haberlerle yanıt verir.

YHA MCP sunucusu, Yazar Haber Ajansı geliştirici belgeleri içindeki entegrasyon yollarından biridir. YHA API ile aynı içerik ve paket hakkı yapısını kullanır, ancak kendine ait bir anahtar türü ister.

Model Context Protocol (MCP) nedir?

Model Context Protocol, yapay zekâ uygulamalarının dış veri kaynaklarına ve araçlara standart bir yolla bağlanması için Anthropic tarafından geliştirilip açık kaynak olarak yayınlanan bir protokoldür (modelcontextprotocol.io). MCP'yi yapay zekâ için ortak bir "priz" gibi düşünebilirsiniz: bir veri kaynağı bir kez MCP sunucusu olarak sunulduğunda, MCP'yi destekleyen istemciler o kaynağa aynı şekilde bağlanabilir.

MCP'de üç temel rol vardır:

Model, kullanıcının isteğine göre hangi aracı çağıracağına karar verir; sunucu sonucu döner, model de bu sonucu kullanarak yanıt oluşturur. Bu sayede istemci, eğitim verisinde olmayan bugünün haberleriyle çalışabilir.

YHA MCP sunucusu ne sağlar?

YHA MCP sunucusu, paketinizdeki haberleri yapay zekâ istemcinizin kullanabileceği beş araç hâlinde sunar. Araçların girdi ve çıktı şemaları sunucudan (tools/list) gelir.

Kategori ve il adları Türkçe büyük-küçük harf duyarsız eşlenir; eşleşmezse araç olası adları döner. Sunucu okuma odaklıdır: haberleri arar ve getirir, sizin adınıza yayın yapmaz. Araç listesi: MCP araçları.

Bağlanmadan önce gerekenler

• Paketinizde mcp kanalı açık bir YHA aboneliği (otomatik çıkışlar pakete sözleşmeyle eklenir; kapalıysa 403 kanal_paketinde_yok).
• YHA Abone · Çıkışlar · Anahtarlar ekranında üretilmiş MCP türünde bir anahtar (mcp.kullan kapsamı). API anahtarı MCP'de çalışmaz; MCP anahtarı da API'de dosya indiremez. Böylece yapay zekâ istemcisinin yapılandırma dosyasına yazılan anahtarla dosya indirilemez.
• MCP destekleyen bir istemci.

Taşıma, MCP'nin akışlı HTTP'sidir (Streamable HTTP) ve durumsuzdur. Kimlik Authorization: Bearer … başlığıyla doğrulanır; OAuth bu sürümde yoktur. Deneme ortamında örnek içerik 10 dakikada bir yenilenir; MCP'yi canlı anahtar almadan önce orada deneyebilirsiniz.

Claude Code ile bağlantı

Claude Code'da uzak bir MCP sunucusu claude mcp add komutuyla eklenir (Claude Code MCP belgesi):

claude mcp add --transport http yha https://mcp.yha.com.tr/ --header "Authorization: Bearer yha_canli_..."

Ekledikten sonra şu komutlarla kontrol edebilirsiniz:

claude mcp list        # ekli sunucuları listeler
claude mcp get yha     # YHA sunucusunun ayrıntıları

Claude Code oturumu içinde /mcp komutu da bağlı sunucuların durumunu gösterir. Sunucuyu yalnızca belirli bir proje için eklemek isterseniz --scope project seçeneğini kullanabilirsiniz; bu durumda yapılandırma proje klasöründeki .mcp.json dosyasına yazılır. Anahtarı bu dosyaya düz metin olarak koymayın ve dosyayı herkese açık bir depoya göndermeyin.

Başlık gönderemeyen istemciler: yerel köprü

Bazı istemciler uzak sunucuya HTTP başlığı ekleyemez. Bunlar için mcp-remote köprüsü yerel olarak çalışır ve başlığı sizin yerinize ekler:

npx mcp-remote https://mcp.yha.com.tr/ --header "Authorization: Bearer yha_canli_..."

Yapılandırma dosyası (mcpServers) kullanan istemcilerde aynı köprü şöyle tanımlanabilir; başlığı ortam değişkeninden vermek, bazı istemcilerin argümanlardaki boşlukları bozmasını önler:

{
  "mcpServers": {
    "yha": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.yha.com.tr/", "--header", "Authorization:${YHA_YETKI}"],
      "env": { "YHA_YETKI": "Bearer yha_canli_..." }
    }
  }
}

Dosyayı kaydettikten sonra istemciyi tamamen kapatıp yeniden açın. Bağlantı başarılıysa araçlar menüsünde YHA araçlarını görürsünüz. Köprü Node.js gerektirir.

Diğer MCP istemcileri

MCP açık bir protokol olduğundan YHA MCP sunucusu, akışlı HTTP taşımasını destekleyen diğer yapay zekâ uygulamaları, kod editörleri ve kendi geliştirdiğiniz ajanlarla da çalışır. Genel kural aynıdır: istemciye sunucu adresini, taşıma türünü (HTTP) ve yetkilendirme başlığını tanıtırsınız. Kendi uygulamanızı geliştiriyorsanız protokolün resmi sitesindeki istemci SDK'larını kullanabilirsiniz.

Yetkilendirme ve güvenlik

MCP sunucusu abonelik içeriğine erişim verdiği için anahtar, şifreniz kadar değerlidir.

• Her kullanıcı veya her entegrasyon için ayrı MCP anahtarı üretin; bir çalışan ayrıldığında yalnızca onun anahtarını iptal edersiniz. İptal hemen geçerlidir; açık MCP bağlantıları birkaç saniye içinde kapanır.
• Anahtarı daraltabilirsiniz: IP listesi (en çok 20 blok), anahtara özel günlük sınır, paket kısıtı ve son kullanma tarihi.
• Yapılandırma dosyalarını paylaşırken anahtarı silin.
• İstemcinin çağırdığı araçları onay ekranında okuyun.
• Erişim paketinizle sınırlıdır: MCP üzerinden de yalnızca paketinizdeki içeriğe ulaşırsınız.

MCP'ye özgü kurallar

• Dosya ve görüntü verilmez; haber_getir medyanın yalnızca bilgisini döner.
• Embargosu süren içerik MCP'de hiç görünmez.
• İptal edilen haber "İPTAL EDİLDİ — kullanma" uyarısıyla döner; tanıtım içeriği "[Tanıtım]" etiketlidir.
• Her çıktının sonunda kaynak gösterme notu ve varsa kullanım kısıtı yazar. Yapay zekânın ürettiği metinde kaynağı ("Yazar Haber Ajansı" ya da "YHA") gösterin.
• MCP ile alınan içerik de yapay zekâ modellerinin eğitiminde kullanılamaz.

Kullanım senaryoları

Editör asistanı

Nöbetçi editör, istemciye "son bir saatte gelen flaş ve önemli haberleri listele" der. İstemci son_haberler aracını öncelik süzgeciyle çağırır, başlıkları ve spotları tablo hâlinde sunar. Editör hangi haberi işleyeceğine daha hızlı karar verir.

Özet ve bülten hazırlığı

Sabah bülteni hazırlayan ekip, istemciden önceki günün öne çıkan haberlerinin birer paragraflık özetini ister. Her özetin altına haber numarası eklenir; editör özetleri haber_getir ile gelen tam metinle karşılaştırıp düzeltir.

Sınıflama ve etiketleme

Kendi kategori yapınız ajansınkinden farklıysa, istemciden gelen haberleri sizin kategori ve etiket şemanıza göre önermesini isteyebilirsiniz. kategoriler aracı ajans kategorilerinin listesini verir.

Arşiv araştırması

Muhabir bir konunun geçmişini araştırırken haber_ara ile paketinizin arşiv derinliği içinde arama yapar ve zaman çizelgesini hızlıca çıkarır.

Haber odasında MCP kullanımı için iyi uygulamalar

• Rolleri ayırın. Nöbetçi editör, bülten ekibi ve muhabir için ayrı anahtarlar tanımlayın. Böylece kullanım takibi ve gerektiğinde erişim iptali kolaylaşır.
• Ortak istem kalıpları hazırlayın. "Son bir saatin yerel haberlerini önem sırasıyla, her biri için haber numarasıyla listele" gibi sık kullanılan istekleri ekipçe yazılı hâle getirin.
• Haber numarasını her zaman isteyin. Her özet ve listede H-… numarasının yer almasını şart koşun; editör bir cümlenin hangi haberden geldiğini doğrulayabilmelidir.
• Doğrulama adımını iş akışına yazın. "İstemci çıktısı → editör kontrolü → yayın" sırası yazılı bir yayın ilkesi olmalıdır.
• Geri bildirim toplayın. Modelin yanlış yorumladığı örnekleri kaydedin; istem kalıplarını iyileştirmenize yardımcı olur.

Sınırlamalar

• Model hata yapabilir. Model, aracın döndürdüğü metni yanlış yorumlayabilir, tarihleri karıştırabilir veya özet sırasında bilgi ekleyebilir. Araç çıktısını kaynak kabul edin, modelin yorumunu doğrulayın.
• Bağlam ve sayı sınırı vardır. son_haberler en çok 20 haber döner; önce listeleyin, sonra ihtiyaç duyduğunuz haberleri haber_getir ile tek tek getirin.
• Çağrı sınırları geçerlidir. Her tools/call bir API çağrısı sayılır (initialize ve tools/list sayılmaz); dakikalık ve günlük sınırlar API'dekiyle aynıdır. Anahtar başına aynı anda en çok 3 bağlantı açılabilir.
• Kullanım koşulları geçerlidir. MCP ile alınan haberler de abonelik sözleşmenizdeki kullanım kurallarına tabidir.

Editoryal sorumluluk ve yapay zekâ kuralları

Yapay zekâ haber odasında hız kazandıran bir yardımcıdır; editörün yerini almaz. API kullanım şartları da yapay zekâ araçlarının ürettiği metinde kaynak gösterilmesini ve editör denetimi yapılmasını ister. İstemcinin hazırladığı özet, başlık önerisi veya yeniden yazım yayına çıkmadan önce bir editör tarafından okunmalı, olgular kaynak haberle karşılaştırılmalıdır.

Google'ın yapay zekâ ile üretilen içerik rehberi de bu yöndedir: Google, içeriğin yapay zekâ ile üretilmesini tek başına sorun saymaz; önemli olan içeriğin insanlar için faydalı, doğru ve özgün olmasıdır. Ancak yapay zekâ ile değer katmadan çok sayıda sayfa üretmek, Google spam politikalarında ölçekli içerik kötüye kullanımı olarak tanımlanır. Bu nedenle:

• Ajans haberini istemciye yeniden yazdırıp aynı haberi değer katmadan çoğaltmayın.
• Yerel bağlam, ek röportaj, veri veya fotoğraf gibi kendi katkınızı ekleyin.
• Haberde yazar ve kaynak bilgisini açıkça gösterin.
• Okurun yapay zekâ kullanımını bilmesinin beklenebileceği durumlarda bunu belirtin.

İlk bağlantıyı test etmek

Kurulumdan sonra bağlantının doğru çalıştığını üç basit istekle anlayabilirsiniz:

1. "YHA'da hangi kategoriler var?" İstemci kategoriler aracını çağırmalıdır.
2. "Bugünkü ekonomi haberlerini getir." İstemci son_haberler(kategori: "ekonomi", baslangic: "bugun") çağırmalı; dönen başlıkları YHA Abone'deki akışla karşılaştırın.
3. "Bu listedeki ilk haberin tam metnini getir ve üç cümleyle özetle." İstemcinin haber_getir aracını çağırdığını ve özetin metinle tutarlı olduğunu kontrol edin.

Deneme ortamında başlıklar "[ÖRNEK]" ile başlar. İstemci araç çağırmadan genel bilgiyle yanıt veriyorsa isteğinizde "YHA'dan" ifadesini açıkça kullanın veya sunucunun istemcide etkin olduğunu kontrol edin.

Sorun giderme

Sorun sürerse servis durumu sayfasını kontrol edip destek@yha.com.tr adresine istemci adını, hata mesajını ve zamanı iletin.

Protokolün kendisini, host-client-server yapısını ve temel kavramlarını MCP nedir? rehberinde anlattık.

Sıkça Sorulan Sorular

MCP kullanımı abonelik kotama sayılır mı?

Evet; her tools/call bir API çağrısı sayılır ve kurumunuzun günlük çağrı sınırına girer. initialize ve tools/list sayılmaz. MCP dosya vermediği için indirme kotasına etkisi yoktur.

YHA MCP sunucusunu kullanmak için programcı olmak gerekir mi?

Hayır. Claude Code gibi bir istemcide tek komutla ya da yapılandırma dosyasıyla sunucu adresini ve MCP anahtarını girmeniz yeterlidir. Kendi uygulamanıza entegre etmek ise geliştirme bilgisi gerektirir.

MCP ile API arasındaki fark nedir?

API, yazılımların doğrudan çağırdığı bir arayüzdür ve medya dosyası da verir. MCP aynı içeriği yapay zekâ istemcilerinin çağırabileceği araçlar olarak sunar, dosya vermez ve embargolu içeriği hiç göstermez. Otomatik içe aktarma için API, sohbet tabanlı çalışma için MCP daha uygundur.

Asistan haberleri sitemde otomatik yayınlayabilir mi?

YHA MCP sunucusu haber okuma ve aramaya yöneliktir. Yayın kararı ve yayın işlemi sizin sisteminizde, editör onayıyla yapılmalıdır.

OAuth ile bağlanabilir miyim?

Bu sürümde hayır; kimlik doğrulama Authorization: Bearer başlığındaki MCP anahtarıyla yapılır.