Phase 13: Tools & Protocols

MCP Temellikleri: İttifaksiz İstekler ve JSON-RPC

Type: Learn

Languages: Python

Prerequisites: Phase 13, Lessons 01 through 05

Time: ~55 minutes

Öğrenme Hedefleri

• MCP'nin sunucu primitiflerini istemci tarafı özelliklerinden ayırt edin.
• MCP için geçerli JSON-RPC 2.0 istekleri ve yanıtları oluştur 2026-07-28- Evet .
• Her talebe protokol versiyonu, istemci yetenekleri ve istemci kimliği ekleyin.
• Kullanımserver/discoverve elini tut .UnsupportedProtocolVersionErrorEl sıkışmadan.
• Tam bir sonuçla birlikte bir bağımsız talebi doğrulama ile takip edin.

Sorun

Bir MCP sunucusu, aynı işlem veya HTTP çalışanında farklı özelliklere sahip farklı istemcilerden iki ardıcıl istek alabilir. Eğer sunucu önceki isteklerin açıklandığını hatırlarsa, yanlış izinleri uygulayabilir veya yanlış tel şeklini geri verebilir.

MCP 2026-07-28Bu, protokol çekirdeğinin devletsiz olduğunu gösterir. Bir sunucu, mevcut talebi bağlantı geçmişinden değil, mevcut talebi nasıl ele alacağını belirlemesi gerekir.

Bu zihinsel modelde değişiklikler yapmaktadır. Eski dizide ilk bağlantı, ikinci el sıkışması, üçüncü işlemler vardı.

1. Müşteri kendini tanımlama isteği gönderir.
2. Sunucu bu talebin versiyonunu ve özelliklerini onaylar.
3. Sunucu yöntemle ilgileniyor.
4. Sunucu yazdırılmış bir sonuç veya JSON-RPC hatası gönderir.

Bir sonraki talebinde aynı süreç sıfırdan tekrarlanır.

Anlaşım

Sunucu ilkesi

MCP sunucuları üç temel primitif açıklar:

1. Toolsmodel kontrolü olan eylemler,tools/listVe çağırıldık .tools/call- Evet .
2. ResourcesURI adresli veriler, resources/listve resources/read- Evet .
3. Prompts ile keşfedilen tekrar kullanılabilir şablonlar.prompts/listve prompts/get- Evet .

Kökleri, örnekleme ve ağaç kesimi 2026-07-28uyumluluk için bir schema, ama onlar eski. Yeni uygulamalar kökler için açık bir araç veya kaynak girişlerini, örnekleme için doğrudan model sağlayıcı API'lerini ve kayıt için stderr veya OpenTelemetry'yi kullanmalıdır. Bir sunucu giriş istekini geri gönderir ve istemci orijinal işlemini tekrar yaparken, birçok döngü yolculuğu istekleri aracılığıyla başlatma hala mevcuttur. Modern bir sunucu bağımsız bir JSON-RPC talebini asla başlatmaz.

JSON-RPC zarfları

MCP JSON-RPC 2.0 kullanıyor:

• İstek: {jsonrpc, id, method, params}
• Cevap:{jsonrpc, id, result}veya {jsonrpc, id, error}
• İletişim: {jsonrpc, method, params}Hayır .id

TalepidBir cevapla ilişkili. Protokol seansı oluşturmaz.

Gerekli talep metadataları

Her modern talebin içinde bir _metaİçeride bir nesneparams- ...

jsonCopy{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/list",
  "params": {
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientCapabilities": {},
      "io.modelcontextprotocol/clientInfo": {
        "name": "course-client",
        "version": "1.0.0"
      }
    }
  }
}

Protokol sürümü ve istemci yetenekleri gereklidir. istemci kimliği önerilir. Bu kendi kendini rapor eden görüntüleme ve hata işlemleri verileri, güvenlik kimliği değil.

Sunucu, bu değerlerden herhangi birini daha önceki bir istek, bir stdio süreci, bir HTTP bağlantısı veya tek başına bir nakliye başlığından çıkarmamalıdır.

Tam sonuçlar ve sunucu kimliği

Her başarılı modern sonuç içerir .resultTypeNormal bir son sonuç kullanır."complete". Sunucular da sonuç metadatalarında kendilerini tanımlamalıdır:

jsonCopy{
  "jsonrpc": "2.0",
  "id": 7,
  "result": {
    "resultType": "complete",
    "tools": [],
    "ttlMs": 30000,
    "cacheScope": "public",
    "_meta": {
      "io.modelcontextprotocol/serverInfo": {
        "name": "notes-server",
        "version": "1.0.0"
      }
    }
  }
}

tools/list- Evet .resources/list- Evet .prompts/list- Evet .resources/templates/list- Evet .resources/readveserver/discoverBu sonuçlar, önbelleğe alınan sonuçlardır.ttlMsve cacheScopeGüvenli bir varsayım .ttlMs: 0ve cacheScope: "private"Listede bulunan öğelerin belirleyici bir sırayla olması gerekir, böylece eşdeğer yanıtlar sabit önbelleğe anahtarlar ve sabit model bağlamını oluşturur.

El sıkışmadan keşfet

Her modern sunucu uygulamalıdır .server/discoverMüşteri , diğer bir yöntemden önce bu yöntemi arayabilir:

• supportedVersions
• sunucucapabilities
• seçmeli kullanımı instructions
• Sonuç olarak sunucu kimliği _meta
• Kayıtlı ipuçları

Bulma yararlı, ama bir kapı değil.tools/listÖncelikle, bu talebin protokol versiyonu ve özellikleri zaten var.

İstediğiniz sürüm desteklenmiyorsa, sunucu JSON-RPC kodu gönderir -32022ile:

jsonCopy{
  "requested": "2027-01-01",
  "supported": ["2026-07-28"]
}

Müşteri karşılıklı desteklenen modern bir sürümü seçer ve yeni bir JSON-RPC istek kimliği ile tekrar dener.

Tek talep yaşam döngüsü

Modern bir talebi bu sırada izleyin:

1. Birinci JSON-RPC zarfını inceleyin.
2. - Evet .jsonrpc- Evet ."2.0", bir idvar.methodbir ip ve paramsbir nesne.
3. Versiyon dizilisi ve kapasite nesnesini params._meta; yanlış biçimlendirilmiş veya eksik olan metadata -32602- Evet .
4. HTTP sınırında, versiyonu, yöntemi ve geçerli isim başlıklarını vücut ile karşılaştırın.-32020İki versiyon değerinden biri desteklenmemiş olsa bile.
5. Dürüstlük belirledikten sonra, eşleşen ama desteklenmeyen bir versiyonu reddedin.-32022- Evet .
6. Gerekli kapasiteleri kontrol edin ve sonra yolculuk edin.methodve yöntem-özel argümanları onaylamak.
7. İşlemini yürütmeden önce beton işlemini doğrulayın ve onaylayın.
8. Server kimliği ile tam bir sonuç iade edin.
9. İstek ölçülü protokol metadatalarını unut.

Bu emir iki bileşenin farklı çağrıları yorumlamasını engeller.Mcp-Name: notes.readKaynaklar yerine getirilirkenparams.name: notes.deleteAyrıca yanlış biçimlendirilmiş giriş, başlık karışıklığı, sürüm müzakere, yetenek başarısızlığı, yetki ve işleme başarısızlığı da belirgin kanıtlar olarak saklanır.

Stdin veya HTTP cevabını kapatmak, nakliye etkinliğini sona erdirir.

Açıkça miras verenlik

Versiyonlar 2025-11-25kullanımıinitialize- Evet .notifications/initializedBu davranış, iki çağdaki bir istemci eski bir sunucuyla konuşurken hâlâ geçerlidir.

Zamanları ayrı tutun. Modern bir istek, istek başına gerekli metadata ile tanımlanır. Eski bir bağlantı yalnızca belgelemiş geri dönüş yolu yoluyla seçilir. Gönderme initializebir için default olarak2026-07-28- Sunucu.

Stateless bu nedenle çağ-sözlü bir anlam taşır.2026-07-28Bu, protokol değişmezliği içeren bir süreçtir. Her sıradan talebin bağımsız olarak yorumlanabilmesi ve MCP oturumunun bulunmaması gerekir.2025-11-25Bu nedenle, uyumluluk adaptörü eski bağlantı durumunu koruyabilir. İki çağ uygulaması bir izin veren durum makinesi değildir.

Bu iki anlam da kalıcı bir uygulama durumunu yasaklamaz. Bir iş akışı, görev veya taslak ortak bir mağazada açık olmayan bir eldivenin arkasında yaşayabilir. Müşteri bu eldivenini sıradan giriş olarak gönderir ve her kopya kullanımını doğruluyor ve yetkilendiriyor. Protokol bağlamı kaldırılan oturumun yerine bu mağazaya sızmamalıdır.

Kullan

code/main.pyModern MCP mesajlarını çerçeve olmadan oluşturur, onaylar, izler ve gönderir.

bashCopypython3 code/main.py
python3 -m unittest discover code/tests -v

Çıktıran üç değişken için dikkat edin:

• Her talep tekrarlanır ._metaAlanlar.
• Her başarılı sonuçresultType: "complete"ve sunucu kimliğini içerir.
• Listenin sonucu belirleyici bir şekilde düzenlenmiş ve açık bir önbelleğe işaretler sunmaktadır.

Gönder

Bu ders gemileri outputs/skill-mcp-handshake-tracer.mdTarihi dosya adı sabit kalır, ancak eser artık bir devletsiz istek izleyicisi. Her mesajı bağımsız olarak denetler ve sadece gerçekte var olduğunda eski el sıkışması trafiğini etiketler.

Egzersizler

1. Bir istek protokol versiyonunu olarak değiştirin.2027-01-01Hata kodunun doğru olduğunu onaylayın .-32022ve veriler desteklenen versiyonu reklam eder.
2. Çıkar io.modelcontextprotocol/clientCapabilitiesSunucu ilk istekten gelen özellikleri tekrar kullanmıyor.
3. Hatırlatma araçları kayıtlarını tersine çevirin.tools/listYine de aynı belirleyici sırayı geri verir.
4. DeğişiklikcacheScope-public- ...private. Her durumda yanıtın hangi yetki bağlamlarında tekrar kullanılabileceğini açıklayın.
5. Seçeneği ekle clientInfoİstek geçerli kalmalıdır çünkü müşteri kimliği gerekmez, tavsiye edilir.

Anahtar Terimler

Daha Fazla Okumak

• MCP Architecture
• MCP Base Protocol
• MCP Server Discovery
• MCP 2026-07-28 Changelog

This free lesson is part of the AI Engineering from Scratch curriculum. Read the full explanation, run the lesson code, and verify the result in the interactive reader or from the repository source.

Browse the complete course catalog or open this lesson on GitHub.