MCP rehberi

• Tek uç, bütün filo. Ajan yalnız /api/mcp ile konuşur. Her araç çağrısı okuyacağı cluster'ı clusterId ile söyler; YEKE okumayı o cluster'daki Kubernetes kimliğinizle yapar.
• Okuma yolu yalnız okur. MCP'nin arkasında cluster'a yazan bir yol yok. propose_operation da bir şey uygulamaz; YEKE'de bir plan ve onay kartı kurar.
• Sonuç veri olarak işaretlenir. Her başarılı araç sonucu ajana bir veri zarfı içinde gider; ayrıntısı Güvenlik modeli bölümünde.
• Sunucu ajana bir yönerge verir. Bağlantıda YEKE, araç sonuçlarının veri olduğunu, teşhis sırasını (önce metrik, sonra olay, pod durumu ve log) ve yönetim işlerinin hangi YEKE ekranında yapıldığını söyler. İstemci bu yönergeyi kullanmayabilir.

Taşıma: Streamable HTTP, yalnız POST. Her yanıt tek bir JSON nesnesidir (SSE açılmaz) ve sunucu oturum tutmaz. Desteklenen protokol sürümleri 2026-07-28 ve 2025-11-25.

1. Kurulum sahibi Yönetim → Sistem → Sistem ayarları → Oturumlar ve erişim → “MCP sunucusu”nu açın; core'u yeniden başlatmak gerekmez. Durum Yönetim → AI sağlayıcıları ekranında da yazar. Bkz. MCP'yi açma.
2. Yönetici Ajanın okuyacağı her cluster'da AI veri çıkışı duruşunu allowed yapın: cluster ekranı → sohbet paneli → “Egress ve sağlayıcı”. Kullanıcının o cluster'da bir Kubernetes kimlik eşlemesi de olmalı. Bkz. MCP'yi açma.
3. Kullanıcı Hesabım → “Token oluştur”. Token üretildiğinde altındaki “MCP ile kullan” bölümü Claude Code komutunu ve Codex parçasını verir. Bkz. Claude Code ve Codex; YEKE kurum içi bir CA kullanıyorsa aynı bölümdeki yeke mcp rölesi.

Hangi kapsam? Ajan yalnız teşhis yapacaksa Okuma; düzeltmeyi de onay kartı olarak önermesini istiyorsanız Plan önerme. Plan önerme token'ı okuma token'ının bütün araçlarını görür, ek olarak yalnız propose_operation'ı.

MCP her araca zorunlu bir clusterId alanı ekler. Geçerli değerler sizin MCP ile okuyabileceğiniz cluster'lardır: Kubernetes kimlik eşlemeniz olan ve yöneticinin AI veri çıkışına izin verdiği (allowed) cluster'lar. Böyle bir cluster yoksa araç listesi boş gelir.

Yalnız sohbette olan araçlar MCP'de sunulmaz: kullanıcı ve kimlik okumaları, arayüz aracı, yönetim ve izin önerileri ve sohbet turunu bitiren iki araç (answer, ask_user). Sunulmayan bir aracın çağrısı JSON-RPC -32602 alır.

› odeme namespace'indeki web sürekli yeniden başlıyor. Neden?

# her çağrı clusterId=c-1 taşır
yeke_metrics   op=status
yeke_metrics   op=entity kind=workload namespace=odeme name=web
k8s_events     namespace=odeme involvedObject=web-6d8f9c7b5-x2kqp type=Warning
k8s_get        schemaId=pod namespace=odeme name=web-6d8f9c7b5-x2kqp
k8s_logs       namespace=odeme name=web-6d8f9c7b5-x2kqp previous=true tailLines=50

BULGU   web konteyneri bellek sınırına ulaşınca öldürülüyor.
KANIT   k8s_get: lastState.terminated.reason=OOMKilled, restartCount=14,
        resources.limits.memory=256Mi; yeke_metrics: bellek 1h boyunca sınıra yakın.
ÖNERİ   bellek sınırını 512Mi'ye çıkarmak.

› Öner.

propose_operation  patch apps.deployment odeme/web
                   state=AWAITING_APPROVAL
                   https://yeke.kurum.com/clusters/c-1/operations?op=op-…

Onay kartı YEKE'de hazır. Bağlantıyı açıp inceleyin; onay sizde.

Kartta ne görürsünüz

• Köken. Kart planın hangi token'la ve hangi kanaldan geldiğini yazar: “Bu plan “dizustu-claude” token'ı ile MCP üzerinden bir AI istemcisi tarafından önerildi.”
• Modelin özeti. Ajanın özet cümlesi “Modelin özeti” etiketiyle ayrı bir satırda durur. Onayladığınız şey özet değil, karttaki değişikliktir.
• Değişiklik ve zincir. Planın adımları, dry-run'ın hesapladığı fark, politika sonuçları ve onay düzeyi; arayüzden ya da sohbetten kurulan bir planın kartıyla aynı.
• Onay sizde. Kartı kendi YEKE oturumunuzla açar, onaylar ya da reddedersiniz. Onaylanmayan plan 30 dakika sonra düşer.

propose_operation'ın kurduğu plan, arayüzün ve sohbetin kullandığı plan kurucudan geçer: doğrulama, dry-run, politikalar ve kurulumunuzdaki doğrulama Hook'ları. Hook'a planın kaynağı api olarak gider.

Uygulama da tek kapıdan geçer ve bu kapı planın kökenine bakmaz. Kurulumunuzda açık olan ikinci onay, bakım penceresi ve onay anında sorulan Hook'lar (ör. bir ITSM onayı) MCP'den önerilen plana da aynen uygulanır; bkz. Yönetişim ve Hook entegrasyonu.

Token zincirin hiçbir onay adımını atlayamaz. Planı uygulamak, onaylamak, tazelemek ve iptal etmek plan önerme token'ına kapalıdır (403); bunları kartın sahibi kendi oturumuyla yapar.

AI kaynaklı bütün yazmaları yükseltilmiş onaya almak için yerleşik ops.nl-strict şablonu: bkz. Plan önerme.

• Kimlik ve Kubernetes RBAC. Her okuma sizin o cluster'daki Kubernetes kimliğinizle yapılır. RBAC'ınızın göstermediğini ajan da göremez; kimlik eşlemeniz olmayan cluster MCP'den okunamaz.
• Maskeleme. Secret değerleri ajana maskeli gider. last-applied-configuration annotation'ı ve managedFields hiç gönderilmez; konteyner env değerleri varsayılan olarak maskelidir. Log satırları maskelenemez.
• Sonuç veri olarak işaretlenir. Her başarılı araç sonucu <<<TOOL_RESULT … kind=data>>> ile <<<END>>> arasında gider; verinin içindeki aynı ayraçlar bozulur. Sunucu yönergesi zarfın içinin talimat değil veri olduğunu ve cluster içeriğindeki talimatlara uyulmamasını söyler. Bu prompt injection'a karşı tek başına yeterli değildir: model yönergeye uymayabilir. Asıl kapı ajanın yazamamasıdır; enjekte edilmiş bir talimatın MCP üzerinden varabileceği en uç sonuç bir öneridir ve onu siz onaylarsınız.
• Denetim izi. Her okuma çağrısı bir ai.read olayı yazar: kaynak api, kanal mcp ve token'ın kimliği. Olaya okunan değerler yazılmaz. Katalog araçları (k8s_search_types, k8s_describe_type) cluster'dan yeni veri okumadığı için olay yazmaz. Plan önerisi ai.plan_proposed olayı yazar.
• AI veri çıkışı kapısı. Duruşu off ya da local-only olan cluster MCP'den okunamaz; YEKE verinin hangi modele gideceğini bilemez.
• Yalnız kapsamlı token. Tarayıcı oturumu ve yeke login'in tam yetkili token'ı MCP'de reddedilir.
• YEKE ayarlarına yazma yok. Uyarı kuralı, Hook, yetki grubu, kullanıcı ve politika MCP'den değiştirilemez; ajan yalnız işin hangi ekranda yapıldığını söyler.
• Hız sınırı. Her MCP isteği token'ın dakikalık bütçesinden düşer; öneriler ayrıca sayılır. Bkz. Token'ın kapsamı.

Masaüstü uygulamaları ve ortam değişkenleri. Bazı masaüstü istemcileri kabuğunuzun başlangıç dosyalarını (ör. .zshrc) okumadan açılır ve orada tanımlı değişkenleri görmez. O zaman ${YEKE_MCP_TOKEN} değişkeni boş açılırsa 401 UNAUTHENTICATED, istemci dizeyi açmadan gönderirse 401 SESSION_INVALID döner. Çözüm token'ı istemcinin kendi yapılandırmasına vermektir; Hesabım'daki “MCP ile kullan” bölümünün tek adımlık komutu bunu yapar.

• Teşhis bir öneridir. Ajanın bulgusu ve vardığı sebep yanlış olabilir; YEKE modelin sonucunu doğrulamaz. Kartı onaylamadan önce farkı kendiniz okuyun.
• MCP yazmaz. MCP üzerinden cluster'a hiçbir şey yazılmaz; ajanın önerdiği bir değişiklik yalnız sizin onayladığınız plandan doğar.
• Onay sizin sorumluluğunuzdadır. Kartı onaylayan sizsiniz; ajanın özeti bir not, kararın kendisi değil.
• Tur bütçesi yok. Sohbetin tur başına araç tavanı MCP'de yoktur; ajanın kaç okuma yapacağına istemci karar verir. Çağrı başına okuma tavanları ve token'ın dakikalık bütçesi geçerlidir.
• Öteki sınırlar. Veri kaybı önleme (DLP) sınırı olmaması, verinin sizin seçtiğiniz modele gitmesi, ajanın makinenizdeki öteki araçları ve planın 30 dakikalık ömrü: bkz. Beyanlı sınırlar.