Kullanım dışı özellikler

2026-07-28 spesifikasyonu beş şeyi emekliye ayırıyor. SDK hâlâ hepsini uygular ve artık her biri bir kullanım dışı bırakma uyarısı taşır. Bir SDK yardımcısı ise kendi gerekçesiyle kullanım dışı bırakıldı ve sayfanın sonunda listeleniyor.

Aşağıdaki tablo kullanım dışı bırakılan her özelliği, neden gittiğini ve yerine neyin üzerine inşa etmeniz gerektiğini gösterir.

Neler kullanım dışı

Bu tablodan üç şey çıkar:

• Kök dizinler, örnekleme ve log tutma bir arada gider. Tek bir öneri, SEP-2577, üç yeteneği birden kullanım dışı bırakır.
• Örnekleme ve kök dizinler daha derin bir sorunu paylaşır: bunlar bir sunucunun istemciye istek gönderdiği yerlerdir. 2026-07-28 sürümünün Çok turlu istekler ile değiştirdiği şey tam da bu yöndür. Giden, bağımsız RPC yöntemleridir (sampling/createMessage, roots/list ve push tarzı elicitation/create); CreateMessageRequest / ListRootsRequest / ElicitRequest yük türleri InputRequiredResult.input_requests içine gömülü olarak yaşamaya devam eder ve istemcide aynı callback'lere ulaşır.
• ping diğerlerinden ayrılır. Protokol onu kullanım dışı bırakmaz, kaldırır. SDK yöntemi yine de uyarır (mesajı deprecated değil removed der) ve modern bir bağlantıda çağrıldığında "Method not found" yanıtı gelir.

Kullanım dışı bırakma tavsiye niteliğindedir

Bugün hiçbir şey bozulmaz.

Yukarıdaki her yöntem, 2025-11-25 veya daha eski bir sürümle anlaşmış her oturumda çalışmaya devam eder. İstemcide mode="legacy" sabitleyin, 2026 öncesi davranışın aynısını elde edersiniz. İletilen veride hiçbir değişiklik yoktur ve yetenek anlaşması aynıdır.

Değişen şey, her biri ilk kez çalıştığında görünür bir uyarı almanızdır:

MCPDeprecationWarning: The logging capability is deprecated as of 2026-07-28 (SEP-2577).

MCPDeprecationWarning, DeprecationWarning'in değil, UserWarning'in alt sınıfıdır. Bu kasıtlıdır: Python'ın varsayılan filtresi DeprecationWarning'i yalnızca doğrudan __main__ olarak çalıştırılan kodda gösterir; kütüphaneler bir şeyleri böyle kullanım dışı bırakır ve iki yıl boyunca kimse fark etmez. Bu uyarı ise her yerde, -W bayrağı olmadan görünür.

Cannot send 'sampling/createMessage': this transport context has no back-channel
for server-initiated requests.

Eski nesil oturumda ping

Ping, iki taraftan herhangi birinin karşı tarafın hâlâ yanıt verip vermediğini kontrol etmek için gönderebildiği boş bir istektir. 2026-07-28 spesifikasyonu onu kaldırır (SEP-2575): modern bir istemcinin gönderdiği her istek sunucunun orada olduğunu zaten kanıtlar, modern bir sunucunun ise ping gönderecek bir kanalı yoktur. Her iki SDK yöntemi de el sıkışma neslinden bir oturumda hâlâ çalışır. İstemciden:

async def main() -> None:
    async with Client("http://localhost:8000/mcp", mode="legacy") as client:
        await client.send_ping()  # warns; returns an EmptyResult

Sunucudan ise herhangi bir işleyicinin içinde:

@mcp.tool()
async def check_client(ctx: Context) -> str:
    """A tool that still pings the client mid-call."""
    await ctx.session.send_ping()  # no warning; an EmptyResult while the client is connected
    return "client answered"

• client.send_ping() her çağrıda MCPDeprecationWarning ile uyarır. Varsayılan (2026-07-28) bağlantıda sunucu bunun yerine MCPError: Method not found yanıtını verir.
• ctx.session.send_ping() uyarı taşımaz. Modern bir bağlantıda, sunucunun başlattığı diğer tüm istekler gibi aynı geri kanal yok (back-channel) hatasını fırlatır.
• İki taraf da ping'e yanıt vermek için herhangi bir şey kaydetmez.

Kök dizin değişikliği bildirimleri

Kök dizinler yeteneğini bildirmiş 2025 neslinden bir istemci, çalışma alanı klasörlerinin değiştiğini sunucuya notifications/roots/list_changed göndererek söyleyebilir; sunucu da karşılık olarak roots/list'i yeniden ister. 2026-07-28 spesifikasyonu bu bildirimi, push tarzı kök dizin akışının geri kalanıyla birlikte kaldırır. İstemcide "roots": {"listChanged": true} bildirimini yapan şey list_roots_callback= geçirmektir (İstemci callback'leri) ve tek bir çağrı bu sözü tutar:

async def open_folder(client: Client, uri: str, name: str) -> None:
    """The user opened another folder: expose it through the roots callback, then tell the server."""
    workspace.append(Root(uri=FileUrl(uri), name=name))
    await client.send_roots_list_changed()

Sunucuda alıcı işleyiciyi düşük seviyeli Server alır:

async def roots_changed(ctx: ServerRequestContext, params: NotificationParams | None) -> None:
    """The client's roots changed: ask for the new list."""
    roots = (await ctx.session.list_roots()).roots


server = Server("Bookshop", on_roots_list_changed=roots_changed)

• workspace, list_roots_callback'inizin döndürdüğü listedir. client.send_roots_list_changed() uyarır ve mode="legacy" bir istemci gerektirir: modern bir bağlantıda bildirim sessizce düşürülür. Ardından oturumu açık tutun, çünkü sunucunun takip eden roots/list isteği o oturum üzerinden gelir.
• MCPServer'da bu bildirim için bir kanca yoktur. Düşük seviyeli Server'da işleyiciyi on_roots_list_changed= kaydeder (o da kullanım dışıdır ve oluşturma sırasında uyarır). Bildirim yük taşımaz, bu yüzden işleyici yeni liste için ctx.session.list_roots()'u çağırır.

Uyarıyı susturma

Yeni kodda susturmayın.

Ancak bakımını yaptığınız ve gerçekten 2026 öncesi istemcilere hizmet veren bir sunucunun sessiz bir log'a sonuna kadar hakkı vardır. Kategoriyi, ilk kullanım dışı çağrı çalışmadan önce filtreleyin:

import warnings

from mcp import MCPDeprecationWarning

warnings.filterwarnings("ignore", category=MCPDeprecationWarning)

API'nin tamamı bu. Yöntem başına bir anahtar yok, zaten istemezsiniz de: tek kategori olmasının anlamı, tek satırın onu susturması ve tek satırın geri getirmesidir.

mcp.shared.exceptions.MCPDeprecationWarning: The logging capability is deprecated as of 2026-07-28 (SEP-2577).

Kullanım dışı SDK yardımcıları

Bunlar spesifikasyon değişikliği değil, yalnızca daha iyi bir alternatifi olan SDK iç ayrıntılarıdır. Aynı MCPDeprecationWarning ile uyarırlar ve 3.0'da kaldırılacaklar.

Özet

• 2026-07-28 spesifikasyonu kök dizinleri, sunucunun başlattığı örneklemeyi ve protokol üzerinden log tutmayı kullanım dışı bırakır (hepsi SEP-2577), ilerlemeyi sunucudan istemciye yönle sınırlar ve ping'i kaldırır.
• Yerine geçenler sütunu sizi ileriye yönlendirir: örnekleme ve kök dizinler için Çok turlu istekler, log tutma için Log tutma, ilerleme için İlerleme. ping için hiçbir şey gerekmez.
• Kullanım dışı bırakma tavsiye niteliğindedir: iletilen veride değişiklik yok, her şey 2026 öncesi oturumlarda çalışmaya devam eder ve görünür bir MCPDeprecationWarning alırsınız (bir UserWarning, dolayısıyla varsayılan olarak açık).
• Örnekleme ve kök dizinler ayrıca, 2026-07-28 oturumunda bulunmayan bir geri kanala ihtiyaç duyar. Modern bir bağlantıda önce uyarır, sonra istisna fırlatırlar.
• warnings.filterwarnings("ignore", category=MCPDeprecationWarning) tüm kategoriyi susturur; pytest'te "error::mcp.MCPDeprecationWarning" bunu bir test hatasına dönüştürür.
• Bir SDK yardımcısı, FuncMetadata.call_fn_with_arg_validation(), 3.0'da kaldırılmak üzere ayrıca kullanım dışı bırakıldı.
• Yeni kod bunların hiçbiri üzerine kurulmamalıdır.

Bu belgelerdeki diğer tüm sayfalar güncel API'yi anlatır.